pam_issue(8)

1PAM_ISSUE(8)                   Linux-PAM Manual                   PAM_ISSUE(8)
2
3
4

NAME

6       pam_issue - PAM module to add issue file to user prompt
7

SYNOPSIS

9       pam_issue.so [noesc] [issue=issue-file-name]
10

DESCRIPTION

12       pam_issue is a PAM module to prepend an issue file to the username
13       prompt. It also by default parses escape codes in the issue file
14       similar to some common getty's (using \x format).
15
16       Recognized escapes:
17
18       \d current day
19
20       \l name of this tty
21
22       \m machine architecture (uname -m)
23
24       \n machine's network node hostname (uname -n)
25
26       \o domain name of this system
27
28       \r release number of operating system (uname -r)
29
30       \t current time
31
32       \s operating system name (uname -s)
33
34       \u number of users currently logged in
35
36       \U same as \u except it is suffixed with "user" or "users" (eg. "1
37          user" or "10 users")
38
39       \v operating system version and build date (uname -v)
40

OPTIONS

42       noesc
43          Turns off escape code parsing.
44
45       issue=issue-file-name
46          The file to output if not using the default.
47

MODULE SERVICES PROVIDED

49       Only the auth service is supported.
50

RETURN VALUES

52       PAM_BUF_ERR
53          Memory buffer error.
54
55       PAM_IGNORE
56          The prompt was already changed.
57
58       PAM_SERVICE_ERR
59          A service module error occured.
60
61       PAM_SUCCESS
62          The new prompt was set successfull.
63

EXAMPLES

65       Add the following line to /etc/pam.d/login to set the user specific
66       issue at login:
67
68                  auth optional pam_issue.so issue=/etc/issue
69
70
71

AUTHOR

76       pam_issue was written by Ben Collins <bcollins@debian.org>.
77
78
79
80Linux-PAM Manual                  06/17/2006                      PAM_ISSUE(8)