nisln(1) User Commands nisln(1)NAMEnisln - symbolically link NIS+ objects
SYNOPSISnisln [-L] [-D defaults] name linkname
DESCRIPTION
The nisln command links a NIS+ object named name to a NIS+ name
linkname. If name is an indexed name (see nismatch(1)), the link points
to entries within a NIS+ table. Clients wishing to look up information
in the name service can use the FOLLOW_LINKS flag to force the client
library to follow links to the name they point to. Further, all of the
NIS+ administration commands accept the -L switch indicating they
should follow links (see nis_names(3NSL) for a description of the FOL‐
LOW_LINKS flag).
When creating the link, nisln verifies that the linked object exists.
Once created, the linked object may be deleted or replaced and the link
will not be affected. At that time, the link will become invalid and
attempts to follow it will return NIS_LINKNAMEERROR to the client.
When the path attribute in tables specifies a link rather than another
table, the link will be followed if the flag FOLLOW_LINKS was present
in the call to nis_list() (see nis_tables(3NSL)) and ignored if the
flag is not present. If the flag is present and the link is no longer
valid, a warning is sent to the system logger and the link is ignored.
OPTIONS
The following options are supported:
-D defaults Specify a different set of defaults to be used for the
creation of the link object. The defaults string is a
series of tokens separated by colons. These tokens rep‐
resent the default values to be used for the generic
object properties. All of the legal tokens are
described below.
ttl=time
This token sets the default time to live for
objects that are created by this command. The value
time is specified in the format as defined by the
nischttl(1) command. The default is 12 hours.
owner=ownername
This token specifies that the NIS+ principal owner‐
name should own the created object. The default for
this value is the the principal who is executing
the command.
group=groupname
This token specifies that the group groupname
should be the group owner for the object that is
created. The default is NULL.
access=rights
This token specifies the set of access rights that
are to be granted for the given object. The value
rights is specified in the format as defined by the
nischmod(1) command. The default value is
−−−−rmcdr−−−r−−−.
-L When present, this option specifies that this command
should follow links. If name is itself a link, then
this command will follow it to the linked object that
it points to. The new link will point to that linked
object rather than to name.
EXAMPLES
Example 1: Creating a link
In this example, we create a link in the domain foo.com. named hosts
that points to the object hosts.bar.com.:
example% nisln hosts.bar.com. hosts.foo.com.
Example 2: Making a link that points to an entry in the hosts table
In this example, we make a link example.foo.com. that points to an
entry in the hosts table in eng.foo.com:
example% nisln '[name=example],hosts.eng.foo.com.' example.foo.com.
ENVIRONMENT VARIABLES
NIS_PATH If this variable is set, and the NIS+ name is not fully
qualified, each directory specified will be searched
until the object is found (see nisdefaults(1)).
EXIT STATUS
The following exit values are returned:
0 Successful operation.
1 Operation failed.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌─────────────────────────────┬─────────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├─────────────────────────────┼─────────────────────────────┤
│Availability │SUNWnisu │
└─────────────────────────────┴─────────────────────────────┘
SEE ALSOnisdefaults(1), nismatch(1), nisrm(1), nistbladm(1), nis_names(3NSL),
nis_tables(3NSL), attributes(5)NOTES
NIS+ might not be supported in future releases of the Solaris operating
system. Tools to aid the migration from NIS+ to LDAP are available in
the current Solaris release. For more information, visit
http://www.sun.com/directory/nisplus/transition.html.
SunOS 5.10 2 Dec 2005 nisln(1)