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