NIFIND(1)                                               NIFIND(1)



NAME
       nifind - find a directory in the NetInfo hierarchy

SYNOPSIS
       nifind [ -anvp ] [ -t timeout ] directory [ domain ]

DESCRIPTION
       nifind  searches  for  the  named directory in the NetInfo
       hierarchy.  It starts at the local domain  and  climbs  up
       through  the  hierarchy  until it reaches the root domain.
       Any occurrences of directory are reported by directory  ID
       number.   If  the  optional domain argument is given, then
       nifind stops climbing at that point in the hierarchy.  The
       domain  argument must be specified by an absolute or rela-
       tive domain name.

       When invoked with the -a option, nifind searches  for  the
       named  directory  in  the entire NetInfo hierarchy (or the
       subtree with domain as the root if domain  is  specified).
       The -n option exempts local domains from the search.

       nifind  uses  a default two second connection timeout when
       contacting a domain.  The connection timeout can be  over-
       ridden with the -t option.


OPTIONS
       -a     Search  for directory in the entire NetInfo hierar-
              chy.

       -n     Exempt local directories from the search.

       -p     Print directory contents.

       -t timeout
              Specify an integer value as the connection  timeout
              (in seconds).

       -v     Produce verbose output.

EXAMPLES
       % nifind /printers/inky
       /printers/inky found in /software, id = 202
       /printers/inky found in /, id = 357

       % nifind  -a /machines/mailhost /sales
       /machines/mailhost found in /sales, id = 234

       % nifind -v /users/uid=164
       /users/uid=164 not found in /sales/polaris
       /users/uid=164 not found in /sales
       /users/uid=164 found in /, id = 451

       % nifind -p /machines/mailhost
       /machines/mailhost found in /sales, id=171
       name: zippy mailhost
       ip_address: 192.42.172.5

       /machines/mailhost found in /, id = 350
       name:  zorba mailhost
       ip_address: 192.42.172.1

SEE ALSO
       netinfo(5)

AUTHOR
       Marc Majka, Apple Computer Inc.

BUGS
       nifind  does  not  complain  if  domain is not an ancestor
       specified in a normal search.



Apple Computer, Inc.      August 9, 1994                NIFIND(1)