System Administration Commands                         fruadm(1M)



NAME
     fruadm - prints and updates customer  data  associated  with
     FRUs

SYNOPSIS
     /usr/platform/sun4u/sbin/fruadm


     /usr/platform/sun4u/sbin/fruadm -l


     /usr/platform/sun4u/sbin/fruadm [-r] path [text]


DESCRIPTION
     fruadm  prints  or  sets  the  customer  data   for   Field-
     Replaceable Units (FRUs).


     Without arguments, fruadm prints the paths of  all  FRU  ID-
     capable FRUs (containers) in the system, along with the con-
     tents of the customer data record, if present, for each such
     FRU;  for FRUs without customer data, fruadm prints only the
     container's path.


      Only a privileged user can create or update  data  in  con-
     tainers.  The  privileges  required  to  perform these write
     operations are hardware dependent. Typically, a default sys-
     tem   configuration   restricts   write  operations  to  the
     superuser or to the platform-administrator user.

OPTIONS
     The following options are supported:

     -l    List the system's frutree paths.


     -r    Recursively display or update the data  for  all  con-
           tainers rooted at the argument path.


OPERANDS
     The following operands are supported:

     path    A full or partial system frutree path for  or  under
             which  to  print or set the customer data. The first
             field of each line of output of fruadm -l gives  the
             valid full frutree paths for the system.

             Paths can include shell meta-characters; such  paths
             should be quoted appropriately for the user's shell.



SunOS 5.11          Last change: 22 Feb 2002                    1






System Administration Commands                         fruadm(1M)



             For partial paths, the first matching full  path  is
             selected  for  display  or  update.  Without  the -r
             option, the path must be that of a  container;  with
             the  -r  option,  all containers (if any) under path
             will be selected.


     text    Up to 80 characters of  text  set  as  the  customer
             data.  If  the  text  contains  white space or shell
             metacharacters, it should  be  quoted  appropriately
             for the user's shell.


EXAMPLES
     Example 1 Displaying All Customer Data


     The following example prints  all  customer  data  available
     from  FRUs  on  the  system. For containers with no customer
     data, only the containers' paths will be listed.


       example% fruadm



     Example 2 Displaying Customer Data For a Single FRU


     The following command prints the customer data, if  present,
     for the specified FRU:


       example% fruadm /frutree/chassis/system-board



     Example 3 Displaying Customer Data For a Single FRU


     The following command prints the customer data, if  present,
     for the first mem-module found:


       example% fruadm mem-module



     Example 4  Setting Customer Data






SunOS 5.11          Last change: 22 Feb 2002                    2






System Administration Commands                         fruadm(1M)



     The following example sets the customer data for a FRU:


       example# fruadm system-board 'Asset Tag 123456'



     Example 5 Setting Customer Data


     The following command sets the customer data  for  all  FRUs
     under chassis:


       example# fruadm -r /frutree/chassis "Property of XYZ, Inc."



EXIT STATUS
     The following exit values are returned:

     0     Successful completion.


     >0    An error occurred.


ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Availability                 SUNWfruip.u                 
    
     Interface Stability          Unstable                    
    


SEE ALSO
     prtfru(1M), attributes(5)











SunOS 5.11          Last change: 22 Feb 2002                    3