.TH "PAM_DBUS" "8" "2017/05/18" "Linux-PAM Manual" "Linux-PAM Manual"
.SH "NAME"
pam_dbus \- PAM module for asking the logged in user for confirmation
.SH "SYNOPSIS"
.HP \w'\fBpam_dbus\&.so\fR\ 'u
\fBpam_dbus\&.so\fR
.SH "DESCRIPTION"
.PP
The simple PAM module
\fIpam_dbus\fR
will, when being used to authenticate a
(typically remote) user, use D-Bus to ask any currently logged
in (typically local) user if that is OK.
.SH "RETURN VALUES"
.PP
PAM_AUTH_ERR
.RS 4
Access denied\&.
.RE
.PP
PAM_SUCCESS
.RS 4
Access allowed\&.
.RE
.SH "FILES"
.PP
/etc/dbus-1/system.d/pam_dbus.conf
.RS 4
Configuration of the policy for the PAM module \fIpam_dbus\fR\&.
.RE
.PP
/etc/xdg/autostart/pam-dbus-notify.desktop
.RS 4
The Desktop Entry for the \fIpam-dbus\fR handler which
answers authentication requests done by PAM module \fIpam_dbus\fR\o&.
.RE
.SH "EXAMPLE"
To use \fBpam_dbus\fR a line
.RS 4
.PP
.I auth\ \ \ \ \ required\ \ \ \ \ pam_dbus\&.so
.PP
.RE
as replacement or as addon line before the line
.RS 4
.PP
.I auth\ \ \ \ \ include\ \ \ \ \ \ common\-auth
.PP
.RE
in one of the PAM configuration files
.IR sshd ,\  su ,\  su-l ,\ and\  sudo
below
.IR /etc/pam.d/ .
After
.I /usr/share/pam_dbus/pam-dbus-notify
had been started by
.I /etc/xdg/autostart/pam-dbus-notify.desktop
at login of a local user, this local user gets
notified on usage of
.IR sshd ,\  su ,\  su-l ,\ or\  sudo .
.SH "NOTES"
The system administrator is aware that every modified file below
.I /etc/pam.d/
is on his own obligation. For this: after an update of one of the pam
packages, system upgrade, or system update, the system administrator
may check the pam configuration by comparing the modified files
with files having suffixes
.IR .rpmsave\  or\  .rpmnew
for required supplements in the modified pam configuration files.
.SH "BUGS"
Please read section
.BR NOTES .
.SH "SEE ALSO"
.PP
\fBpam.conf\fR(5),
\fBpam.d\fR(5),
\fBpam\fR(8)
.SH "AUTHOR"
.PP
\fIpam_dbus\fR was written by Joachim Breitner <mail@joachim-breitner\&.de>