prtfru(1M) System Administration Commands prtfru(1M)NAME
prtfru - print FRUID-specific information about the FRUs on a system or domain
SYNOPSIS
/usr/sbin/prtfru [-d] | [-clx] [container]
DESCRIPTION
The prtfru utility is used to obtain FRUID data from the system or domain. Its output is that of a tree structure echoing the path in the
FRU (Field-Replaceable Unit) tree to each container. When a container is found, the data from that container is printed in a tree-like
structure as well.
prtfru without any arguments will print the FRU hierarchy and all of the FRUID container data. prtfru prints to stdout which may be redi-
rected to a file.
OPTIONS
The following options are supported:
-c Prints only the containers and their data. This option does not print the FRU tree hierarchy.
-d Prints a DTD for the current registry to stdout.
-l Prints only the FRU tree hierarchy. This option does not print the container data.
-x Prints in XML format with a system identifier (SYSTEM) of prtfrureg.dtd.
Options -c and -l can be used together to obtain a list of the containers.
OPERANDS
The folowing operand is supported:
container The name of a particular container in the FRU hierarchy, that is, either the name or path/name of a container as displayed
in the -l option.
EXIT STATUS
The following exit values are returned:
0 All information was found and printed successfully.
>0 An error has occurred.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
+-----------------------------+-----------------------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+-----------------------------+-----------------------------+
|Availability |SUNWfruid |
+-----------------------------+-----------------------------+
SEE ALSO fruadm(1M), attributes(5)SunOS 5.10 30 May 2002 prtfru(1M)
Check Out this Related Man Page
fruadm(1M) 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 contents 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 containers. The privileges required to perform these write operations are hardware
dependent. Typically, a default system 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 containers 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. For par-
tial 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 contain-
ers' 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
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.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
+-----------------------------+-----------------------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+-----------------------------+-----------------------------+
|Availability |SUNWfruip.u |
+-----------------------------+-----------------------------+
|Interface Stability |Unstable |
+-----------------------------+-----------------------------+
SEE ALSO prtfru(1M), attributes(5)SunOS 5.10 22 Feb 2002 fruadm(1M)