System Administration Commands ypmap2src(1M)
NAME
ypmap2src - convert NIS maps to NIS source files
SYNOPSIS
/usr/lib/netsvc/yp/ypmap2src [-t]
[ [-c custom-map-name]... [-d domain] -o output-directory
[ [ source-file]...
DESCRIPTION
Use the ypmap2src utility to convert standard NIS maps to
approximations of the equivalent NIS source files. This
utility functions like the reverse of ypmake(1M).
The primary use for ypmap2src is to convert from a NIS
server that uses the NIS to LDAP(N2L) transition mechanism,
which does not use NIS source files, to traditional NIS,
where source files are required. The ypmap2src utility is
also used by NIS administrators who wish to discover the
contents of NIS maps for which the sources are not avail-
able.
Generally, this operation is not necessary. More often,
administrators will switch from traditional NIS to N2L in
anticipation of the eventual transition to LDAP naming. When
this switch is made, authoritative information is moved into
the LDAP DIT, and the NIS sources have no further role. N2L
supports NIS clients until such time as they can be con-
verted to LDAP, and the NIS service suspended.
The ypmap2src utility does not guarantee that the files that
are generated are identical to the original NIS source
files. Some information might have been thrown away by
ypmake and cannot be recovered. N2L also might have updated
the maps to reflect changes made by LDAP clients. It is
essential that the sources generated are checked to confirm
no problems have occurred.
Per entry comment fields, from existing source files, are
not merged into source files generated by ypmap2src. If a
user wishes N2L to maintain comment information, then the
NISLDAPmapping configuration file should be modified so that
the comment fields are mapped into LDAP. This will ensure
that the comments are visible to native LDAP clients and
present in the N2L map files.
SunOS 5.11 Last change: 10 Apr 2003 1
System Administration Commands ypmap2src(1M)
When ypmap2src is run, it will take up-to-date comments from
the map file and insert them into the NIS source file gen-
erated.
Handling Custom Maps
ypmap2src only knows about the standard NIS maps and stan-
dard source to map conversion. If an advanced user has
changed these, that is, the user has modified the NIS
makefile, the equivalent changes must also be made to the
ypmap2src script.
OPTIONS
ypmap2src supports the following options:
-c Specifies that custom-map-name should be
converted to a source file by run-
ning makedbm -u on it. This is a short cut
so that simple custom maps can be handled
without editing ypmap2src.
-d domain-name Specifies the domain to convert. The
domain-name can be a fully qualified file
path, such as /var/yp/a.b.c, or just a
domain name, a.b.c. In the latter
case, ypmaptosrc looks in /var/yp for the
domain directory.
-o dest Specifies the destination directory for
the converted files. A directory other
than /etc should be specified. The maps
generated are copied to the correct loca-
tion, /etc, /etc/security or other source
directory, as appropriate.
-t Specifies that traditional NIS maps,
without N2L's LDAP prefix, should be con-
verted. By default, maps with the LDAP
prefix are converted.
OPERANDS
ypmap2src supports the following operands:
source-file Lists the standard source files to convert.
If this option is not given, then all the
standard source files, plus any custom files
pecified by the -c option, are converted.
SunOS 5.11 Last change: 10 Apr 2003 2
System Administration Commands ypmap2src(1M)
ATRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
ATRIBUTE TYPE ATRIBUTE VALUE
Availability SUNWypu
Interface Stability Obsolete
SEE ALSO
ypmake(1M), ypserv(1M), NISLDAPmapping(4), attributes(5)
SunOS 5.11 Last change: 10 Apr 2003 3
|
