version 1.3, 2004/08/31 07:11:08
|
version 1.4, 2004/11/23 11:36:42
|
|
|
.\" $HEADER: $ |
.\" $Header$ |
.TA o \" lowercase initial leter of .TH name |
.\" .TA w \" lowercase initial letter of .TH name |
.TH osinfo 1 |
.TH "osinfo" "1" "" "" "" |
.SH NAME |
.SH "NAME" |
.PP | .PP |
osinfo \- gather information regarding the running operating system | osinfo \- gather information regarding the running operating system |
.SH SYNOPSIS |
.SH "SYNOPSIS" |
\fB osinfo\fP [ \fB-c\fP ] |
\fBosinfo\fP [ \fB\-s\fP ] [ \fB\-h\fP hostname ] [ \fB\-p\fP portnumber ] |
.SH DESCRIPTION |
[ \fB\-u\fP username ] [ \fB\-w\fP password ] [ \fB\-t\fP timeout ] |
|
[ \fB\-c\fP ] [ \fB\-\-help\fP ] [ \fB\-\-version\fP ] |
|
.SH "DESCRIPTION" |
.PP | .PP |
The | The |
.B osinfo | .B osinfo |
|
|
requires the CIM Server to be installed and running. | requires the CIM Server to be installed and running. |
.PP | .PP |
By default, the information is formatted for display, converting | By default, the information is formatted for display, converting |
CIMDateTime strings into a more user-readable format (see Examples), |
CIMDateTime strings into a more user\-readable format (see Examples), |
and converting the total number of seconds of uptime into the | and converting the total number of seconds of uptime into the |
appropriate number of days, hours, minutes, and seconds. | appropriate number of days, hours, minutes, and seconds. |
.PP | .PP |
|
|
recognizes the following options: | recognizes the following options: |
.RS | .RS |
.TP 15 | .TP 15 |
.B -c |
.B \-c |
Use the CIM formats for DateTime and SystemUpTime values (not | Use the CIM formats for DateTime and SystemUpTime values (not |
the formatting done by default). | the formatting done by default). |
As specified by the DMTF, the CIMDateTime format is | As specified by the DMTF, the CIMDateTime format is |
yyyymmddhhmmss.mmmmmmsutc, where yyyy is | yyyymmddhhmmss.mmmmmmsutc, where yyyy is |
a 4-digit year, mm is the month, dd is the day, hh is the hour on a 24-hour |
a 4\-digit year, mm is the month, dd is the day, hh is the hour on a 24\-hour |
clock, mm is the minute, ss is the second, mmmmmm is the number of | clock, mm is the minute, ss is the second, mmmmmm is the number of |
microseconds, s is a "+" or "-" indicating the sign of the UTC |
microseconds, s is a "+" or "\-" indicating the sign of the UTC |
(Universal Time Code) correction field (since the DateTime is returned in | (Universal Time Code) correction field (since the DateTime is returned in |
the local time zone of the system), and utc is the offset from UTC in | the local time zone of the system), and utc is the offset from UTC in |
minutes. | minutes. |
|
.TP |
|
\fB\-h\fP hostname |
|
Connect to the CIM Server on the specified host. |
|
If this option is not specified, |
|
.B osinfo |
|
connects to the localhost. |
|
.TP |
|
.B \-\-help |
|
Display command usage information. |
|
.TP |
|
\fB\-p\fP portnumber |
|
Connect to the CIM Server on the specified port number. |
|
If this option is not specified, |
|
.B osinfo |
|
connects to the default port for the wbem\-http service, or if the |
|
.B \-s |
|
option is specified, to the default port for the wbem\-https service. |
|
.TP |
|
.B \-s |
|
Enable the use of the SSL protocol between |
|
.B osinfo |
|
and the CIM server. |
|
The |
|
.B \-s |
|
option should be specified if the CIM Server |
|
on the specified hostname/portnumber expects clients to connect using HTTPS. |
|
.TP |
|
\fB\-t\fP timeout |
|
Wait the specified number of milliseconds on sending a request, before timing out if no response has been received. The |
|
.I timeout |
|
value must be an integer value greater than 0. |
|
.TP |
|
\fB\-u\fP username |
|
Connect as the specified |
|
.I R username . |
|
If |
|
.I username |
|
is not specified, the current logged in user is used for authentication. |
|
This option is ignored if neither |
|
.I hostname |
|
nor |
|
.I portnumber |
|
is specified. |
|
.TP |
|
\fB\-\-version\fP |
|
Display CIM Server version. |
|
.TP |
|
\fB\-w\fP password |
|
Authenticate the connection using the specified |
|
.I R password . |
|
If the |
|
.I password |
|
is not specified and the remote host requests authentication, the user is |
|
prompted for a password. |
|
This option is ignored if neither |
|
.I hostname |
|
nor |
|
.I portnumber |
|
is specified. |
.RE | .RE |
.SH EXIT STATUS |
.SH "EXIT STATUS" |
.PP | .PP |
When an error occurs, an error message is written to stderr and an | When an error occurs, an error message is written to stderr and an |
appropriate value is returned. The following values are returned: | appropriate value is returned. The following values are returned: |
|
|
Error | Error |
.PD | .PD |
.RE | .RE |
.SH DIAGNOSTICS |
.SH "USAGE NOTE" |
|
.PP |
|
The |
|
.B osinfo |
|
command requires that the CIM Server is running. |
|
.SH "DIAGNOSTICS" |
.PP | .PP |
.B "os info error: Cannot connect" | .B "os info error: Cannot connect" |
.IP | .IP |
The CIMOM is not running. Start the CIMOM with the | The CIMOM is not running. Start the CIMOM with the |
.C cimserver |
.B cimserver |
command and re-run |
command and re\-run |
.B osinfo . | .B osinfo . |
.SH EXAMPLES |
.SH "EXAMPLES" |
.PP | .PP |
Run the default | Run the default |
.B osinfo | .B osinfo |
|
|
.TP | .TP |
.B " Host: myserver.hp.com " | .B " Host: myserver.hp.com " |
.TP | .TP |
.B " Name: HP-UX " |
.B " Name: HP\-UX " |
.TP | .TP |
.B " Version: B.11.00 " | .B " Version: B.11.00 " |
.TP | .TP |
|
|
.TP | .TP |
.B " OSCapability: 32 bit " | .B " OSCapability: 32 bit " |
.TP | .TP |
.B " LastBootTime: Sep 24, 2001 9:16:18 (-0700) " |
.B " LastBootTime: Sep 24, 2001 9:16:18 (\-0700) " |
.TP | .TP |
.B " LocalDateTime: May 23, 2002 10:55:54 (-0700) " |
.B " LocalDateTime: May 23, 2002 10:55:54 (\-0700) " |
.TP | .TP |
.B " SystemUpTime: 20828377 seconds = 241 days, 1 hr, 39 mins, 37 secs " | .B " SystemUpTime: 20828377 seconds = 241 days, 1 hr, 39 mins, 37 secs " |
.PD | .PD |
.PP | .PP |
The system myserver.hp.com is running version B.11.00 of HP-UX, |
The system myserver.hp.com is running version B.11.00 of HP\-UX, |
has an unlimited user license, and is 32-bit capable. The Operating |
has an unlimited user license, and is 32\-bit capable. The Operating |
System was last booted on Sept 24, 2001 and the local date and time | System was last booted on Sept 24, 2001 and the local date and time |
are given. All time values are offset from GMT by -7 hours. |
are given. All time values are offset from GMT by \-7 hours. |
.PP | .PP |
Run | Run |
.B osinfo , | .B osinfo , |
with the values displayed in their CIM format | with the values displayed in their CIM format |
.TP | .TP |
.PD 0 | .PD 0 |
.B "osinfo -c" |
.B "osinfo \-c" |
| |
.TP | .TP |
.B "OperatingSystem Information" | .B "OperatingSystem Information" |
.TP | .TP |
.B " Host: rushmore.cup.hp.com" | .B " Host: rushmore.cup.hp.com" |
.TP | .TP |
.B " Name: HP-UX" |
.B " Name: HP\-UX" |
.TP | .TP |
.B " Version: B.11.00" | .B " Version: B.11.00" |
.TP | .TP |
|
|
.TP | .TP |
.B " OSCapability: 32 bit" | .B " OSCapability: 32 bit" |
.TP | .TP |
.B " LastBootTime: 20010924091618.000000-420" |
.B " LastBootTime: 20010924091618.000000\-420" |
.TP | .TP |
.B " LocalDateTime: 20020523105801.000000-420" |
.B " LocalDateTime: 20020523105801.000000\-420" |
.TP | .TP |
.B " SystemUpTime: 20828504" | .B " SystemUpTime: 20828504" |
.PD | .PD |
|
|
LastBootTime and LocalDateTime values are in the CIM format. The SystemUpTime | LastBootTime and LocalDateTime values are in the CIM format. The SystemUpTime |
value is in total seconds (as specified by CIM). Other fields do not change, | value is in total seconds (as specified by CIM). Other fields do not change, |
as their CIM specification is the strings themselves. | as their CIM specification is the strings themselves. |
.SH SEE ALSO |
.SH "SEE ALSO" |
.PP | .PP |
cimserver(1). | cimserver(1). |
.SH STANDARDS CONFORMANCE |
.SH "STANDARDS CONFORMANCE" |
.PP | .PP |
\fBosinfo\fP : DMTF WBEM (Web-Based Enterprise Management) and CIM |
\fBosinfo\fP : DMTF WBEM (Web\-Based Enterprise Management) and CIM |
(Common Information Model) | (Common Information Model) |