manual/util-linux/original/man8/nologin.8

   1 '\" t
   2 .\"     Title: nologin
   3 .\"    Author: [see the "AUTHOR(S)" section]
   4 .\" Generator: Asciidoctor 2.0.15
   5 .\"      Date: 2022-02-14
   6 .\"    Manual: System Administration
   7 .\"    Source: util-linux 2.37.4
   8 .\"  Language: English
   9 .\"
  10 .TH "NOLOGIN" "8" "2022-02-14" "util\-linux 2.37.4" "System Administration"
  11 .ie \n(.g .ds Aq \(aq
  12 .el       .ds Aq '
  13 .ss \n[.ss] 0
  14 .nh
  15 .ad l
  16 .de URL
  17 \fI\\$2\fP <\\$1>\\$3
  18 ..
  19 .als MTO URL
  20 .if \n[.g] \{\
  21 .  mso www.tmac
  22 .  am URL
  23 .    ad l
  24 .  .
  25 .  am MTO
  26 .    ad l
  27 .  .
  28 .  LINKSTYLE blue R < >
  29 .\}
  30 .SH "NAME"
  31 nologin \- politely refuse a login
  32 .SH "SYNOPSIS"
  33 .sp
  34 \fBnologin\fP [\fB\-V\fP] [\fB\-h\fP]
  35 .SH "DESCRIPTION"
  36 .sp
  37 \fBnologin\fP displays a message that an account is not available and exits non\-zero. It is intended as a replacement shell field to deny login access to an account.
  38 .sp
  39 If the file \fI/etc/nologin.txt\fP exists, \fBnologin\fP displays its contents to the user instead of the default message.
  40 .sp
  41 The exit status returned by \fBnologin\fP is always 1.
  42 .SH "OPTIONS"
  43 .sp
  44 \fB\-c\fP, \fB\-\-command\fP \fIcommand\fP
  45 .sp
  46 \fB\-\-init\-file\fP
  47 .sp
  48 \fB\-i\fP \fB\-\-interactive\fP
  49 .sp
  50 \fB\-\-init\-file\fP \fIfile\fP
  51 .sp
  52 \fB\-i\fP, \fB\-\-interactive\fP
  53 .sp
  54 \fB\-l\fP, \fB\-\-login\fP
  55 .sp
  56 \fB\-\-noprofile\fP
  57 .sp
  58 \fB\-\-norc\fP
  59 .sp
  60 \fB\-\-posix\fP
  61 .sp
  62 \fB\-\-rcfile\fP \fIfile\fP
  63 .sp
  64 \fB\-r\fP, \fB\-\-restricted\fP
  65 .sp
  66 These shell command\-line options are ignored to avoid \fBnologin\fP error.
  67 .sp
  68 \fB\-h\fP, \fB\-\-help\fP
  69 .RS 4
  70 Display help text and exit.
  71 .RE
  72 .sp
  73 \fB\-V\fP, \fB\-\-version\fP
  74 .RS 4
  75 Display version information and exit.
  76 .RE
  77 .SH "NOTES"
  78 .sp
  79 \fBnologin\fP is a per\-account way to disable login (usually used for system accounts like http or ftp). \fBnologin\fP uses \fI/etc/nologin.txt\fP as an optional source for a non\-default message, the login access is always refused independently of the file.
  80 .sp
  81 \fBpam_nologin\fP(8) PAM module usually prevents all non\-root users from logging into the system. \fBpam_nologin\fP(8) functionality is controlled by \fI/var/run/nologin\fP or the \fI/etc/nologin\fP file.
  82 .SH "HISTORY"
  83 .sp
  84 The \fBnologin\fP command appeared in 4.4BSD.
  85 .SH "AUTHORS"
  86 .sp
  87 .MTO "kzak\(atredhat.com" "Karel Zak" ""
  88 .SH "SEE ALSO"
  89 .sp
  90 \fBlogin\fP(1),
  91 \fBpasswd\fP(5),
  92 \fBpam_nologin\fP(8)
  93 .SH "REPORTING BUGS"
  94 .sp
  95 For bug reports, use the issue tracker at \c
  96 .URL "https://github.com/karelzak/util\-linux/issues" "" "."
  97 .SH "AVAILABILITY"
  98 .sp
  99 The \fBnologin\fP command is part of the util\-linux package which can be downloaded from \c
 100 .URL "https://www.kernel.org/pub/linux/utils/util\-linux/" "Linux Kernel Archive" "."