libstatgrab/docs/sg_get_host_info.xml

<?xml version="1.0"?>

<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
               "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">

<refentry id="sg_get_host_info">

  <refentryinfo>
    <date>$Date: 2004/05/02 09:35:15 $</date>
    <releaseinfo>$Id: sg_get_host_info.xml,v 1.4 2004/05/02 09:35:15 tdb Exp $</releaseinfo>
  </refentryinfo>

  <refmeta>
    <refentrytitle>sg_get_host_info</refentrytitle>
    <manvolnum>3</manvolnum>
    <refmiscinfo>i-scream</refmiscinfo>
  </refmeta>

  <refnamediv>
    <refname>sg_get_host_info</refname>
    <refpurpose>get general operating system statistics</refpurpose>
  </refnamediv>

  <refsynopsisdiv>
    <funcsynopsis>
      <funcsynopsisinfo>#include &lt;statgrab.h&gt;</funcsynopsisinfo>
      <funcprototype>
        <funcdef>sg_host_info *<function>sg_get_host_info</function></funcdef>
        <void/>
      </funcprototype>
    </funcsynopsis>
  </refsynopsisdiv>

  <refsect1>
    <title>Description</title>
    <para>
      This call returns details on the operating system.
    </para>
    <para>
      It returns a pointer to a static buffer of
      <structname>sg_host_info</structname>.
    </para>
  </refsect1>

  <refsect1>
    <title>Return Values</title>

    <para>
      The structure returned is of type
      <structname>sg_host_info</structname>.
    </para>

    <programlisting>
typedef struct{
        char *os_name;
        char *os_release;
        char *os_version;
        char *platform;
        char *hostname;
        time_t uptime;
}sg_host_info;
    </programlisting>

    <variablelist>
      <varlistentry>
        <term><structfield>os_name</structfield></term>
        <listitem>
          <para>
            the operating system name.
            (eg. SunOS or Linux)
          </para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term><structfield>os_release</structfield></term>
        <listitem>
          <para>
            the operating system release.
            (eg. 5.8 or 5.9 or Solaris)
          </para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term><structfield>os_version</structfield></term>
        <listitem>
          <para>
            the version level of the OS.
          </para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term><structfield>platform</structfield></term>
        <listitem>
          <para>
            the hardware platform (architecture) the OS runs on.
          </para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term><structfield>hostname</structfield></term>
        <listitem>
          <para>
            the name of the machine.
          </para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term><structfield>uptime</structfield></term>
        <listitem>
          <para>
            the uptime of the machine in seconds.
          </para>
        </listitem>
      </varlistentry>
    </variablelist>
  </refsect1>

  <refsect1>
    <title>See Also</title>

    <simplelist type="inline">
      <member>
        <citerefentry>
          <refentrytitle>statgrab</refentrytitle>
          <manvolnum>3</manvolnum>
        </citerefentry>
      </member>
    </simplelist>
  </refsect1>

  <refsect1>
    <title>Website</title>

    <simplelist type="vert">
      <member>
        <ulink url="http://www.i-scream.org/libstatgrab/">
          http://www.i-scream.org/libstatgrab/
        </ulink>
      </member>
    </simplelist>
  </refsect1>

</refentry>
Revision:	1.5
Committed:	Sun May 2 17:21:35 2004 UTC (21 years, 5 months ago) by tdb
Content type:	text/xml
Branch:	MAIN
CVS Tags:	LIBSTATGRAB_0_11_1, LIBSTATGRAB_0_11, LIBSTATGRAB_0_10_3, LIBSTATGRAB_0_10_2, LIBSTATGRAB_0_10_1, LIBSTATGRAB_0_10
Changes since 1.4:	+16 -16 lines
Log Message:	First pass as updating contents of documentation.
#	User	Rev	Content
1	tdb	1.1	<?xml version="1.0"?>
2
3			<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
4			"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
5
6	tdb	1.5	<refentry id="sg_get_host_info">
7	tdb	1.1
8			<refentryinfo>
9	tdb	1.5	<date>$Date: 2004/05/02 09:35:15 $</date>
10			<releaseinfo>$Id: sg_get_host_info.xml,v 1.4 2004/05/02 09:35:15 tdb Exp $</releaseinfo>
11	tdb	1.1	</refentryinfo>
12	tdb	1.5
13	tdb	1.1	<refmeta>
14	tdb	1.5	<refentrytitle>sg_get_host_info</refentrytitle>
15	tdb	1.1	<manvolnum>3</manvolnum>
16			<refmiscinfo>i-scream</refmiscinfo>
17			</refmeta>
18	tdb	1.5
19	tdb	1.1	<refnamediv>
20	tdb	1.5	<refname>sg_get_host_info</refname>
21	tdb	1.1	<refpurpose>get general operating system statistics</refpurpose>
22			</refnamediv>
23	tdb	1.5
24	tdb	1.1	<refsynopsisdiv>
25			<funcsynopsis>
26			<funcsynopsisinfo>#include <statgrab.h></funcsynopsisinfo>
27			<funcprototype>
28	tdb	1.5	<funcdef>sg_host_info *<function>sg_get_host_info</function></funcdef>
29	tdb	1.1	<void/>
30			</funcprototype>
31			</funcsynopsis>
32			</refsynopsisdiv>
33	tdb	1.5
34	tdb	1.1	<refsect1>
35			<title>Description</title>
36			<para>
37			This call returns details on the operating system.
38			</para>
39			<para>
40			It returns a pointer to a static buffer of
41	tdb	1.5	<structname>sg_host_info</structname>.
42	tdb	1.1	</para>
43			</refsect1>
44	tdb	1.5
45	tdb	1.1	<refsect1>
46			<title>Return Values</title>
47
48			<para>
49			The structure returned is of type
50	tdb	1.5	<structname>sg_host_info</structname>.
51	tdb	1.1	</para>
52
53			<programlisting>
54			typedef struct{
55			char *os_name;
56			char *os_release;
57			char *os_version;
58			char *platform;
59			char *hostname;
60			time_t uptime;
61	tdb	1.5	}sg_host_info;
62	tdb	1.1	</programlisting>
63
64			<variablelist>
65			<varlistentry>
66			<term><structfield>os_name</structfield></term>
67			<listitem>
68			<para>
69			the operating system name.
70			(eg. SunOS or Linux)
71			</para>
72			</listitem>
73			</varlistentry>
74			<varlistentry>
75			<term><structfield>os_release</structfield></term>
76			<listitem>
77			<para>
78			the operating system release.
79			(eg. 5.8 or 5.9 or Solaris)
80			</para>
81			</listitem>
82			</varlistentry>
83			<varlistentry>
84			<term><structfield>os_version</structfield></term>
85			<listitem>
86			<para>
87			the version level of the OS.
88			</para>
89			</listitem>
90			</varlistentry>
91			<varlistentry>
92			<term><structfield>platform</structfield></term>
93			<listitem>
94			<para>
95			the hardware platform (architecture) the OS runs on.
96			</para>
97			</listitem>
98			</varlistentry>
99			<varlistentry>
100			<term><structfield>hostname</structfield></term>
101			<listitem>
102			<para>
103			the name of the machine.
104			</para>
105			</listitem>
106			</varlistentry>
107			<varlistentry>
108			<term><structfield>uptime</structfield></term>
109			<listitem>
110			<para>
111			the uptime of the machine in seconds.
112			</para>
113			</listitem>
114			</varlistentry>
115			</variablelist>
116			</refsect1>
117
118			<refsect1>
119			<title>See Also</title>
120	tdb	1.2
121			<simplelist type="inline">
122			<member>
123			<citerefentry>
124			<refentrytitle>statgrab</refentrytitle>
125			<manvolnum>3</manvolnum>
126			</citerefentry>
127			</member>
128			</simplelist>
129	tdb	1.1	</refsect1>
130	tdb	1.5
131	tdb	1.1	<refsect1>
132			<title>Website</title>
133	tdb	1.5
134	tdb	1.1	<simplelist type="vert">
135			<member>
136	tdb	1.3	<ulink url="http://www.i-scream.org/libstatgrab/">
137			http://www.i-scream.org/libstatgrab/
138			</ulink>
139	tdb	1.1	</member>
140			</simplelist>
141			</refsect1>
142
143			</refentry>