1.0;login, revision 1.0, 83/04/15
LOGIN -- Log in to a running process.
usage: LOGIN [person[.project[.org]] [-LP passwd]] [-C prog_to_invoke args...]
FORMAT
LOGIN [person[.project[.org]] [-LP [passwd]] [-C pathname args...] ]
The LOGIN command allows you to log in to a running process with a different
identity. This permits you to have multiple concurrent processes running
under different Subject Identifiers (SIDs). Type HELP PROTECTION SIDS for an
explanation of SIDs.
PLEASE NOTE that this command was designed to be invoked using the DM command
'cp /com/login', although it will also run in an existing Shell. You should
be aware of two things when using this command:
1. The DM does NOT assume the new identity, just the process using the
window does. Thus, activities performed by the DM are done using
your original DM login identity. In particular, note that access
to objects using the 'edit' (CE) and 'read' (CV) keys is determined
by the DM's identity only.
2. The LOGIN command runs as a protected subsystem and requires a new
process when it is invoked. If you log in to an existing window, a
new process is spawned that shares the window but is not known to
the DM. Thus, activities performed by the DM do not use the
context of the new process but only the context of the original
process. For example, the working directory used for the 'edit'
and 'read' keys will be that of the original process, which is NOT
necessarily the one shown if you type 'WD' in the window. Invoking
LOGIN directly using 'cp /com/login' will remove the extra process
layer and ease this problem. However, the DM will STILL not assume
the process identity; it will merely be in direct contact with the
new process.
To log out of a running process and return control of the process to the
original SID, enter an end-of-file mark (usually CTRL/Z) in the process input
pad.
ARGUMENTS
person
(optional) Specify your username. If you omit 'person', then LOGIN
prompts you to log in interactively. In this case, respond
just as you do to the DM log in prompt, i.e., issue the L
command in the form:
L person[.project[.org]] [-P] [-H]
You will be asked for a password, and may take the
opportunity to change your password and login home
directory with the -P and -H options. Type HELP L for more
information on the L command. When you have successfully
logged in, the process in the window assumes the new
identity, and the node's local registry is updated.
Default if omitted: prompt for 'L' command
project
(optional) Specify project ID (if one exists). This ID may be
separated from 'person' by either a blank space or a
period.
Default if omitted: no project ID specified
org
(optional) Specify organization ID (if one exists). This ID may be
separated from 'person' by either a blank space or a
period.
Default if omitted: no organization ID specified
OPTIONS
-LP [passwd] Specify password. If the 'person' argument appears on the
command line, and -LP is not specified, you will be
prompted for a password. If -LP is specified without an
associated password, a blank password is used. -LP must
follow the 'person' argument and precede the -C option. In
addition, "-C" cannot be the password. Note that using -LP
makes your password visible in the window.
After a successful login, the node local registry is
updated with the new identity.
-C pathname [args ...]
Specify a program (followed by optional arguments to be
passed to the program) that is to be invoked in the window
after a successful login. If -C is not specified, /COM/SH
(the Shell) is invoked. -C must not precede the 'person'
argument.
EXAMPLES
$ login
Please log in: l user
Password:
Logged in as user.none.none Monday, March 5, 1984 11:06:55 (EST).
$ .
.
.
$ (CTRL/Z)
*** EOF ***
process stop (OS/fault handler)
$ # Control returned to original SID
RELATED TOPICS
More information is available. Type:
- HELP L
for details about logging into a node.
- HELP PROTECTION PROTECTED_SUBSYSTEMS
for details about protected subsystem usage.