1*ab3002c2Sbostic.\" Copyright (c) 1983, 1991, 1993 2*ab3002c2Sbostic.\" The Regents of the University of California. All rights reserved. 3794f3430Smckusick.\" 41b2120cbStrent.\" %sccs.include.redist.man% 5ce906f97Sbostic.\" 6*ab3002c2Sbostic.\" @(#)vipw.8 8.1 (Berkeley) 06/06/93 7794f3430Smckusick.\" 8abfc8893Scael.Dd 9abfc8893Scael.Dt VIPW 8 10abfc8893Scael.Os BSD 4 11abfc8893Scael.Sh NAME 12abfc8893Scael.Nm vipw 13abfc8893Scael.Nd edit the password file 14abfc8893Scael.Sh SYNOPSIS 15abfc8893Scael.Nm vipw 16abfc8893Scael.Sh DESCRIPTION 17abfc8893Scael.Nm Vipw 18abfc8893Scaeledits the password file after setting the appropriate locks, 19abfc8893Scaeland does any necessary processing after the password file is unlocked. 20abfc8893ScaelIf the password file is already locked for editing by another user, 21abfc8893Scael.Nm vipw 22abfc8893Scaelwill ask you 23abfc8893Scaelto try again later. The default editor for 24abfc8893Scael.Nm vipw 25abfc8893Scaelis 26abfc8893Scael.Xr vi 1 . 27abfc8893Scael.Pp 28abfc8893Scael.Nm Vipw 29abfc8893Scaelperforms a number of consistency checks on the password entries, 30abfc8893Scaeland will not allow a password file with a 31abfc8893Scael.Dq mangled 32abfc8893Scaelentry to be 33abfc8893Scaelinstalled. 3482be3c8dSbosticIf 35abfc8893Scael.Nm vipw 36abfc8893Scaelrejects the new password file, the user is prompted to re-enter 37abfc8893Scaelthe edit session. 38abfc8893Scael.Pp 39abfc8893ScaelOnce the information has been verified, 40abfc8893Scael.Nm vipw 41abfc8893Scaeluses 42abfc8893Scael.Xr pwd_mkdb 8 43abfc8893Scaelto update the user database. This is run in the background, and, 44abfc8893Scaelat very large sites could take several minutes. Until this update 45abfc8893Scaelis completed, the password file is unavailable for other updates 46abfc8893Scaeland the new information is not available to programs. 47abfc8893Scael.Sh ENVIRONMENT 48abfc8893ScaelIf the following environment variable exists it will be utilized by 49abfc8893Scael.Nm vipw : 50abfc8893Scael.Bl -tag -width EDITOR 51abfc8893Scael.It Ev EDITOR 52abfc8893ScaelThe editor specified by the string 53abfc8893Scael.Ev EDITOR 54abfc8893Scaelwill be invoked instead of the default editor 55abfc8893Scael.Xr vi 1 . 56abfc8893Scael.El 57abfc8893Scael.Sh SEE ALSO 58abfc8893Scael.Xr chpass 1 , 59abfc8893Scael.Xr passwd 1 , 60abfc8893Scael.Xr passwd 5 , 61abfc8893Scael.Xr adduser 8 , 62abfc8893Scael.Xr pwd_mkdb 8 63abfc8893Scael.Sh HISTORY 64abfc8893ScaelThe 65abfc8893Scael.Nm 66abfc8893Scaelcommand appeared in 67abfc8893Scael.Bx 4.0 . 68