vipw - Man Page

edit the password, group, shadow-password or shadow-group file

Examples (TL;DR)


vipw [options]

vigr [options]


The vipw and vigr commands edit the files /etc/passwd and /etc/group, respectively. With the -s 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 $VISUAL, then the environment variable $EDITOR, and finally the default editor, vi(1).


The options which apply to the vipw and vigr commands are:

-g,  --group

Edit group database.

-h,  --help

Display help message and exit.

-p,  --passwd

Edit passwd database.

-q,  --quiet

Quiet mode.

-R,  --root CHROOT_DIR

Apply changes in the CHROOT_DIR directory and use the configuration files from the CHROOT_DIR directory. Only absolute paths are supported.

-s,  --shadow

Edit shadow or gshadow database.



Editor to be used.


Editor to be used if VISUAL is not set.



Group account information.


Secure group account information.


User account information.


Secure user account information.

See Also

vi(1), group(5), gshadow(5) , passwd(5), , shadow(5).

Referenced By

group(5), passwd(5), visudo(8).

The man page vigr(8) is an alias of vipw(8).

08/16/2023 shadow-utils 4.14.0 System Management Commands