Penguin
Recent Changes
Annotated edit history of pwunconv(8) version 2, including all changes. View license author blame.
Rev Author # Line
1 perry 1 PWCONV
2 !!!PWCONV
3 NAME
4 SYNOPSIS
5 DESCRIPTION
6 BUGS
7 SEE ALSO
8 ----
9 !!NAME
10
11
12 pwconv, pwunconv, grpconv, grpunconv - convert to and from shadow passwords and groups.
13 !!SYNOPSIS
14
15
16 __pwconv
17 pwunconv
18 grpconv
19 grpunconv__
20 !!DESCRIPTION
21
22
23 These four programs all operate on the normal and shadow
24 password and group files: ''/etc/passwd'',
25 ''/etc/group'', ''/etc/shadow'', and
26 ''/etc/gshadow''.
27
28
29 __pwconv__ creates ''shadow'' from ''passwd'' and
30 an optionally existing ''shadow''. __pwunconv__
31 creates ''passwd'' from ''passwd'' and ''shadow''
32 and then removes ''shadow''. __grpconv__ creates
33 ''gshadow'' from ''group'' and an optionally existing
34 ''gshadow''. __grpunconv__ creates ''group'' from
35 ''group'' and ''gshadow'' and then removes
36 ''gshadow''.
37
38
39 Each program acquires the necessary locks before
40 conversion.
41
42
43 __pwconv__ and __grpconv__ are similiar. First,
44 entries in the shadowed file which don't exist in the main
45 file are removed. Then, shadowed entries which don't have
46 `x' as the password in the main file are updated. Any
47 missing shadowed entries are added. Finally, passwords in
48 the main file are replaced with `x'. These programs can be
49 used for initial conversion as well to update the shadowed
50 file if the main file is edited by hand.
51
52
53 __pwconv__ will use the values of __PASS_MIN_DAYS__,
54 __PASS_MAX_DAYS__, and __PASS_WARN_AGE__ from
55 ''/etc/login.defs'' when adding new entries to
56 ''/etc/shadow''.
57
58
59 Likewise, __pwunconv__ and __grpunconv__ are similiar.
60 Passwords in the main file are updated from the shadowed
61 file. Entries which exist in the main file but not in the
62 shadowed file are left alone. Finally, the shadowed file is
63 removed.
64
65
66 Some password aging information is lost by __pwunconv__.
67 It will convert what it can.
68 !!BUGS
69
70
71 Errors in the password or group files (such as invalid or
72 duplicate entries) may cause these programs to loop forever
73 or fail in other strange ways. Please run __pwck__ and
74 __grpck__ to correct any such errors before converting to
75 or from shadow passwords or groups.
76 !!SEE ALSO
77
78
2 perry 79 login.defs(5), pwck(8), grpck(8),
1 perry 80 shadowconfig(8)
81 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.