HP-UX Reference (11i v1 00/12) - 1 User Commands N-Z (vol 2)
__________________________________________________________________________________________________________________________________________________________________________________________________
__________________________________________________________________________________________________________________________________________________________________________________________________
STANDARD Printed by: Nora Chuang [nchuang] STANDARD
/build/1111/BRICK/man1/neqn.1
________________________________________________________________
___ ___
n
nisln(1) nisln(1)
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.Ifname is an indexed
name (see nismatch(1)), the link points to entries within an NIS+ table. Clients wishing to look up infor-
mation 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 execut-
ing 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- - -
.
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.
AUTHOR
nisln was developed by Sun Microsystems, Inc.
SEE ALSO
nisdefaults(1), nismatch(1), nisrm(1), nistbladm(1), nis_names(3N), nis_tables(3N).
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
HP-UX Release 11i: December 2000 − 1 − Section 1−−595
___
___