Print this page
10067 Miscellaneous man page typos
Reviewed by: Robert Mustacchi <rm@joyent.com>
Reviewed by: Andy Fiddaman <andy@omniosce.org>
Reviewed by: Volker A. Brandt <vab@bb-c.de>
Split |
Close |
Expand all |
Collapse all |
--- old/usr/src/man/man1m/ypmap2src.1m.man.txt
+++ new/usr/src/man/man1m/ypmap2src.1m.man.txt
1 1 YPMAP2SRC(1M) Maintenance Commands YPMAP2SRC(1M)
2 2
3 3
4 4
5 5 NAME
6 6 ypmap2src - convert NIS maps to NIS source files
7 7
8 8 SYNOPSIS
9 9 /usr/lib/netsvc/yp/ypmap2src [-t]
10 10 [ [-c custom-map-name]]... [-d domain] -o output-directory
11 11 [ [ source-file]]...
12 12
13 13
14 14 DESCRIPTION
15 15 Use the ypmap2src utility to convert standard NIS maps to
16 16 approximations of the equivalent NIS source files. This utility
17 17 functions like the reverse of ypmake(1M).
18 18
19 19
20 20 The primary use for ypmap2src is to convert from a NIS server that uses
21 21 the NIS to LDAP(N2L) transition mechanism, which does not use NIS
22 22 source files, to traditional NIS, where source files are required. The
23 23 ypmap2src utility is also used by NIS administrators who wish to
24 24 discover the contents of NIS maps for which the sources are not
25 25 available.
26 26
27 27
28 28 Generally, this operation is not necessary. More often, administrators
29 29 will switch from traditional NIS to N2L in anticipation of the eventual
30 30 transition to LDAP naming. When this switch is made, authoritative
31 31 information is moved into the LDAP DIT, and the NIS sources have no
32 32 further role. N2L supports NIS clients until such time as they can be
33 33 converted to LDAP, and the NIS service suspended.
34 34
35 35
36 36 The ypmap2src utility does not guarantee that the files that are
37 37 generated are identical to the original NIS source files. Some
38 38 information might have been thrown away by ypmake and cannot be
39 39 recovered. N2L also might have updated the maps to reflect changes made
40 40 by LDAP clients. It is essential that the sources generated are checked
41 41 to confirm no problems have occurred.
42 42
43 43
44 44 Per entry comment fields, from existing source files, are not merged
45 45 into source files generated by ypmap2src. If a user wishes N2L to
46 46 maintain comment information, then the NISLDAPmapping configuration
47 47 file should be modified so that the comment fields are mapped into
48 48 LDAP. This will ensure that the comments are visible to native LDAP
49 49 clients and present in the N2L map files.
50 50
51 51
52 52 When ypmap2src is run, it will take up-to-date comments from the map
53 53 file and insert them into the NIS source file generated.
54 54
55 55 Handling Custom Maps
56 56 ypmap2src only knows about the standard NIS maps and standard source to
57 57 map conversion. If an advanced user has changed these, that is, the
58 58 user has modified the NIS makefile, the equivalent changes must also be
59 59 made to the ypmap2src script.
60 60
61 61 OPTIONS
62 62 ypmap2src supports the following options:
63 63
64 64 -c
65 65 Specifies that custom-map-name should be converted to
66 66 a source file by running makedbm -u on it. This is a
67 67 short cut so that simple custom maps can be handled
68 68 without editing ypmap2src.
69 69
70 70
71 71 -d domain-name
72 72 Specifies the domain to convert. The domain-name can
73 73 be a fully qualified file path, such as
74 74 /var/yp/a.b.c, or just a domain name, a.b.c. In the
75 75 latter case, ypmaptosrc looks in /var/yp for the
76 76 domain directory.
77 77
78 78
79 79 -o dest
80 80 Specifies the destination directory for the
81 81 converted files. A directory other than /etc should
82 82 be specified. The maps generated are copied to the
83 83 correct location, /etc, /etc/security or other source
84 84 directory, as appropriate.
85 85
86 86
87 87 -t
88 88 Specifies that traditional NIS maps, without N2L's
↓ open down ↓ |
88 lines elided |
↑ open up ↑ |
89 89 LDAP_ prefix, should be converted. By default, maps
90 90 with the LDAP_ prefix are converted.
91 91
92 92
93 93 OPERANDS
94 94 ypmap2src supports the following operands:
95 95
96 96 source-file
97 97 Lists the standard source files to convert. If this
98 98 option is not given, then all the standard source files,
99 - plus any custom files pecified by the -c option, are
99 + plus any custom files specified by the -c option, are
100 100 converted.
101 101
102 102
103 103 ATTRIBUTES
104 104 See attributes(5) for descriptions of the following attributes:
105 105
106 106
107 107
108 108
109 109 +--------------------+-----------------+
110 110 | ATTRIBUTE TYPE | ATTRIBUTE VALUE |
111 111 +--------------------+-----------------+
112 112 |Interface Stability | Obsolete |
113 113 +--------------------+-----------------+
114 114
115 115 SEE ALSO
116 116 ypmake(1M), ypserv(1M), NISLDAPmapping(4), attributes(5)
117 117
118 118
119 119
120 120
121 121
122 122 April 10, 2003 YPMAP2SRC(1M)
↓ open down ↓ |
13 lines elided |
↑ open up ↑ |
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX