usr/src/man/man1m/prtdiag.1m

   1 '\" te
   2 .\"  Copyright 1989 AT&T Copyright (c) 2008, Sun Microsystems, Inc. All Rights Reserved
   3 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
   4 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
   5 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
   6 .TH PRTDIAG 1M "Sep 2, 2008"
   7 .SH NAME
   8 prtdiag \- display system diagnostic information
   9 .SH SYNOPSIS
  10 .LP
  11 .nf
  12 \fB/usr/sbin/prtdiag\fR [\fB-v\fR] [\fB-l\fR]
  13 .fi
  14
  15 .SH DESCRIPTION
  16 .sp
  17 .LP
  18 \fBprtdiag\fR displays system configuration and diagnostic information on
  19 \fBsun4u\fR, \fBsun4v\fR, and x86 systems.
  20 .sp
  21 .LP
  22 The diagnostic information lists any failed field replaceable units
  23 (\fBFRU\fRs) in the system.
  24 .sp
  25 .LP
  26 The interface, output, and location in the directory hierarchy for
  27 \fBprtdiag\fR are uncommitted and subject to change in future releases.
  28 .sp
  29 .LP
  30 \fBprtdiag\fR does not display diagnostic information and environmental status
  31 when executed on the Sun Enterprise 10000 server. See the
  32 \fB/var/opt/SUNWssp/adm/${SUNW_HOSTNAME}/messages\fR file on the system service
  33 processor (SSP) to obtain such information for this server.
  34 .SH OPTIONS
  35 .sp
  36 .LP
  37 The following options are supported:
  38 .sp
  39 .ne 2
  40 .na
  41 \fB\fB-l\fR\fR
  42 .ad
  43 .RS 6n
  44 Log output. If failures or errors exist in the system, output this information
  45 to \fBsyslogd\fR(1M) only.
  46 .RE
  47
  48 .sp
  49 .ne 2
  50 .na
  51 \fB\fB-v\fR\fR
  52 .ad
  53 .RS 6n
  54 Verbose mode. Displays the time of the most recent \fBAC\fR Power failure, and
  55 the most recent hardware fatal error information, and (if applicable)
  56 environmental status. The hardware fatal error information is useful to repair
  57 and manufacturing for detailed diagnostics of \fBFRU\fRs.
  58 .RE
  59
  60 .SH EXIT STATUS
  61 .sp
  62 .LP
  63 The following exit values are returned:
  64 .sp
  65 .ne 2
  66 .na
  67 \fB\fB0\fR\fR
  68 .ad
  69 .RS 5n
  70 No failures or errors are detected in the system.
  71 .RE
  72
  73 .sp
  74 .ne 2
  75 .na
  76 \fB\fB1\fR\fR
  77 .ad
  78 .RS 5n
  79 Failures or errors are detected in the system.
  80 .RE
  81
  82 .sp
  83 .ne 2
  84 .na
  85 \fB\fB2\fR\fR
  86 .ad
  87 .RS 5n
  88 An internal \fBprtdiag\fR error occurred, for example, out of memory.
  89 .RE
  90
  91 .SH ATTRIBUTES
  92 .sp
  93 .LP
  94 See \fBattributes\fR(5) for descriptions of the following attributes:
  95 .sp
  96
  97 .sp
  98 .TS
  99 box;
 100 c | c
 101 l | l .
 102 ATTRIBUTE TYPE  ATTRIBUTE VALUE
 103 _
 104 Interface Stability     Unstable*
 105 .TE
 106
 107 .sp
 108 .LP
 109 *The output is unstable.
 110 .SH SEE ALSO
 111 .sp
 112 .LP
 113 \fBmodinfo\fR(1M), \fBprtconf\fR(1M), \fBpsrinfo\fR(1M), \fBsysdef\fR(1M),
 114 \fBsyslogd\fR(1M), \fBattributes\fR(5), \fBopenprom\fR(7D)
 115 .SH NOTES
 116 .sp
 117 .LP
 118 Not all diagnostic and system information is available on every Solaris
 119 platform, and therefore cannot be displayed by \fBprtdiag\fR. On those
 120 platforms, further information can be obtained from the System Controller.