posix-uname.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: f8854f6a6a7907720ed8ec8657a2f466a82c0394 Maintainer: hirokawa Status: ready -->
<!-- CREDITS: takagi,mumumu -->
<refentry xml:id="function.posix-uname" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
  <refname>posix_uname</refname>
  <refpurpose>システム名を得る</refpurpose>
 </refnamediv>
 
 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <type class="union"><type>array</type><type>false</type></type><methodname>posix_uname</methodname>
   <void/>
  </methodsynopsis>
  <para>
   システムについての情報を取得します。
  </para>
  <para>
   POSIX では、値のフォーマットに関して何の仮定も設けないことを規定しています。
   例えば、バージョン番号が 3 桁の数字であることや、
   この関数により返されるその他のものに依存してはいけません。
  </para>
 </refsect1>

 <refsect1 role="parameters">
  &reftitle.parameters;
  &no.function.parameters;
 </refsect1>

 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   システムに関する情報を文字列の連想配列として返します。
   連想配列のキーは、次のようになります。
   <itemizedlist>
    <listitem><simpara>
      sysname - オペレーティングシステムの名前 (例 Linux)
     </simpara></listitem>
    <listitem><simpara>
      nodename - システムの名前 (例 valiant)
     </simpara></listitem>
    <listitem><simpara>
      release - オペレーティングシステムのリリース (例 2.2.10)
     </simpara></listitem>
    <listitem><simpara>
      version - オペレーティングシステムのバージョン (例 #4 Tue Jul 20
      17:01:36 MEST 1999)
     </simpara></listitem>
    <listitem><simpara>
      machine - システムアーキテクチャ (例 i586)
     </simpara></listitem>
    <listitem><simpara>
      domainname - DNS ドメイン名 (例 example.com)
     </simpara></listitem>
   </itemizedlist>
  </para>
  <para>
   domainname は、GNU の拡張機能で POSIX.1 には含まれていません。
   このため、このフィールドは GNU システム上または GNU libc
   を使用している場合にのみ使用可能です。
  </para>
  <para>
   この関数は、失敗時に &false; を返します。
  </para>
 </refsect1>

 <refsect1 role="examples">
  &reftitle.examples;
  <para>
   <example>
    <title><function>posix_uname</function> の使用例</title>
    <programlisting role="php">
<![CDATA[
<?php
$uname=posix_uname();
print_r($uname);
?>
]]>
    </programlisting>
    &example.outputs.similar;
    <screen>
<![CDATA[
Array
(
    [sysname] => Linux
    [nodename] => funbox
    [release] => 2.6.20-15-server
    [version] => #2 SMP Sun Apr 15 07:41:34 UTC 2007
    [machine] => i686
)
]]>
    </screen>
   </example>
  </para>
 </refsect1>

</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->