LOGIN_SH(8)                          BSD                           LOGIN_SH(8)



NAME
     login_sh - start a log-in shell

SYNOPSIS
     /sys/dm/login_sh

DESCRIPTION
     The login_sh command is included in your Display Manager (DM) log-in
     start-up script to create a shell when you log in.

     When you log in to the DM, it:

     ⊕  Checks the /etc/passwd file (the registry) to determine your HOME
        directory and preferred SHELL.

     ⊕  Looks for your system type by reading the .systype file in  your home
        directory.  If you don't have a .systype file, login_sh reads the file
        /etc/environ and uses the systype listed in that file.  Valid systypes
        are bsd4.3, sys5.3, and aegis.

     ⊕  Prints the "message of the day" from the /etc/motd file and checks for
        UNIX mail if your login shell is csh or sh (/etc/profile prints the
        message of the day for ksh).

     ⊕  Executes the specified shell as a log-in shell. If the Bourne or the
        Korn shells ( /bin/sh or /bin/ksh) are run as log-in shells, they
        execute /etc/profile and ~/.profile.  The C shell (/bin/csh) executes
        the ~/.login file.

     If /etc/passwd doesn't specify a shell, login_sh runs sh.

NOTES
     login_sh is intended to replace the start_sh and start_csh commands. To
     avoid executing the log-in scripts /etc/profile,  .profile,  or .login
     more than once, you should create only one log-in shell.

     The /etc/environ file establishes the default environment and default
     systype for the node.  The /etc/environ file can contain two lines,
     specifying the ENVIRONMENT value, and the SYSTYPE values. Valid
     ENVIRONMENT values are:  aegis, bsd, or sysv.  Valid SYSTYPE values are:
     aegis, bsd4.3, or sys5.3.  If the ENVIRONMENT is set to aegis, you can
     add a line specifying either bsd4.3 or sys5.3.  For example, if the file
     contains the following lines, login_sh executes an Aegis shell (unless
     another shell is specified in the registry) and sets the systype to
     sys5.3.

     ENVIRONMENT = aegis
     SYSTYPE = sys5.3

FILES
     /bin/csh
     /bin/ksh
     /bin/sh
     /etc/motd
     /etc/profile
     /etc/environ
     ~/.systype

SEE ALSO
     environment(1), csh(1), sh(1), ksh(1)