Node:login, Next:who-is-on-ident, Previous:find-previous-text-no, Up:Protocol Requests
login [62] (( person : Pers-No; passwd : HOLLERITH; invisible : BOOL )) -> ( );
This call is used to log in. The session is logged in as person number
person
if passwd
is the correct password for that person.
If invisible
is true, the session is invisible: it will not be
returned by who-is-on
and who-is-on-ident
, and the
dynamic session info (see Dynamic-Session-Info)
will have the invisible flag set.
Invisible sessions are primarily used by software agents that do not act on the behalf of real users.
Example:
1 62 7 6Hgazonk 1 =1 1 62 7 6Hgazonk 0 :2 9 7 1 1 62 7 6Hgazonk 0 :2 13 7 1 :2 9 7 1 =1
This example first shows a session log in as person seven with the invisible flag set. Because of this the asynchronous login message is not sent. The second call logs in as person seven again. This time a login message is sent, but not a logout message since the login was invisible. The third example shows a third login as person 7, but this time both the logout and login messages are sent.
undefined-person
person
does not exist.
login-disallowed
person
does not have enough
privileges to override.
invalid-password
passwd
is not the password of person
and the
currently logged in person is not the supervisor of person
and
does not have enough privileges set and enabled to log in anyway.
conference-zero
bad-bool
invisible
must be either 0
or 1
.