1 kumpf 1.2 .\" $HEADER: $
  2           .TA o \" lowercase initial leter of .TH name
  3           .TH osinfo 1
  4           .SH NAME
  5           .PP
  6           osinfo \- gather information regarding the running operating system
  7           .SH SYNOPSIS
  8           \fB osinfo\fP  [ \fB-c\fP ]
  9           .SH DESCRIPTION
 10           .PP
 11           The 
 12           .B osinfo 
 13           command displays information regarding the operating system,
 14           gathered via WBEM using the PG_OperatingSystem class supported by the
 15           OperatingSystem Provider (bundled with HP WBEM Services).
 16           .B osinfo
 17           requires HP WBEM Services to be installed and running.
 18           .PP
 19           By default, the information is formatted for display, converting
 20           CIMDateTime strings into a more user-readable format (see Examples),
 21           and converting the total number of seconds of uptime into the 
 22 kumpf 1.2 appropriate number of days, hours, minutes, and seconds.
 23           .PP
 24           If a property value is unavailable, it will be shown as "Unknown"
 25           .SS Options
 26           .B osinfo
 27           recognizes the following options:
 28           .RS
 29           .TP 15
 30           .B -c
 31           Use the CIM formats for DateTime and SystemUpTime values (not
 32           the formatting done by default).
 33           As specified by the DMTF, the CIMDateTime format is 
 34           yyyymmddhhmmss.mmmmmmsutc, where yyyy is
 35           a 4-digit year, mm is the month, dd is the day, hh is the hour on a 24-hour
 36           clock, mm is the minute, ss is the second, mmmmmm is the number of
 37           microseconds, s is a "+" or "-" indicating the sign of the UTC
 38           (Universal Time Code) correction field (since the DateTime is returned in
 39           the local time zone of the system), and utc is the offset from UTC in
 40           minutes.
 41           .RE
 42           .SH EXIT STATUS
 43 kumpf 1.2 .PP
 44           When an error occurs, an error message is written to stderr and an
 45           appropriate value is returned.  The following values are returned:
 46           .RS
 47           .TP
 48           .B 0 
 49           Success
 50           .PD 0
 51           .TP
 52           .B 1
 53           Error
 54           .PD
 55           .RE
 56           .SH DIAGNOSTICS
 57           .PP
 58           .B "os info error: Cannot connect"
 59           .IP
 60           The CIMOM is not running.  Start the CIMOM with the
 61           .C cimserver
 62           command and re-run
 63           .B osinfo .
 64 kumpf 1.2 .SH EXAMPLES
 65           .PP
 66           Run the default 
 67           .B osinfo 
 68           command.
 69           .TP
 70           .PD 0
 71           .C osinfo
 72           
 73           .TP
 74           .B "OperatingSystem Information"
 75           .TP
 76           .B "  Host: rushmore.cup.hp.com "
 77           .TP
 78           .B "  Name: HP-UX "
 79           .TP
 80           .B "  Version: B.11.00 "
 81           .TP
 82           .B "  UserLicense: Unlimited user license "
 83           .TP
 84           .B "  OSCapability: 32 bit "
 85 kumpf 1.2 .TP
 86           .B "  LastBootTime: Sep 24, 2001  9:16:18 (-0700) "
 87           .TP
 88           .B "  LocalDateTime: May 23, 2002  10:55:54 (-0700) "
 89           .TP
 90           .B "  SystemUpTime: 20828377 seconds = 241 days, 1 hr, 39 mins, 37 secs  "
 91           .PD
 92           .PP
 93           The system rushmore.cup.hp.com is running version B.11.00 of HP-UX,
 94           has an unlimited user license, and is 32-bit capable.  The Operating
 95           System was last booted on Sept 24, 2001 and the local date and time
 96           are given.  All time values are offset from GMT by -7 hours.
 97           .PP
 98           Run 
 99           .B osinfo ,
100           with the values displayed in their CIM format
101           .TP
102           .PD 0
103           .B "osinfo -c"
104           
105           .TP
106 kumpf 1.2 .B "OperatingSystem Information"
107           .TP
108           .B "  Host: rushmore.cup.hp.com"
109           .TP
110           .B "  Name: HP-UX"
111           .TP
112           .B "  Version: B.11.00"
113           .TP
114           .B "  UserLicense: Unlimited user license"
115           .TP
116           .B "  OSCapability: 32 bit"
117           .TP
118           .B "  LastBootTime: 20010924091618.000000-420"
119           .TP
120           .B "  LocalDateTime: 20020523105801.000000-420"
121           .TP
122           .B "  SystemUpTime: 20828504"
123           .PD
124           .PP
125           The same rushmore.cup.hp.com system is displayed, but in this output the
126           LastBootTime and LocalDateTime values are in the CIM format.  The SystemUpTime
127 kumpf 1.2 value is in total seconds (as specified by CIM).  Other fields do not change,
128           as their CIM specification is the strings themselves.
129           .SH SEE ALSO
130           .PP
131           cimserver(1).
132           .SH STANDARDS CONFORMANCE
133           .PP
134           \fBosinfo\fP : DMTF WBEM (Web-Based Enterprise Management) and CIM 
135           (Common Information Model)