NAME
nisln — symbolically link NIS+ objects
SYNOPSIS
nisln
[
-L
] [
-D defaults
]
name
linkname
DESCRIPTION
The
nisln
command links an
NIS+
object named name to an
NIS+
name linkname.
If name is an indexed name (see
nismatch(1)),
the link points to entries within an
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(3N)
for a description of the
FOLLOW_LINKS
flag).
Options
- -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.
- -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.
- owner=ownername
This token specifies that the
NIS+
principal ownername 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---.
Notes
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(3N))
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.
EXAMPLES
Create a link in the domain
foo.com.
named
hosts
that points to the object
hosts.bar.com:
nisln hosts.bar.com. hosts.foo.com.
Make a link example.sun.com. that points to
an entry in the hosts table in eng.sun.com.:
nisln '[name=example],hosts.eng.sun.com.' example.sun.com:
EXTERNAL INFLUENCES
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)).
RETURN VALUE
nisln
returns
0
on success and
1
on failure.
WARNINGS
HP-UX 11i Version 2 is the last HP-UX release on which NIS+ is
supported.
LDAP is the recommended replacement for NIS+. HP fully supports
the industry standard naming services based on LDAP.
AUTHOR
nisln
was developed by Sun Microsystems, Inc.