pam_exec(8)

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

NAME

6       pam_exec - PAM module which calls an external command
7

SYNOPSIS

9       pam_exec.so [debug] [seteuid] [log=file] command [...]
10

DESCRIPTION

12       pam_exec is a PAM module that can be used to run an external command.
13

OPTIONS

15       debug
16          Print debug information.
17
18       log=file
19          The output of the command is appended to file
20
21       seteuid
22          Per default pam_exec.so will execute the external command with the
23          real user ID of the calling process. Specifying this option means
24          the command is run with the effective user ID.
25

MODULE SERVICES PROVIDED

27       The services auth, account, password and session are supported.
28

RETURN VALUES

30       PAM_SUCCESS
31          The external command runs successfull.
32
33       PAM_SERVICE_ERR
34          No argument or a wrong number of arguments were given.
35
36       PAM_SYSTEM_ERR
37          A system error occured or the command to execute failed.
38
39       PAM_IGNORE
40
41          pam_setcred was called, which does not execute the command.
42

EXAMPLES

44       Add the following line to /etc/pam.d/passwd to rebuild the NIS database
45       after each local password change:
46
47                  passwd optional pam_exec.so seteuid make -C /var/yp
48
49
50       This will execute the command
51
52          make -C /var/yp
53
54       with effective user ID.
55

AUTHOR

60       pam_exec was written by Thorsten Kukuk <kukuk@thkukuk.de>.
61
62
63
64Linux-PAM Manual                  06/09/2006                       PAM_EXEC(8)