137 lines
3 KiB
Groff
137 lines
3 KiB
Groff
'\" t
|
|
.\" Title: vipw
|
|
.\" Author: Marek Michałkiewicz
|
|
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
|
|
.\" Date: 03/19/2025
|
|
.\" Manual: System Management Commands
|
|
.\" Source: shadow-utils 4.17.4
|
|
.\" Language: English
|
|
.\"
|
|
.TH "VIPW" "8" "03/19/2025" "shadow\-utils 4\&.17\&.4" "System Management Commands"
|
|
.\" -----------------------------------------------------------------
|
|
.\" * 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"
|
|
vipw, vigr \- edit the password, group, shadow\-password or shadow\-group file
|
|
.SH "SYNOPSIS"
|
|
.HP \w'\fBvipw\fR\ 'u
|
|
\fBvipw\fR [\fIoptions\fR]
|
|
.HP \w'\fBvigr\fR\ 'u
|
|
\fBvigr\fR [\fIoptions\fR]
|
|
.SH "DESCRIPTION"
|
|
.PP
|
|
The
|
|
\fBvipw\fR
|
|
and
|
|
\fBvigr\fR
|
|
commands edit the files
|
|
/etc/passwd
|
|
and
|
|
/etc/group, respectively\&. With the
|
|
\fB\-s\fR
|
|
flag, they will edit the shadow versions of those files,
|
|
/etc/shadow
|
|
and
|
|
/etc/gshadow, respectively\&. The programs will set the appropriate locks to prevent file corruption\&. When looking for an editor, the programs will first try the environment variable
|
|
\fB$VISUAL\fR, then the environment variable
|
|
\fB$EDITOR\fR, and finally the default editor,
|
|
\fBvi\fR(1)\&.
|
|
.SH "OPTIONS"
|
|
.PP
|
|
The options which apply to the
|
|
\fBvipw\fR
|
|
and
|
|
\fBvigr\fR
|
|
commands are:
|
|
.PP
|
|
\fB\-g\fR, \fB\-\-group\fR
|
|
.RS 4
|
|
Edit group database\&.
|
|
.RE
|
|
.PP
|
|
\fB\-h\fR, \fB\-\-help\fR
|
|
.RS 4
|
|
Display help message and exit\&.
|
|
.RE
|
|
.PP
|
|
\fB\-p\fR, \fB\-\-passwd\fR
|
|
.RS 4
|
|
Edit passwd database\&.
|
|
.RE
|
|
.PP
|
|
\fB\-q\fR, \fB\-\-quiet\fR
|
|
.RS 4
|
|
Quiet mode\&.
|
|
.RE
|
|
.PP
|
|
\fB\-R\fR, \fB\-\-root\fR\ \&\fICHROOT_DIR\fR
|
|
.RS 4
|
|
Apply changes in the
|
|
\fICHROOT_DIR\fR
|
|
directory and use the configuration files from the
|
|
\fICHROOT_DIR\fR
|
|
directory\&. Only absolute paths are supported\&.
|
|
.RE
|
|
.PP
|
|
\fB\-s\fR, \fB\-\-shadow\fR
|
|
.RS 4
|
|
Edit shadow or gshadow database\&.
|
|
.RE
|
|
.SH "ENVIRONMENT"
|
|
.PP
|
|
\fBVISUAL\fR
|
|
.RS 4
|
|
Editor to be used\&.
|
|
.RE
|
|
.PP
|
|
\fBEDITOR\fR
|
|
.RS 4
|
|
Editor to be used if
|
|
\fBVISUAL\fR
|
|
is not set\&.
|
|
.RE
|
|
.SH "FILES"
|
|
.PP
|
|
/etc/group
|
|
.RS 4
|
|
Group account information\&.
|
|
.RE
|
|
.PP
|
|
/etc/gshadow
|
|
.RS 4
|
|
Secure group account information\&.
|
|
.RE
|
|
.PP
|
|
/etc/passwd
|
|
.RS 4
|
|
User account information\&.
|
|
.RE
|
|
.PP
|
|
/etc/shadow
|
|
.RS 4
|
|
Secure user account information\&.
|
|
.RE
|
|
.SH "SEE ALSO"
|
|
.PP
|
|
\fBvi\fR(1),
|
|
\fBgroup\fR(5),
|
|
\fBgshadow\fR(5)
|
|
,
|
|
\fBpasswd\fR(5), ,
|
|
\fBshadow\fR(5)\&.
|