This manual page is for Mac OS X version 10.6.3

If you are running a different version of Mac OS X, view the documentation locally:

  • In Terminal, using the man(1) command

Reading manual pages

Manual pages are intended as a quick reference for people who already understand a technology.

  • For more information about the manual page format, see the manual page for manpages(5).

  • For more information about this technology, look for other documentation in the Apple Reference Library.

  • For general information about writing shell scripts, read Shell Scripting Primer.



VIPW(8)                                  BSD System Manager's Manual                                 VIPW(8)

NAME
     vipw -- edit the password file

SYNOPSIS
     vipw

DESCRIPTION
     Vipw edits the password file after setting the appropriate locks, and does any necessary processing
     after the password file is unlocked.  If the password file is already locked for editing by another
     user, vipw will ask you to try again later. The default editor for vipw is vi(1).

     Vipw performs a number of consistency checks on the password entries, and will not allow a password
     file with a ``mangled'' entry to be installed.  If vipw rejects the new password file, the user is
     prompted to re-enter the edit session.

     Once the information has been verified, vipw uses pwd_mkdb(8) to update the user database.  This is run
     in the background, and, at very large sites could take several minutes.  Until this update is com-pleted, completed,
     pleted, the password file is unavailable for other updates and the new information is not available to
     programs.

ENVIRONMENT
     If the following environment variable exists it will be utilized by vipw:

     EDITOR  The editor specified by the string EDITOR will be invoked instead of the default editor vi(1).

SEE ALSO
     chpass(1), passwd(1), passwd(5), pwd_mkdb(8)

HISTORY
     The vipw command appeared in 4.0BSD.

4th Berkeley Distribution                       June 6, 1993                       4th Berkeley Distribution

Reporting Problems

The way to report a problem with this manual page depends on the type of problem:

Content errors
Report errors in the content of this documentation with the feedback links below.
Bug reports
Report bugs in the functionality of the described tool or API through Bug Reporter.
Formatting problems
Report formatting mistakes in the online version of these pages with the feedback links below.

Did this document help you? Yes It's good, but... Not helpful...