1 03/07/87  enter, e, enterp, ep
  2 
  3 Syntax:  e {anonymous_name} Project_id {-control_args}
  4     or:  ep {anonymous_name} Project_id {-control_args}
  5 
  6 
  7 Function: used by anonymous users to gain access to Multics.  Either
  8 one is actually a request to the answering service to create a process
  9 for the anonymous user.  Anonymous users who are not to supply a
 10 password use the enter (e) request.  Anonymous users who are to supply
 11 a password use the enterp (ep) request.  (See "Notes on passwords"
 12 below.)
 13 
 14 
 15 Control arguments:
 16 -arguments STR, -ag STR
 17    supplies arguments to the process.  STR can be one or more
 18    arguments.  All arguments following -ag on the command line are
 19    taken as arguments to the process.  Therefore -ag, if present, must
 20    be the last control argument to the enter request.  The process can
 21    determine the number and value of each argument with the login_args
 22    active function.
 23 -brief, -bf
 24    suppresses messages associated with a successful login.  If the
 25    standard process overseer is being used, the message of the day is
 26    not printed.
 27 
 28 
 29 -force
 30    logs the user in if at all possible, provided the user has the
 31    guaranteed login attribute.  Only system users who perform emergency
 32    repair functions have the necessary attribute.
 33 -home_dir path, -hd path
 34    sets the user's home directory to the path specified, if the user's
 35    project administrator allows that user specify a home directory.
 36 -long, -lg
 37    prints messages associated with a successful login.  If the
 38    standard process overseer is being used, the message of the day is
 39    not printed.
 40 
 41 
 42 -modes STR, -mode STR, -md STR
 43    sets the I/O modes associated with the user's terminal to STR, where
 44    the string STR consists of modes acceptable to the tty_ I/O module.
 45    (See the tty_ I/O module description in the Subroutines manual for a
 46    complete explanation of possible modes.)  The STR string is usually
 47    a list of modes separated by commas; the STR string must not contain
 48    blanks.
 49 -no_preempt, -np
 50    refuses to log the user in if login can be achieved only by
 51    preempting some other user in the load control group.
 52 -no_print_off, -npf
 53    tells the system that the terminal cannot stop printing while a
 54    password is being entered.  The system prints a mask field to
 55    overwrite the area in which the password will be typed.
 56 
 57 
 58 -no_start_up, -ns
 59    instructs the standard process overseer not to execute the user's
 60    start_up.ec segment, if one exists, and if the project administrator
 61    allows the user to avoid it.
 62 -no_warning, -nw
 63    suppresses even urgent system warning and emergency messages from
 64    the operator, both at login and during the user's session.  Use of
 65    this argument is recommended only for users who are using a remote
 66    computer to simulate a terminal, or are typing out long memoranda,
 67    when the process output should not be interrupted by even the most
 68    serious messages.
 69 -outer_module p, -om p
 70    attaches the user's terminal via the outer module named p rather
 71    than the user's registered outer module, if the user has the
 72    privilege of specifying an outer module.
 73 
 74 
 75 -print_off, -pf
 76    tells the system that the terminal can stop printing while a
 77    password is being entered.  No password mask is printed.
 78 -process_overseer path, -po path
 79    sets the user's process overseer to the procedure given by the path
 80    specified, if the user's project administrator allows that user to
 81    specify a process overseer.  If path ends in the characters
 82    ",direct", the specified procedure is called directly during process
 83    initialization rather than by the init_admin procedure provided by
 84    the system.  This means that the program specified by path must
 85    perform the tasks that would have been performed by the init_admin
 86    procedure.
 87 
 88 
 89 -ring N, -rg N
 90    sets the user's initial ring to be ring N, if this ring number is
 91    greater than or equal to the user's registered initial ring and less
 92    than the user's registered maximum ring.
 93 -subsystem path, -ss path
 94    creates the user's process using the prelinked subsystem in the
 95    directory specified by path.  The permission to specify a process
 96    overseer, which can be given by the user's project administrator,
 97    also governs the use of the -subsystem argument.  To override a
 98    default subsystem by the project administrator, type -ss "".
 99 -terminal_id STR, -tid STR
100    sets the user's terminal identification to STR, where STR may be
101    from 1 to 4 characters long.  (By default, the terminal ID is
102    obtained from the terminal answerback string.)
103 
104 
105 -terminal_type STR, -ttp STR
106    sets the user's terminal type to STR, where STR is any terminal type
107    name defined in the standard terminal type table.  (To obtain a list
108    of terminal types, refer to the print_terminal_types command.)  This
109    control argument overrides the default terminal type.
110 -warning
111    causes urgent system warning and emergency messages from the
112    operator to be printed on the user terminal, both at login and
113    during the user's session.
114 
115 
116 Notes: If the project administrator does not allow the user to specify
117 the -subsystem, -outer_module, -home_dir, -process_overseer, or -ring
118 control arguments or if the administrator does allow one or more of
119 these control arguments and they are incorrectly specified by the user,
120 a message is printed and the login is refused.
121 
122 
123 Notes on passwords: The password is a string of one to eight
124 characters.  The characters can be any printing character from the
125 ASCII character set except space and semi-colon.  The backspace
126 character is also allowed and is counted as a character.  The password
127 used for interactive logins cannot be "quit", "help", "HELP", or "?",
128 because these have special meaning to the password processor.  Typing a
129 password of "quit" terminates the login attempt.  A response of "help",
130 "HELP", or "?"  produces an explanatory message, and the request for
131 the password is repeated.