unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (HP-UX-11.11)
Page:
Section:
Apropos / Subsearch:
optional field



 niscat(1)							   niscat(1)




 NAME
      niscat - display NIS+ tables and objects

 SYNOPSIS
      niscat [ -AhLMv ] tablename...

      niscat [ -ALMP ] -o name...

 DESCRIPTION
      In the first synopsis, niscat displays the contents of the NIS+ tables
      named by tablename.  In the second synopsis, it displays the internal
      representation of the NIS+ objects named by name.

    Options
      -A	Display the data within the table and all of the data in
		tables in the initial table's concatenation path.

      -h	Display the header line prior to displaying the table.	The
		header consists of the `#' (hash) character followed by the
		name of each column.  The column names are separated by the
		table separator character.

      -L	Follow links. When this option is specified, if tablename or
		name names a LINK type object, the link is followed and the
		object or table named by the link is displayed.

      -M	Master server only.  This option specifies that the request
		should be sent to the master server of the named data.	This
		guarantees that the most up-to-date information is seen at
		the possible expense of increasing the load on the master
		server and increasing the possibility of the NIS+ server
		being unavailable or busy for updates.

      -P	Follow concatenation path.  This option specifies that the
		request should follow the concatenation path of a table if
		the initial search is unsuccessful.  This option is only
		useful when using an indexed name for name and the -o
		option.

      -v	Display binary data directly.  This option displays columns
		containing binary data on the standard output.	Without this
		option, binary data is displayed as the string *BINARY*.

      -o name	Display the internal representation of the named NIS+
		object(s). If name is an indexed name (see nismatch(1)),
		then each of the matching entry objects is displayed.  This
		option is used to display access rights and other attributes
		of individual columns.

 EXAMPLES
      Display the contents of the hosts table:



 Hewlett-Packard Company	    - 1 -   HP-UX Release 11i: November 2000






 niscat(1)							   niscat(1)




	   niscat -h host.org_dir
	   # cname name	   addr		   comment
	   client1 client1 129.144.201.100 Joe Smith
	   crunchy crunchy 129.144.201.44  Jane Smith
	   crunchy softy   129.144.201.44

      The string *NP* is returned in those fields where the user has
      insufficient access rights.

      Display the passwd.org_dir on the standard output:

	   niscat passwd.org_dir

      Display the contents of table frodo and the contents of all tables in
      its concatenation path:

	   niscat -A frodo

      Display the entries in the table group.org_dir as NIS+ objects (note
      that the brackets are protected from the shell by single quotes):

	   niscat -o '[ ]group.org_dir'

      Display the table object of the passwd.org_dir table:

	   niscat -o passwd.org_dir

      The previous example displays the passwd table object and not the
      passwd table.  The table object includes information such as the
      number of columns, column type, searchable or not searchable,
      separator, access rights, and other defaults.

      Display the directory object for org_dir, which includes information
      such as the access rights and replica information:

	   niscat -o org_dir

 EXTERNAL INFLUENCES
    Environment Variables
      NIS_PATH	     If this variable is set and the NIS+ table name is not
		     fully qualified, each directory specified will be
		     searched until the table is found (see nisdefaults(1)).

 RETURN VALUE
      niscat returns 0 on success and 1 on failure.

 AUTHOR
      niscat was developed by Sun Microsystems, Inc.

 SEE ALSO
      nis+(1), nismatch(1), nistbladm(1), nisdefaults(1), nis_objects(3N),



 Hewlett-Packard Company	    - 2 -   HP-UX Release 11i: November 2000






 niscat(1)							   niscat(1)




      nis_tables(3N).

 NOTES
      Columns without values in the table are displayed by two adjacent
      separator characters.

















































 Hewlett-Packard Company	    - 3 -   HP-UX Release 11i: November 2000