logo

skeud

Simple and portable utilities to deal with user accounts (su, login)

login.1 (1018B)


  1. .\" SPDX-FileCopyrightText: 2022-2023 Haelwenn (lanodan) Monnier <contact+skeud@hacktivis.me>
  2. .\" SPDX-License-Identifier: MPL-2.0
  3. .Dd 2023-09-10
  4. .Dt LOGIN 1
  5. .Os
  6. .Sh NAME
  7. .Nm login
  8. .Nd begin session on the system
  9. .Sh SYNOPSIS
  10. .Nm
  11. .Op Fl p
  12. .Op Ar username
  13. .Nm
  14. .Op Fl p
  15. .Op Fl f
  16. .Ar username
  17. .Sh DESCRIPTION
  18. The
  19. .Nm
  20. utility logs users (and pseudo-users) into the system.
  21. .Pp
  22. If
  23. .Ar username
  24. is given
  25. .Nm
  26. skips asking for a user name.
  27. .Ss OPTIONS
  28. .Bl -tag -width Ds
  29. .It Fl p
  30. Preserve environment.
  31. .It Fl f Ar username
  32. Do not perform authentication, user is preauthenticated.
  33. .El
  34. .Sh EXIT STATUS
  35. If the user's shell is invoked, the exit status of
  36. .Nm
  37. shall be the exit status of the shell.
  38. Otherwise, the
  39. .Nm
  40. utility shall exit with one of the following values:
  41. .Bl -tag -width Ds
  42. .It 1
  43. An error occured or the authentication failed
  44. .It 126
  45. User's shell was found but couldn't be invoked.
  46. .It 127
  47. User's shell wasn't found.
  48. .El
  49. .Sh STANDARDS
  50. N/A
  51. .Sh AUTHORS
  52. .An Haelwenn (lanodan) Monnier Aq Mt contact+skeud@hacktivis.me