[PHP-DOC] cvs: phpdoc-it /reference/sockets/functions socket-getsockname.xml

[Andrioli Darvin]

darvina         Sun Jun  2 08:54:19 2002 EDT

  Modified files:              
    /phpdoc-it/reference/sockets/functions      socket-getsockname.xml 
  Log:
  Update to En 1.3
  
Index: phpdoc-it/reference/sockets/functions/socket-getsockname.xml
diff -u phpdoc-it/reference/sockets/functions/socket-getsockname.xml:1.2 
phpdoc-it/reference/sockets/functions/socket-getsockname.xml:1.3
--- phpdoc-it/reference/sockets/functions/socket-getsockname.xml:1.2    Wed Apr 17 
03:08:39 2002
+++ phpdoc-it/reference/sockets/functions/socket-getsockname.xml        Sun Jun  2 
+08:54:19 2002
@@ -1,24 +1,50 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
 <!-- splitted from ./it/functions/sockets.xml, last change in rev 1.4 -->
 <!-- last change to 'socket-getsockname' in en/ tree in rev 1.27 -->
-<!-- EN-Revision: 1.2 Maintainer: darvina Status: ready -->
+<!-- EN-Revision: 1.3 Maintainer: darvina Status: ready -->
 <!-- OLD-Revision: 1.34/EN.1.27 -->
   <refentry id="function.socket-getsockname">
    <refnamediv>
     <refname>socket_getsockname</refname>
-    <refpurpose>Dato un fd, memorizza la stringa rappresentante sa.sin_addr ed il 
valore di sa.sin_port in addr e port, descrivendo il lato locale di un 
socket</refpurpose>
+    <refpurpose>
+     Interroga il lato locale di un dato socket e restituisce o la combinazione 
+host/porta
+     oppure un percorso Unix in base al tipo di socket
+    </refpurpose>
    </refnamediv>
    <refsect1>
     <title>Descrizione</title>
      <methodsynopsis>
       <type>bool</type><methodname>socket_getsockname</methodname>
       <methodparam><type>resource</type><parameter>socket</parameter></methodparam>
-      <methodparam><type>string</type><parameter>&amp;addr</parameter></methodparam>
-      <methodparam 
choice="opt"><type>int</type><parameter>&amp;port</parameter></methodparam>
+      
+<methodparam><type>string</type><parameter>&amp;indirizzo</parameter></methodparam>
+      <methodparam 
+choice="opt"><type>int</type><parameter>&amp;porta</parameter></methodparam>
      </methodsynopsis>
      &warn.experimental.func;
     <para>
-     &warn.undocumented.func;
+     Se il socket dato � di tipo <constant>AF_INET</constant>,
+     <function>socket_getsockname</function> restituisce l'<emphasis>indirizzo 
+IP</emphasis>
+     locale nella notazione a quattro cifre con punto (ad esempio
+     <literal>127.0.0.1</literal>) nel parametro <parameter>indirizzo</parameter>
+     e, se presente il parametro opzionale <parameter>porta</parameter>,
+     anche la porta associata.
+    </para>  
+    <para>  
+     Se il socket dato � di tipo <constant>AF_UNIX</constant>,
+     <function>socket_getsockname</function> restituir� un percorso Unix
+     (ad esempio <literal>/var/run/daemon.sock</literal>) nel
+     parametro <parameter>indirizzo</parameter>.
+    </para>  
+    <para>  
+     &return.success; <function>socket_getsockname</function> pu� anche restituire
+     &false; se il tipo di socket non � <constant>AF_INET</constant> o
+     <constant>AF_UNIX</constant>, in questo caso l'ultimo codice di errore del socket
+     <emphasis>non</emphasis> viene aggiornato.
+    </para>  
+    <para>  
+     Vedere anche  
+     <function>socket_getpeername</function>,  
+     <function>socket_last_error</function> e  
+     <function>socket_strerror</function>.  
     </para>
    </refsect1>
   </refentry>