.\" Copyright (C) 2001, 2002, 2003, 2004 Arthur de Jong
.\"
.\" This program is free software; you can redistribute it and/or modify
.\" it under the terms of the GNU General Public License as published by
.\" the Free Software Foundation; either version 2, or (at your option)
.\" any later version.
.\"
.\" This program is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public License
.\" along with this program; if not, write to the Free Software
.\" Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
.TH "cvsd\-passwd" "8" "Jun 2012" "Version 1.0.24" "System Manager's Manual"
.nh
.SH "NAME"
cvsd\-passwd \- generate password entries for repositories
.SH "SYNOPSIS"
.B cvsd\-passwd
.RI REPOS
.RI [+|\-]NAME...
.SH "DESCRIPTION"
\fBcvsd\-passwd\fP adds, updates or deletes users from repository passwd files for use with cvsd.
.SH "OPTIONS"
.TP
.B REPOS
Specify the directory in which the repository is located. This argument can be the top of the repository, the CVSROOT directory or even the passwd file in the CVSROOT directory.
.TP
.B [+]USER[:SUSER]
Add or update the user to the CVSROOT/passwd file.
If the user does not exist a password for the user is asked and the user is added for use with cvsd.
If the user already exists a password for is asked and the password field is modified.

The :SUSER part can be user to change or set mapping to a system user.
If you do not specify anything, a reasonable default is used based upon your cvsd configuration.
If you don't want to map the user to any specified system user you can specify an empty SUSER and use \(oqUSER:\(cq.
.TP
.B \-USER
Remove the user from the CVSROOT/passwd file.
.SH "EXAMPLES"
Add an anoncvs user to access the given repository:
.ft B
    cvsd\-passwd /var/lib/cvsd/myrepos +anoncvs
.ft R
.br
If the user already exists, change the password.

Remove a user from the repository passwd list:
.ft B
    cvsd\-passwd /var/lib/cvsd/myrepos \-foo
.ft R

Add a user and specify that cvs should remap this user to the joe system user:
.ft B
    cvsd\-passwd /var/lib/cvsd/myrepos joecvs:joe
.ft R
.br
Note that the user joe should be known in the system passwd file and that cvsd should be run as root or user joe for this to work.
.SH "SEE ALSO"
.BR cvsd(8)
.SH "AUTHOR"
Arthur de Jong <arthur@arthurdejong.org>.