2.9BSD/usr/man/cat2/login.2

Compare this file to the similar file:
Show the results in this format:

LOGIN(2)            UNIX Programmer's Manual             LOGIN(2)

NAME
     login - flag login process and collect accounting informa-
     tion

SYNOPSIS
     login(flag, crn);
     char crn[4];

DESCRIPTION
     _L_o_g_i_n marks the current process as being a login process and
     associates the specified _c_r_n with it for accounting pur-
     poses.  The _c_r_n is inherited by children, the flag is not.
     _C_r_n is the customer recharge number, also known as ``job
     number.''

     By convention, the _f_l_a_g given to a login process is the
     value returned by _t_t_y_s_l_o_t(3) for its control typewriter.
     This is vestigal.

     Use of this call is restricted to the super-user.

RETURN VALUE
     Upon successful completion, a value of 0 is returned.  Oth-
     erwise, a value of -1 is returned and _e_r_r_n_o is set to indi-
     cate the error.

ERRORS
     _L_o_g_i_n will fail if:

     [EPERM]             The effective user ID is not the super-
                         user.

ASSEMBLER
     (local = 58., login = 1.)
     sys local; 9f
     . . .
     .data
     9: sys login; flag; crn01; crn23

Printed 5/23/83                                                 1