'\" t
.\"     Title: pwupdd
.\"    Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author]
.\" Generator: DocBook XSL Stylesheets v1.79.2 <http://docbook.sf.net/>
.\"      Date: 04/25/2026
.\"    Manual: pwupdd
.\"    Source: account-utils 1.2.0
.\"  Language: English
.\"
.TH "PWUPDD" "8" "04/25/2026" "account\-utils 1.2.0" "pwupdd"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
pwupdd, pwupdd.service, pwupdd.socket \- update passwd and shadow entries
.SH "SYNOPSIS"
.HP \w'\fBpwupdd\&.service\fR\ 'u
\fBpwupdd\&.service\fR
.HP \w'\fBpwupdd\&.socket\fR\ 'u
\fBpwupdd\&.socket\fR
.HP \w'\fB/usr/libexec/pwupdd\fR\ 'u
\fB/usr/libexec/pwupdd\fR [OPTIONS...]
.SH "DESCRIPTION"
.PP
\fBpwupdd\fR
is an
\fBinetd\fR(8)
style socket\-activated service\&. A new instance of the daemon is started for every incoming request\&.
.PP
It exposes a Varlink interface to allow authorized users to modify their own account data, including passwords, login shells, and GECOS field information\&. Authentication is handled via
\fBPAM\fR(8)\&. Additionally, the root user can utilize specific methods to update any
/etc/passwd
or
/etc/shadow
entry\&.
.SH "OPTIONS"
.PP
\fB\-d\fR, \fB\-\-debug\fR
.RS 4
Enable debug mode\&.
.RE
.PP
\fB\-v\fR, \fB\-\-verbose\fR
.RS 4
Enable verbose logging\&.
.RE
.PP
\fB\-?\fR, \fB\-\-help\fR
.RS 4
Give the help list\&.
.RE
.PP
\fB\-\-version\fR
.RS 4
Print program version\&.
.RE
.SH "VARLINK INTERFACES"
.PP
The service exposes the following methods via Varlink:
.PP
\fBChauthtok\fR
.RS 4
Changes the password for a provided user\&. Authentication is performed via PAM using the configuration
pwupd\-passwd\&. This method may be called by the root user or the user owning the record\&.
.RE
.PP
\fBChfn\fR
.RS 4
Changes the finger (GECOS) information of a user\&. Authentication is performed via PAM using the configuration
pwupd\-chfn\&. This method may be called by the root user or the user owning the record\&.
.RE
.PP
\fBChsh\fR
.RS 4
Changes the login shell of an account\&. Authentication is performed via PAM using the configuration
pwupd\-chsh\&. This method may be called by the root user or the user owning the record\&.
.RE
.PP
\fBUpdatePasswdShadow\fR
.RS 4
Updates the
passwd
and
shadow
entry of a specified user\&.
\fBOnly root is allowed to call this method\&.\fR
.RE
.SH "SEE ALSO"
.PP
\fBpasswd\fR(1),
\fBchfn\fR(1),
\fBchsh\fR(1),
\fBpam\fR(8)