FRUADM(8) Maintenance Procedures FRUADM(8)
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
prints or sets the customer data for Field-Replaceable Units
Without arguments, fruadm
prints the paths of all FRU ID
(containers) in the system, along with the contents of the customer data
record, if present, for each such FRU
; for FRU
s 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.
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
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 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
option, all containers (if any) under path
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.
Example 1: Displaying All Customer Data
The following example prints all customer data available from FRU
s on the
system. For containers with no customer data, only the containers' paths
will be listed.
Example 2: Displaying Customer Data For a Single FRU
The following command prints the customer data, if present, for the
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
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 FRU
s under chassis
example# fruadm -r /frutree/chassis "Property of XYZ, Inc."
The following exit values are returned: 0
Successful completion. >0
An error occurred.
for descriptions of the following attributes:
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|Interface Stability | Unstable |
SEE ALSO attributes(7)
February 22, 2002 FRUADM(8)