attrlist man page on HP-UX

Man page or keyword search:  
man Server   10987 pages
apropos Keyword Search (all sections)
Output format
HP-UX logo
[printable version]

attrlist(1m)							  attrlist(1m)

NAME
       attrlist - A dcecp task object that manipulates attribute lists

SYNOPSIS
       attrlist add attrlist -member attrlist

       attrlist getvalues attrlist -type typename

       attrlist help [operation | -verbose]

       attrlist list attrlist

       attrlist	  modify   attrlist  {[-add  attribute_type  attribute_values]
       [-change	 attribute_type	 attribute_values]   [-remove	attribute_type
       attribute_values]}

       attrlist operations

       attrlist remove attrlist -member attrlist

ARGUMENTS
       A  list	of  one	 or  more dcecp elements.  An attrlist can be a single
       character, but usually consists of at least one attribute type and  its
       value,  as shown in the following: {CDS_Convergence medium} The name of
       the attrlist operation for which to display help information.

DESCRIPTION
       The attrlist task object represents an attribute list  as  returned  or
       accepted	 by  many dcecp commands.  Use this object to check or manipu‐
       late attribute lists so that they can be used by other  commands,  most
       commonly in scripts.

OPERATIONS
   attrlist add
       Appends	one  attribute	list  to  another.   The syntax is as follows:
       attrlist add attrlist -member attrlist

       The add operation returns an attribute list with the attributes	speci‐
       fied as the value of the required -member option appended.

       Privileges Required

       No special privileges are needed to use the attrlist add command.

       Examples

       dcecp>  attrlist add {{a b} {c d}} -member {{e f} {g h}} {a b} {c d} {e
       f} {g h} dcecp>

   attrlist getvalues
       Returns the values of the attributes named in an attribute  list.   The
       syntax is as follows: attrlist getvalues attrlist -type typename

       The  getvalues  operation returns the values of all attributes that are
       both named in the attribute list and  of	 the  type  specified  by  the
       required	 -type	option.	  The  value  can be a single type, but if the
       attribute appears more than once in the attribute list,	the  value  of
       each instance is returned on a separate line.

       Privileges Required

       No special privileges are needed to use the attrlist getvalues command.

       Examples

       dcecp> attrlist getvalues {{a w x} {c y} {a z}] -type a {w x} z dcecp>

       This  command can be used to filter the output of show operations.  For
       example: dcecp> attrlist getvalues [dir show /.:/hosts]	-type  CDS_UTS
       1994-07-01-10:29:59.265-05:00I0.000/00-00-c0-f7-de-56 dcecp>

       With  abbreviations,  the  above	 command  could be entered as follows:
       dcecp>	  at	 g     [dir	show	 /.:/hosts]	-t     CDS_UTS
       1994-07-01-10:29:59.265-05:00I0.000/00-00-c0-f7-de-56 dcecp>

   attrlist help
       Returns	help information about the attrlist task object and its opera‐
       tions.  The syntax is as follows: attrlist help [operation | -verbose]

       Options Displays information about the attrlist task object.

       Used without an argument or option, the attrlist help  command  returns
       brief  information  about each attrlist operation.  The optional opera‐
       tion argument is the name of an operation about which you want detailed
       information.   Alternatively,  you can use the -verbose option for more
       detailed information about the attrlist task object itself.

       Privileges Required

       No special privileges are needed to use the attrlist help command.

       Examples

       dcecp> attrlist help add			Adds  attributes  to  a	 list.
       getvalues	    Returns  the values of specified attributes.  list
       Returns	 the   attribute   types   present   in	  a   list.	modify
       Modifies	 an  attribute	list.	remove		    Removes attributes
       from a list.  help		  Prints  a  summary  of  command-line
       options.	  operations	       Returns	a list of the valid operations
       for this command.  dcecp>

   attrlist list
       Returns a list of attribute type names from  an	attribute  list.   The
       syntax is as follows: attrlist list attrlist

       The  list  operation  returns a list of all the attribute type names in
       the attribute list in the order that they appear in the list.

       Privileges Required

       No special privileges are needed to use the attrlist list command.

       Examples

       dcecp> attrlist list {{a b} {c d}} a c dcecp>

   attrlist modify
       Removes and changes attributes and their values in an  attribute	 list.
       The   syntax   is   as	follows:   attrlist   modify  attrlist	{[-add
       attribute_type attribute_values] [-change attribute_type attribute_val‐
       ues] [-remove attribute_type attribute_values]}

       The   modify  operation	returns	 an  attribute	list  with  the	 input
       attributes modified as specified	 by  the  -add,	 -remove  and  -change
       options.	  New attributes can be added, or new values added to existing
       attributes with -add.  Entire attributes or  attribute  values  can  be
       removed	with  -remove.	 The -change option removes all values from an
       existing attribute and replaces them with new values specified.

       Privileges Required

       No special privileges are needed to use the attrlist modify command.

       Examples

       dcecp> attrlist modify {{a b} {c d}} -add {{c e}} {a b} {c d e}	dcecp>
       dcecp>  attrlist	 modify	 {{a  b}  {c d e}} -remove {{c e}} {a b} {c d}
       dcecp> dcecp> attrlist modify {{a b} {c d e}} -change {{c f}} {a b}  {c
       f} dcecp>

   attrlist operations
       Returns a list of the operations supported by the attrlist task object.
       The syntax is as follows: attrlist operations

       The list of available operations is in alphabetical  order  except  for
       help and operations, which are listed last.

       Privileges Required

       No  special  privileges	are needed to use the attrlist operations com‐
       mand.

       Examples

       dcecp> attrlist operations add getvalues list modify remove help opera‐
       tions dcecp>

   attrlist remove
       Removes attributes and their values from an attribute list.  The syntax
       is as follows: attrlist remove attrlist -member attrlist

       The remove operation returns an attribute list after removing attribute
       types  (and  their  values)  specified  as  an argument to the required
       -member option.

       This command removes entire attributes only; to remove specific values,
       use the attrlist modify command.

       Privileges Required

       No special privileges are needed to use the attrlist remove command.

       Examples

       dcecp> attrlist remove {{a b} {c d} {e f} {g h}} -member {e g} {a b} {c
       d} dcecp>

RELATED INFORMATION
       Commands: dcecp(1m).

								  attrlist(1m)
[top]

List of man pages available for HP-UX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net