xref: /illumos-gate/usr/src/man/man8/inityp2l.8 (revision bbf21555)
te
Copyright (C) 2003, Sun Microsystems, Inc. All Rights Reserved
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.
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.
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]
INITYP2L 8 "Apr 10, 2003"
NAME
inityp2l - create NIS (YP) to LDAP configuration files
SYNOPSIS

/usr/lib/netsvc/yp/inityp2l [-m mapping_file_name]
 [-c config_file_name]
DESCRIPTION

The inityp2l utility assists with creation of the NISLDAPmapping and ypserv files. See NISLDAPmapping(5) and ypserv(5). inityp2l examines the NIS maps on a system. and through a dialogue with the user, determines which NIS to (and from) LDAP mappings are required. A NISLDAPmapping file is then created based on this information. The utility asks users about their LDAP server configuration and a ypserv file is created based on this information.

The inityp2l utility handles mappings for standard NIS maps and the auto.* series of maps. If requested, it creates default mappings for custom maps, with each map entry represented as a single DIT string. inityp2l does not handle full custom mapping, but if requested, inityp2l will insert comments into the NISLDAPmapping file that indicate where these should be added.

To write to the NISLDAPmapping or ypserv files is potentially dangerous. inityp2l warns the user and asks for confirmation before:

1. it overwrites either file

2. it writes to the default NISLDAPmapping file location, if this file did not previously exist. This is important because the existence of a file in this location causes NIS components to work NIS to LDAP (N2L) mode when next restarted, rather than to traditional NIS mode.

inityp2l assists with rapid creation of a simple N2L configuration files. It is not a general purpose tool for the management of these files. An advanced user who would like to maintain the files or use custom mappings should examine the output of inityp2l and customize it by using a standard text editor.

OPTIONS

inityp2l supports the following options: -c

Specify the name of the generated ypserv file. The default location is described in .

-m

Specify the name of the generated NISLDAPmapping file. The default is described in .

FILES
/var/yp

The directory to be searched for candidate domains (/var/yp/*) and NIS maps (/var/yp/*/*)

/var/yp/NISLDAPmapping

The default location for the generated NISLDAPmapping file

/etc/default/ypserv

The default location for the generated ypserv file

ATTRIBUTES

See attributes(7) for descriptions of the following attributes:

ATTRIBUTE TYPE ATTRIBUTE VALUE
Interface Stability Obsolete
SEE ALSO

NISLDAPmapping (5), ypserv (5), attributes (7)