rpc.nisd(1M)
NAME
rpc.nisd, nisd - NIS+ service daemon
SYNOPSIS
/usr/sbin/rpc.nisd [-ACDFhlv] [ -Y [ -B [-t netid]]] [-
d dictionary] [-L load] [-S level] [-m mappingfile] [-
x attribute=value]... [-z number]
DESCRIPTION
The rpc.nisd daemon is an RPC service that implements the
NIS+ service. This daemon must be running on all machines
that serve a portion of the NIS+ namespace.
rpc.nisd is usually started from a system startup script.
The -B option causes rpc.nisd to start an auxiliary process,
rpc.nisd_resolv, which provides ypserv compatible DNS for-
warding for NIS host requests. rpc.nisd_resolv can also be
started independently. See rpc.nisd_resolv(1M) for more
information on using rpc.nisd_resolv independently.
The /etc/default/rpc.nisd file contains the following
default parameter settings. See FILES.
ENABLE_NIS_YP_EMULATION
Specifies whether the server is put into NIS (YP) com-
patibility mode. ENABLE_NIS_YP_EMULATION=YES is
equivalent to the -Y command-line option. The default
value for ENABLE_NIS_YP_EMULATION is NO.
OPTIONS
-A Authentication verbose mode. The daemon logs all the
authentication related activities to syslogd(1M) with
LOG_INFO priority.
-B Provide ypserv compatible DNS forwarding for NIS host
requests. The DNS resolving process,
rpc.nisd_resolv, is started and controlled by
rpc.nisd. This option requires that the
/etc/resolv.conf file be setup for communication with
a DNS nameserver. The nslookup utility can be used to
verify communication with a DNS nameserver. See
resolv.conf(4) and nslookup(1M).
-C Open diagnostic channel on /dev/console.
-D Debug mode. Do not fork.
-d dictionary
Specify an alternate dictionary for the NIS+ database.
The primary use of this option is for testing. Note
that the string is not interpreted, rather it is
simply passed to the db_initialize function.>
-F Force the server to do a checkpoint of the database
when it starts up. Forced checkpoints may be required
when the server is low on disk space. This option
removes updates from the transaction log that have
propagated to all of the replicas.
-h Print list of options.
-L number
Specify the ``load'' the NIS+ service is allowed to
place on the server. The load is specified in terms of
the number of child processes that the server may
spawn. The value of number must be at least 1 for the
callback functions to work correctly. The default is
128.
-m mappingfile
Specify the name of a configuration file that maps
NIS+ objects (especially tables and columns) to LDAP
(entries and attributes). See NIS+LDAPmapping(4). The
default path is /var/nis. The default mapping file is
NIS+LDAPmapping. If this file exists, the rpc.nisd
daemon will map data to and from LDAP. A template
mapping file that covers the normal NIS+ directories
and tables is installed as
/var/nis/NIS+LDAPmapping.template.
A NIS+ object must have a valid mapping entry in the
mapping file in order to have data for that table read
from or written to the LDAP repository.
The rpc.nisd(4) file contains specifications for LDAP
server addresses, LDAP authentication method, and the
like. See NIS+LDAPmapping(4) for an overview of the
setup you need to map NIS+ data to or from LDAP.
-S level
Set the authorization security level of the service.
The argument is a number between 0 and 2. By default,
the daemon runs at security level 2.
0 Security level 0 is designed to be used for
testing and initial setup of the NIS+
namespace. When running at level 0, the daemon
does not enforce any access controls. Any
client is allowed to perform any operation,
including updates and deletions.
1 At security level 1, the daemon accepts both
AUTH_SYS and AUTH_DES credentials for
authenticating clients and authorizing them to
perform NIS+ operations.
This is not a secure mode of operation since
AUTH_SYS credentials are easily forged. It
should not be used on networks in which any
untrusted users may potentially have access.
2 At security level 2, the daemon only accepts
authentication using the security mechanisms
configured by nisauthconf(1M). The default
security mechanism is AUTH_DES. Security level
2 is the default if the -S option is not used.
-t netid
Use netid as the transport for communication between
rpc.nisd and rpc.nisd_resolv. The default transport
is ticots(7D) ( tcp on SunOS 4.x systems).
-v Verbose. With this option, the daemon sends a running
narration of what it is doing to the syslog daemon
(see syslogd(1M)) at LOG_INFO priority. This option is
most useful for debugging problems with the service.
See also -A option.
-x attribute=value
Specify the value of the named attribute. Attributes
that control the NIS+ to LDAP mapping operation are
derived as follows:
1. Retrieve from LDAP.
2. Override with values from the mappingfile, if any.
See the -m option.
3. Override with values from the command line -x
options.
See NIS+LDAPmapping(4) and rpc.nisd(4) for the recognized
attributes and their syntax.
As a special case, you can use the nisplusLdapConfig*
attributes to derive additional information from LDAP.
You can only specify the nisplusLdapConfig* attributes
in rpc.nisd(4) or by means of the command line.
-Y Put the server into NIS (YP) compatibility mode. When
operating in this mode, the NIS+ server will respond
to NIS Version 2 requests using the version 2 proto-
col. Because the YP protocol is not authenticated,
only those items that have read access to nobody (the
unauthenticated request) will be visible through the
V2 protocol. It supports only the standard Version 2
maps in this mode (see -B option and NOTES in
ypfiles(4)). See FILES.
-z number
Specify the maximum RPC record size that can be used
over connection oriented transports. The default is
9000 bytes. If you specify a size less than the
default value, the default value will be used instead.
EXAMPLES
Example 1: Setting up the NIS+ Service
The following example sets up the NIS+ service.
example% rpc.nisd
Example 2: Setting Up NIS+ Service Emulating YP With DNS
Forwarding
The following example sets up the NIS+ service, emulating
YP with DNS forwarding.
example% rpc.nisd -YB
Example 3: Specifying NIS+ and LDAP Mapping Information
The following example shows how to specify that all addi-
tional NIS+ and LDAP mapping information should be retrieved
from DN "dc=x,dc=y,dc=z", from the LDAP server at IP address
1.2.3.4, port 389. The examples uses the simple authentica-
tion method and the cn=nisplusAdmin,ou=People, proxy user.
The -m option is omitted for clarity in this example..
-x nisplusLDAPconfigDN=dc=x,dc=y,dc=z \
-x nisplusLDAPconfigPreferredServerList=127.0.0.1:389 \
-x nisplusLDAPconfigAuthenticationMethod=simple \
-x nisplusLDAPconfigProxyUser=cn=nisplusAdmin,ou=People, \
-x nisplusLDAPconfigProxyPassword=xyzzy
ENVIRONMENT VARIABLES
NETPATH
The transports that the NIS+ service will use can be
limited by setting this environment variable. See
netconfig(4).
FILES
/var/nis/data/parent.object
This file describes the namespace that is logically
above the NIS+ namespace. The most common type of
parent object is a DNS object. This object contains
contact information for a server of that domain.
/var/nis/data/root.object
This file describes the root object of the NIS+
namespace. It is a standard XDR-encoded NIS+
directory object that can be modified by authorized
clients using the nis_modify(3NSL) interface.
/etc/init.d/rpc
Initialization script for NIS+.
/etc/default/rpc.nisd
LDAP connection and general rpc.nisd configuration.
You can override some of the settings by command-line
options.
/var/nis/nis+LDAPmapping
Default path for LDAP mapping file. See the discussion
of the -m option.
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Availability | SUNWnisu |
|_____________________________|_____________________________|
SEE ALSO
nis_cachemgr(1M), nisauthconf(1M), nisinit(1M),
nissetup(1M), nisldapmaptest(1M), nslookup(1M),
rpc.nisd_resolv(1M), rpc.nispasswdd(1M), syslogd(1M),
nis_modify(3NSL), NIS+LDAPmapping(4), netconfig(4), nis-
files(4), resolv.conf(4), rpc.nisd(4), ypfiles(4), attri-
butes(5), ticots(7D)
NOTES
NIS+ might not be supported in future releases of the
SolarisTM Operating Environment. Tools to aid the migration
from NIS+ to LDAP are available in the Solaris 9 operating
environment. For more information, visit
http://www.sun.com/directory/nisplus/transition.html.
Man(1) output converted with
man2html