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.

     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 running makedbm -u on it. This
           is a short cut so that simple custom maps can be  han-
           dled 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 speci-
           fied. The maps generated are  copied  to  the  correct
           location,  /etc,  /etc/security or other source direc-
           tory, 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.


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.


ATTRIBUTES

     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWypu                     |
    |_____________________________|_____________________________|
    | Interface Stability         | Obsolete                    |
    |_____________________________|_____________________________|


SEE ALSO

     ypmake(1M), ypserv(1M), NISLDAPmapping(4), attributes(5)

     System Administration Guide: Naming and  Directory  Services
     (DNS, NIS, and LDAP)


Man(1) output converted with man2html