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