User Commands nisln(1)
NAME
nisln - symbolically link NIS] objects
SYNOPSIS
nisln [-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 FOLOWLINKS 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 nisnames(3NSL) for a description
of the FOLOWLINKS 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 fol-
low it will return NISLINKNAMEROR to the client. When
the path attribute in tables specifies a link rather than
another table, the link will be followed if the flag
FOLOWLINKS was present in the call to nislist() (see
nistables(3NSL)) and ignored if the flag is not present. If
the flag is present and the link is no longer valid, a warn-
ing 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 represent
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.
SunOS 5.11 Last change: 2 Dec 2005 1
User Commands nisln(1)
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 NUL.
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
SunOS 5.11 Last change: 2 Dec 2005 2
User Commands nisln(1)
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
NISPATH 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.
ATRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
ATRIBUTE TYPE ATRIBUTE VALUE
Availability SUNWnisu
SEE ALSO
nisdefaults(1), nismatch(1), nisrm(1), nistbladm(1),
nisnames(3NSL), nistables(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.11 Last change: 2 Dec 2005 3
|
