login.1 (1018B)
- .\" SPDX-FileCopyrightText: 2022-2023 Haelwenn (lanodan) Monnier <contact+skeud@hacktivis.me>
- .\" SPDX-License-Identifier: MPL-2.0
- .Dd 2023-09-10
- .Dt LOGIN 1
- .Os
- .Sh NAME
- .Nm login
- .Nd begin session on the system
- .Sh SYNOPSIS
- .Nm
- .Op Fl p
- .Op Ar username
- .Nm
- .Op Fl p
- .Op Fl f
- .Ar username
- .Sh DESCRIPTION
- The
- .Nm
- utility logs users (and pseudo-users) into the system.
- .Pp
- If
- .Ar username
- is given
- .Nm
- skips asking for a user name.
- .Ss OPTIONS
- .Bl -tag -width Ds
- .It Fl p
- Preserve environment.
- .It Fl f Ar username
- Do not perform authentication, user is preauthenticated.
- .El
- .Sh EXIT STATUS
- If the user's shell is invoked, the exit status of
- .Nm
- shall be the exit status of the shell.
- Otherwise, the
- .Nm
- utility shall exit with one of the following values:
- .Bl -tag -width Ds
- .It 1
- An error occured or the authentication failed
- .It 126
- User's shell was found but couldn't be invoked.
- .It 127
- User's shell wasn't found.
- .El
- .Sh STANDARDS
- N/A
- .Sh AUTHORS
- .An Haelwenn (lanodan) Monnier Aq Mt contact+skeud@hacktivis.me