loginwindow man page on OPENSTEP

Man page or keyword search:  
man Server   1419 pages
apropos Keyword Search (all sections)
Output format
OPENSTEP logo
[printable version]


LOGINWINDOW(8)							LOGINWINDOW(8)

NAME
       loginwindow - allow user to log in on console

SYNOPSIS
       /usr/bin/loginwindow  [ -LoginHook progname ]  [ -LogoutHook progname ]
       [ -HostName hostname ]			       [ -ImageFile filename ]
       [ -DefaultUser username ] [ -PowerOffDisabled true ]

DESCRIPTION
       loginwindow  is the login front end for the console of the NEXTSTEP(tm)
       environment.  It's usally run as the program on the  console  tty  from
       the /etc/ttys file.

       loginwindow  allows  the	 user  to  enter  his login name and password,
       verifies those against  the  user/password  database,  and  starts  the
       Workspace Manager ( /usr/lib/NextStep/Workspace.app) as that user.

       If  there  is  an  account  for	the  user me (or the user named by the
       DefaultUser option) and that account has no password, then  loginwindow
       does  not  actually  go	through	 the  login  procedure; it immediately
       executes the Workspace for that user.  This can be disabled by  holding
       down the left mouse button while loginwindow is starting.

       If  the	user  has  an  entry  for  loginwindow	named Workspace in his
       defaults database  the  named  program  will  be	 executed  instead  of
       Workspace  Manager.   The workspace program is invoked with the command
       line

	      program -LoginProgram YES

       If the user name of exit is given, loginwindow immediately  exits  with
       status  0  and restarts the Window Server.  If the user name of console
       is given, loginwindow immediately exits with status  1  and  opens  the
       UNIX  Console window.  This may be used in conjunction with the onerror
       feature of the ttys file.

       Before  starting	 the  Workspace	 Manager,   loginwindow	  clears   the
       Pasteboard,  and	 reads	the following user parameters (set by the user
       with the Preferences application) from the user's defaults database and
       places them in effect:

	    MouseScaling
	    InitialKeyRepeat
	    KeyRepeat
	    ClickTime
	    ClickSpace
	    AutoDimTime
	    MouseHandedness
	    MouseButtonsTied
	    Keymap (or SwappedKeymap)
	    Volume
	    Mute
	    Brightness

       It  also	 looks up the following two user parameters and places them in
       effect for the duration of the user's login session:

	    PublicWindowServer
	    umask

       PublicWindowServer  is  a  parameter  indicating	 whether  unrestricted
       access to the Window Server on this machine should be allowed while the
       user is logged in.  If it is YES, then any client on  any  machine  may
       connect to the window server.  Otherwise, only processes descended from
       the Workspace or special system processes such as  the  printer	daemon
       will  be	 allowed  to  connect.	 umask gives an integer indicating the
       user's desired default umask.  See umask(2) for more information.

       After the user has logged out, loginwindow clears  the  Pasteboard  and
       resets the parameters listed above to their default values.

OPTIONS
       Note:  Like  other  NEXTSTEP(tm)	 applications,	loginwindow may accept
       these options on the  command  line  or	as  entries  in	 the  defaults
       database	 of  the  user	running the program, (which for loginwindow is
       usually root).

       -LoginHook progname
	      provides a program for loginwindow to  call  before  allowing  a
	      user  to	log  in.   This	 program, if specified, will be called
	      after the user's name and password have been verified aginst the
	      passwd  database.	 The intention of this hook is to allow system
	      administrators  to  do  logging  of  the	user   and   necessary
	      bookkeeping with the Unix databases such as wtmp if desired.  By
	      default, loginwindow does handle the utmp database, but not  the
	      other  activities	 performed  by	the  terminal  oriented	 login
	      program (for  example,  maintaining  the	wtmp  database).   The
	      program  is  called  with its first argument as the user name of
	      the person logging in.  If the hook program  exits  with	return
	      code  0, the user will be logged in; otherwise the login will be
	      prevented.  The LoginHook program should be specified as a  full
	      pathname.	  Also, it is not called when the default user (me) is
	      logged in without being asked for a password.

       -LogoutHook progname
	      provides a program for loginwindow to  call  after  a  user  has
	      logged  out.   The  program is invoked with the name of the user
	      who just logged out as its first argument.  Like the  LoginHook,
	      the  program should be given by its full pathname, and it is not
	      called when the single-user account  (default  'me')  is	logged
	      out.

       -HostName hostname
	      provides	a  host name to be displayed in the window.  If such a
	      name is provided, it is drawn towards the upper-right region  of
	      the  window.   If	 the host name provided is localhost, then the
	      hostname the machine was configured  with	 at  startup  time  is
	      used.

       -ImageFile filename
	      provides	an  alternate  file  to	 use  as the background of the
	      window  used  by	loginwindow.   Normally,  it  loads  the  file
	      /usr/lib/NextStep/loginwindow.app/LoginPanel.tiff	 and  displays
	      that as the background for loginwindow.  The  file  used	should
	      contain  an  image  462  pixels  wide by 260 pixels high.	 White
	      rectangles for the user name  and	 password  will	 be  drawn  by
	      loginwindow  at  coordinates (124, 102) and (123, 136), with the
	      text “Name:” and “Password:” before each (these may appear in  a
	      language	other  than  English).	Both rectangles are 310 pixels
	      wide and 22 pixels high.	Subject	 to  these  restrictions,  the
	      image  may  contain  whatever  is desired.  Note that though the
	      image will be centered on the screen if it is  larger  than  the
	      default  size,  the  name	 and  password	fields are still drawn
	      relative to the bottom left of the image itself.

       -DefaultUser username
	      provides for designating any particular username as the name  to
	      use when checking for single-user status (see the description of
	      the treatment of the me  account	above).	  If  the  DefaultUser
	      option  is  given,  then that user name, rather than me, will be
	      checked, and if it has no password, it will be logged in.

       -PowerOffDisabled true
	      allows the System Administrator to prevent users	from  casually
	      powering	down  the  system.   If	 this option is supplied, then
	      pressing the power  key  while  loginwindow  is  active  has  no
	      affect.	Additionally,  if the user presses the power key while
	      in the Workspace Manager, then Workspace Manager will  exit  but
	      the  system  will not be powered down.  This may be used to make
	      it less likely for users to casually power down a system that is
	      providing some shared service, for example, a print server.

       If  this is done, system administrators may wish to allow the system to
       be powered down under password control.	A quick way to do this	is  to
       create a user named power, assign a suitable password to that user, and
       set that user's Workspace default for loginwindow to  be	 /etc/fasthalt
       -p.

FILES
       /etc/utmp			user/terminal database
       /etc/ttys			terminal configuration file
       /etc/halt			program used to shut down system
       ~/.NeXT/.NeXTdefaults.D		files for user's defaults
       ~/.NeXT/.NeXTdefaults.L
       /usr/lib/NextStep/Workspace.app	Default location of Workspace
       /usr/lib/NextStep/nextlogin.tiff Default image file

SEE ALSO
       utmp(5), login(8), ttys(5), passwd(5)
       NEXTSTEP Network and System Administration manual

BUGS
       utmp handling should be in the LoginHook program.

4th Berkeley Distribution      January 12, 1989			LOGINWINDOW(8)
[top]
                             _         _         _ 
                            | |       | |       | |     
                            | |       | |       | |     
                         __ | | __ __ | | __ __ | | __  
                         \ \| |/ / \ \| |/ / \ \| |/ /  
                          \ \ / /   \ \ / /   \ \ / /   
                           \   /     \   /     \   /    
                            \_/       \_/       \_/ 
More information is available in HTML format for server OPENSTEP

List of man pages available for OPENSTEP

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net