ypmap2src(1M) System Administration Commands ypmap2src(1M)NAMEypmap2src - 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 approxima‐
tions 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 dis‐
cover the contents of NIS maps for which the sources are not available.
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
converted to LDAP, and the NIS service suspended.
The ypmap2src utility does not guarantee that the files that are gener‐
ated 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 prob‐
lems 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 main‐
tain 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.
When ypmap2src is run, it will take up-to-date comments from the map
file and insert them into the NIS source file generated.
Handling Custom Maps
ypmap2src only knows about the standard NIS maps and standard 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.
OPTIONSypmap2src supports the following options:
-c Specifies that custom-map-name should be converted to
a source file by running 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 con‐
verted files. A directory other than /etc should be
specified. The maps generated are copied to the cor‐
rect location, /etc, /etc/security or other source
directory, as appropriate.
-t Specifies that traditional NIS maps, without N2L's
LDAP_ prefix, should be converted. By default, maps
with the LDAP_ prefix are converted.
OPERANDSypmap2src 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.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌─────────────────────────────┬─────────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├─────────────────────────────┼─────────────────────────────┤
│Availability │service/network/nis │
├─────────────────────────────┼─────────────────────────────┤
│Interface Stability │Obsolete │
└─────────────────────────────┴─────────────────────────────┘
SEE ALSOypmake(1M), ypserv(1M), NISLDAPmapping(4), attributes(5)SunOS 5.11 10 Apr 2003 ypmap2src(1M)