1*61899Sbostic.\" Copyright (c) 1983, 1991, 1993 2*61899Sbostic.\" The Regents of the University of California. All rights reserved. 318935Smckusick.\" 443807Strent.\" %sccs.include.redist.man% 518935Smckusick.\" 6*61899Sbostic.\" @(#)vipw.8 8.1 (Berkeley) 06/06/93 736858Sbostic.\" 847470Scael.Dd 947470Scael.Dt VIPW 8 1047470Scael.Os BSD 4 1147470Scael.Sh NAME 1247470Scael.Nm vipw 1347470Scael.Nd edit the password file 1447470Scael.Sh SYNOPSIS 1547470Scael.Nm vipw 1647470Scael.Sh DESCRIPTION 1747470Scael.Nm Vipw 1847470Scaeledits the password file after setting the appropriate locks, 1947470Scaeland does any necessary processing after the password file is unlocked. 2047470ScaelIf the password file is already locked for editing by another user, 2147470Scael.Nm vipw 2247470Scaelwill ask you 2347470Scaelto try again later. The default editor for 2447470Scael.Nm vipw 2547470Scaelis 2647470Scael.Xr vi 1 . 2747470Scael.Pp 2847470Scael.Nm Vipw 2947470Scaelperforms a number of consistency checks on the password entries, 3047470Scaeland will not allow a password file with a 3147470Scael.Dq mangled 3247470Scaelentry to be 3347470Scaelinstalled. 3437134SbosticIf 3547470Scael.Nm vipw 3647470Scaelrejects the new password file, the user is prompted to re-enter 3747470Scaelthe edit session. 3847470Scael.Pp 3947470ScaelOnce the information has been verified, 4047470Scael.Nm vipw 4147470Scaeluses 4247470Scael.Xr pwd_mkdb 8 4347470Scaelto update the user database. This is run in the background, and, 4447470Scaelat very large sites could take several minutes. Until this update 4547470Scaelis completed, the password file is unavailable for other updates 4647470Scaeland the new information is not available to programs. 4747470Scael.Sh ENVIRONMENT 4847470ScaelIf the following environment variable exists it will be utilized by 4947470Scael.Nm vipw : 5047470Scael.Bl -tag -width EDITOR 5147470Scael.It Ev EDITOR 5247470ScaelThe editor specified by the string 5347470Scael.Ev EDITOR 5447470Scaelwill be invoked instead of the default editor 5547470Scael.Xr vi 1 . 5647470Scael.El 5747470Scael.Sh SEE ALSO 5847470Scael.Xr chpass 1 , 5947470Scael.Xr passwd 1 , 6047470Scael.Xr passwd 5 , 6147470Scael.Xr adduser 8 , 6247470Scael.Xr pwd_mkdb 8 6347470Scael.Sh HISTORY 6447470ScaelThe 6547470Scael.Nm 6647470Scaelcommand appeared in 6747470Scael.Bx 4.0 . 68