usr/src/man/man1m/inityp2l.1m

   1 '\" te
   2 .\" Copyright (C) 2003, Sun Microsystems, Inc. All Rights Reserved
   3 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
   4 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
   5 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
   6 .TH INITYP2L 1M "Apr 10, 2003"
   7 .SH NAME
   8 inityp2l \- create NIS (YP) to LDAP configuration files
   9 .SH SYNOPSIS
  10 .LP
  11 .nf
  12 \fB/usr/lib/netsvc/yp/inityp2l\fR [\fB-m\fR \fImapping_file_name\fR]
  13      [\fB-c\fR \fIconfig_file_name\fR]
  14 .fi
  15
  16 .SH DESCRIPTION
  17 .sp
  18 .LP
  19 The \fBinityp2l\fR utility assists with creation of the \fBNISLDAPmapping\fR
  20 and \fBypserv\fR files. See \fBNISLDAPmapping\fR(4) and\fBypserv\fR(4).
  21 \fBinityp2l\fR examines the NIS maps on a system. and through a dialogue with
  22 the user, determines which NIS to (and from) LDAP mappings are required. A
  23 \fBNISLDAPmapping\fR file is then created based on this information. The
  24 utility asks users about their LDAP server configuration and a \fBypserv\fR
  25 file is created based on this information.
  26 .sp
  27 .LP
  28 The \fBinityp2l\fR utility handles mappings for standard NIS maps and the
  29 \fBauto.*\fR series of maps. If requested, it creates default mappings for
  30 custom maps, with each map entry represented as a single DIT string.
  31 \fBinityp2l\fR does not handle full custom mapping, but if requested,
  32 \fBinityp2l\fR will insert comments into the \fBNISLDAPmapping\fR file that
  33 indicate where these should be added.
  34 .sp
  35 .LP
  36 To write to the \fBNISLDAPmapping\fR or \fBypserv\fR files is potentially
  37 dangerous. \fBinityp2l\fR warns the user and asks for confirmation before:
  38 .RS +4
  39 .TP
  40 1.
  41 it overwrites either file
  42 .RE
  43 .RS +4
  44 .TP
  45 2.
  46 it writes to the default \fBNISLDAPmapping\fR file location, if this file
  47 did not previously exist. This is important because the existence of a file in
  48 this location causes NIS components to work NIS to LDAP (N2L)  mode when next
  49 restarted, rather than to traditional NIS mode.
  50 .RE
  51 .sp
  52 .LP
  53 \fBinityp2l\fR assists with rapid creation of a simple N2L configuration files.
  54 It is not a general purpose tool for the management of these files. An
  55 advanced user who would like to maintain the files or use custom mappings
  56 should examine the output of \fBinityp2l\fR and customize it by using a
  57 standard text editor.
  58 .SH OPTIONS
  59 .sp
  60 .LP
  61 \fBinityp2l\fR supports the following options:
  62 .sp
  63 .ne 2
  64 .na
  65 \fB\fB-c\fR\fR
  66 .ad
  67 .RS 6n
  68 Specify the name of the generated \fBypserv\fR file. The default location is
  69 described in .
  70 .RE
  71
  72 .sp
  73 .ne 2
  74 .na
  75 \fB\fB-m\fR\fR
  76 .ad
  77 .RS 6n
  78 Specify the name of the generated \fBNISLDAPmapping\fR file. The default is
  79 described in .
  80 .RE
  81
  82 .SH FILES
  83 .sp
  84 .ne 2
  85 .na
  86 \fB\fB/var/yp\fR \fR
  87 .ad
  88 .RS 26n
  89 The directory to be searched for candidate domains (\fB/var/yp/*\fR) and NIS
  90 maps (\fB/var/yp/*/*\fR)
  91 .RE
  92
  93 .sp
  94 .ne 2
  95 .na
  96 \fB\fB/var/yp/NISLDAPmapping\fR\fR
  97 .ad
  98 .RS 26n
  99 The default location for the generated \fBNISLDAPmapping\fR file
 100 .RE
 101
 102 .sp
 103 .ne 2
 104 .na
 105 \fB\fB/etc/default/ypserv\fR\fR
 106 .ad
 107 .RS 26n
 108 The default location for the generated \fBypserv\fR file
 109 .RE
 110
 111 .SH ATTRIBUTES
 112 .sp
 113 .LP
 114 See \fBattributes\fR(5) for descriptions of the following attributes:
 115 .sp
 116
 117 .sp
 118 .TS
 119 box;
 120 c | c
 121 l | l .
 122 ATTRIBUTE TYPE  ATTRIBUTE VALUE
 123 _
 124 Interface Stability     Obsolete
 125 .TE
 126
 127 .SH SEE ALSO
 128 .sp
 129 .LP
 130 \fBNISLDAPmapping\fR(4), \fBypserv\fR(4), \fBattributes\fR(5)