cvs: phpdoc-it /reference/sem/functions sem-acquire.xml sem-get.xml sem-release.xml sem-remove.xml shm-attach.xml shm-detach.xml
| From: | Andrioli Darvin | Date: | Sat, 22 Feb 2003 13:00:13 +0000 |
| Subject: | cvs: phpdoc-it /reference/sem/functions sem-acquire.xml sem-get.xml sem-release.xml sem-remove.xml shm-attach.xml shm-detach.xml | ||
| Groups: | php.doc.it | ||
| Request: | Send a blank email to doc-it+get-238@lists.php.net to get a copy of this message | ||
darvina Sat Feb 22 08:00:13 2003 EDT
Modified files:
/phpdoc-it/reference/sem/functions sem-acquire.xml sem-get.xml
sem-release.xml sem-remove.xml
shm-attach.xml shm-detach.xml
Log:
Sync to En tree
Index: phpdoc-it/reference/sem/functions/sem-acquire.xml diff -u phpdoc-it/reference/sem/functions/sem-acquire.xml:1.2 phpdoc-it/reference/sem/functions/sem-acquire.xml:1.3 --- phpdoc-it/reference/sem/functions/sem-acquire.xml:1.2 Wed Apr 17 03:08:20 2002 +++ phpdoc-it/reference/sem/functions/sem-acquire.xml Sat Feb 22 08:00:12 2003 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./it/functions/sem.xml, last change in rev 1.1 --> <!-- last change to 'sem-acquire' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: darvina Status: ready --> +<!-- EN-Revision: 1.3 Maintainer: darvina Status: ready --> <!-- OLD-Revision: 1.19/EN.1.2 --> <refentry id="function.sem-acquire"> <refnamediv> @@ -15,14 +15,14 @@ <methodparam><type>int</type><parameter>sem_identifier</parameter></methodparam> </methodsynopsis> <para> - La funzione restituisce: &true; se ha successo, &false; se si verifica un errore. - </para> - <para> La funzione <function>sem_acquire</function> si blocca (se necessario) fino a quando non riesce ad acquisire il semaforo. Se un processo tenta di acquisire un semaforo che ha già acquisito può restare bloccato per sempre se la nuova acquisizione del semaforo causa il superamento del parametro max_acquire. + </para> + <para> + &return.success; </para> <para> Dopo avere processato una richiesta, qualsiasi semaforo acquisito dal Index: phpdoc-it/reference/sem/functions/sem-get.xml diff -u phpdoc-it/reference/sem/functions/sem-get.xml:1.3 phpdoc-it/reference/sem/functions/sem-get.xml:1.4 --- phpdoc-it/reference/sem/functions/sem-get.xml:1.3 Wed May 15 16:02:37 2002 +++ phpdoc-it/reference/sem/functions/sem-get.xml Sat Feb 22 08:00:12 2003 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./it/functions/sem.xml, last change in rev 1.1 --> <!-- last change to 'sem-get' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.3 Maintainer: darvina Status: ready --> +<!-- EN-Revision: 1.4 Maintainer: darvina Status: ready --> <!-- OLD-Revision: 1.19/EN.1.2 --> <refentry id="function.sem-get"> <refnamediv> @@ -17,10 +17,6 @@ <methodparam choice="opt"><type>int</type><parameter>perm</parameter></methodparam> </methodsynopsis> <para> - La funzione ritorna un identificatore positivo di semaforo se ha successo, - oppure &false; se si verifica un errore. - </para> - <para> La funzione <function>sem_get</function> restituisce un identificativo che può essere utilizzato per accedere al semaforo con chiave indicata in <parameter>key</parameter>. Se necessario il semaforo viene creato con i bit dei permessi valorizzati come @@ -28,6 +24,10 @@ massimo di processi che possono acquisire il semaforo simultaneamente (1 per default). In realtà questo valore è modificabile solo se il processo è l'unico, in quel momento, ad essere collegato al semaforo. + </para> + <para> + La funzione ritorna un identificatore positivo di semaforo se ha successo, + oppure &false; se si verifica un errore. </para> <para> Una seconds chiamata a <function>sem_get</function> per la medesima chiave Index: phpdoc-it/reference/sem/functions/sem-release.xml diff -u phpdoc-it/reference/sem/functions/sem-release.xml:1.2 phpdoc-it/reference/sem/functions/sem-release.xml:1.3 --- phpdoc-it/reference/sem/functions/sem-release.xml:1.2 Wed Apr 17 03:08:20 2002 +++ phpdoc-it/reference/sem/functions/sem-release.xml Sat Feb 22 08:00:12 2003 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./it/functions/sem.xml, last change in rev 1.1 --> <!-- last change to 'sem-release' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: darvina Status: ready --> +<!-- EN-Revision: 1.3 Maintainer: darvina Status: ready --> <!-- OLD-Revision: 1.19/EN.1.2 --> <refentry id="function.sem-release"> <refnamediv> @@ -15,12 +15,12 @@ <methodparam><type>int</type><parameter>sem_identifier</parameter></methodparam> </methodsynopsis> <para> - La funzione restituisce: &true; se ha successo, &false; se si verifica un errore. - </para> - <para> La funzione <function>sem_release</function> rilascia il semaforo se questo è attualmente acquisito dal processo chiamante. In caso contrario sarà generato un messaggio di warning. + </para> + <para> + &return.success; </para> <para> Dopo avere rilasciato un semaforo, occorre eseguire di nuovo Index: phpdoc-it/reference/sem/functions/sem-remove.xml diff -u phpdoc-it/reference/sem/functions/sem-remove.xml:1.2 phpdoc-it/reference/sem/functions/sem-remove.xml:1.3 --- phpdoc-it/reference/sem/functions/sem-remove.xml:1.2 Wed Apr 17 03:08:21 2002 +++ phpdoc-it/reference/sem/functions/sem-remove.xml Sat Feb 22 08:00:12 2003 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./it/functions/sem.xml, last change in rev 1.7 --> <!-- last change to 'sem-remove' in en/ tree in rev 1.7 --> -<!-- EN-Revision: 1.2 Maintainer: darvina Status: ready --> +<!-- EN-Revision: 1.3 Maintainer: darvina Status: ready --> <!-- OLD-Revision: 1.19/EN.1.7 --> <refentry id="function.sem-remove"> <refnamediv> @@ -15,14 +15,13 @@ <methodparam><type>int</type><parameter>sem_identifier</parameter></methodparam> </methodsynopsis> <para> - La funzione restituisce: &true; se ha successo, &false; - se si verifica un errore. - </para> - <para> La funzione <function>sem_remove</function> rimuove il semaforo indicato da <parameter>sem_identifier</parameter> se questo è stato generato in orecedenza da <function>sem_get</function>. In caso contrario si genera un messaggio di warning + </para> + <para> + &return.success; </para> <para> Una volta rimosso, il semaforo non è più accessibile. Index: phpdoc-it/reference/sem/functions/shm-attach.xml diff -u phpdoc-it/reference/sem/functions/shm-attach.xml:1.3 phpdoc-it/reference/sem/functions/shm-attach.xml:1.4 --- phpdoc-it/reference/sem/functions/shm-attach.xml:1.3 Wed May 15 15:59:59 2002 +++ phpdoc-it/reference/sem/functions/shm-attach.xml Sat Feb 22 08:00:12 2003 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./it/functions/sem.xml, last change in rev 1.1 --> <!-- last change to 'shm-attach' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.3 Maintainer: darvina Status: ready --> +<!-- EN-Revision: 1.5 Maintainer: darvina Status: ready --> <!-- OLD-Revision: 1.19/EN.1.2 --> <refentry id="function.shm-attach"> <refnamediv> @@ -19,10 +19,9 @@ <para> La funzione <function>shm_attach</function> restituisce un identificativo che può essere utilizzato per accedere alla memoria condivisa identificata dalla chiave <parameter>key</parameter> - la prima chiamata crea il segmento di memoria condivisa - (la dimensione di default può essere indicata in sysvshm.init_mem nel <link - linkend="configuration.file">file di configurazione</link>, altrimenti - viene fissata a 10000 bytes) e con i bit dei permessi (default: 0666). + la prima chiamata crea il segmento di memoria condivisa di dimensione <parameter>memsize</parameter> + (la dimensione di default può essere indicata in sysvshm.init_mem in &php.ini;, + altrimenti viene fissata a 10000 bytes) e con i bit dei permessi (default: 0666). </para> <para> Una seconda chiamata alla funzione <function>shm_attach</function> con il medesimo parametro Index: phpdoc-it/reference/sem/functions/shm-detach.xml diff -u phpdoc-it/reference/sem/functions/shm-detach.xml:1.2 phpdoc-it/reference/sem/functions/shm-detach.xml:1.3 --- phpdoc-it/reference/sem/functions/shm-detach.xml:1.2 Wed Apr 17 03:08:21 2002 +++ phpdoc-it/reference/sem/functions/shm-detach.xml Sat Feb 22 08:00:12 2003 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./it/functions/sem.xml, last change in rev 1.1 --> <!-- last change to 'shm-detach' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: darvina Status: ready --> +<!-- EN-Revision: 1.4 Maintainer: darvina Status: ready --> <!-- OLD-Revision: 1.19/EN.1.2 --> <refentry id="function.shm-detach"> <refnamediv> @@ -11,7 +11,7 @@ <refsect1> <title>Descrizione</title> <methodsynopsis> - <type>int</type><methodname>shm_detach</methodname> + <type>bool</type><methodname>shm_detach</methodname> <methodparam><type>int</type><parameter>shm_identifier</parameter></methodparam> </methodsynopsis> <para> @@ -19,6 +19,9 @@ indicato dal parametro <parameter>shm_identifier</parameter> creato tramite la funzione <function>shm_attach</function>. Si ricordi che la memoria condivisa continua a esistere nel sistema Unix e i dati sono ancora presenti. + </para> + <para> + La funzione <function>shm_detach</function> restituisce sempre &true;. </para> </refsect1> </refentry>
Index: phpdoc-it/reference/sem/functions/sem-acquire.xml diff -u phpdoc-it/reference/sem/functions/sem-acquire.xml:1.2 phpdoc-it/reference/sem/functions/sem-acquire.xml:1.3 --- phpdoc-it/reference/sem/functions/sem-acquire.xml:1.2 Wed Apr 17 03:08:20 2002 +++ phpdoc-it/reference/sem/functions/sem-acquire.xml Sat Feb 22 08:00:12 2003 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./it/functions/sem.xml, last change in rev 1.1 --> <!-- last change to 'sem-acquire' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: darvina Status: ready --> +<!-- EN-Revision: 1.3 Maintainer: darvina Status: ready --> <!-- OLD-Revision: 1.19/EN.1.2 --> <refentry id="function.sem-acquire"> <refnamediv> @@ -15,14 +15,14 @@ <methodparam><type>int</type><parameter>sem_identifier</parameter></methodparam> </methodsynopsis> <para> - La funzione restituisce: &true; se ha successo, &false; se si verifica un errore. - </para> - <para> La funzione <function>sem_acquire</function> si blocca (se necessario) fino a quando non riesce ad acquisire il semaforo. Se un processo tenta di acquisire un semaforo che ha già acquisito può restare bloccato per sempre se la nuova acquisizione del semaforo causa il superamento del parametro max_acquire. + </para> + <para> + &return.success; </para> <para> Dopo avere processato una richiesta, qualsiasi semaforo acquisito dal Index: phpdoc-it/reference/sem/functions/sem-get.xml diff -u phpdoc-it/reference/sem/functions/sem-get.xml:1.3 phpdoc-it/reference/sem/functions/sem-get.xml:1.4 --- phpdoc-it/reference/sem/functions/sem-get.xml:1.3 Wed May 15 16:02:37 2002 +++ phpdoc-it/reference/sem/functions/sem-get.xml Sat Feb 22 08:00:12 2003 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./it/functions/sem.xml, last change in rev 1.1 --> <!-- last change to 'sem-get' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.3 Maintainer: darvina Status: ready --> +<!-- EN-Revision: 1.4 Maintainer: darvina Status: ready --> <!-- OLD-Revision: 1.19/EN.1.2 --> <refentry id="function.sem-get"> <refnamediv> @@ -17,10 +17,6 @@ <methodparam choice="opt"><type>int</type><parameter>perm</parameter></methodparam> </methodsynopsis> <para> - La funzione ritorna un identificatore positivo di semaforo se ha successo, - oppure &false; se si verifica un errore. - </para> - <para> La funzione <function>sem_get</function> restituisce un identificativo che può essere utilizzato per accedere al semaforo con chiave indicata in <parameter>key</parameter>. Se necessario il semaforo viene creato con i bit dei permessi valorizzati come @@ -28,6 +24,10 @@ massimo di processi che possono acquisire il semaforo simultaneamente (1 per default). In realtà questo valore è modificabile solo se il processo è l'unico, in quel momento, ad essere collegato al semaforo. + </para> + <para> + La funzione ritorna un identificatore positivo di semaforo se ha successo, + oppure &false; se si verifica un errore. </para> <para> Una seconds chiamata a <function>sem_get</function> per la medesima chiave Index: phpdoc-it/reference/sem/functions/sem-release.xml diff -u phpdoc-it/reference/sem/functions/sem-release.xml:1.2 phpdoc-it/reference/sem/functions/sem-release.xml:1.3 --- phpdoc-it/reference/sem/functions/sem-release.xml:1.2 Wed Apr 17 03:08:20 2002 +++ phpdoc-it/reference/sem/functions/sem-release.xml Sat Feb 22 08:00:12 2003 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./it/functions/sem.xml, last change in rev 1.1 --> <!-- last change to 'sem-release' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: darvina Status: ready --> +<!-- EN-Revision: 1.3 Maintainer: darvina Status: ready --> <!-- OLD-Revision: 1.19/EN.1.2 --> <refentry id="function.sem-release"> <refnamediv> @@ -15,12 +15,12 @@ <methodparam><type>int</type><parameter>sem_identifier</parameter></methodparam> </methodsynopsis> <para> - La funzione restituisce: &true; se ha successo, &false; se si verifica un errore. - </para> - <para> La funzione <function>sem_release</function> rilascia il semaforo se questo è attualmente acquisito dal processo chiamante. In caso contrario sarà generato un messaggio di warning. + </para> + <para> + &return.success; </para> <para> Dopo avere rilasciato un semaforo, occorre eseguire di nuovo Index: phpdoc-it/reference/sem/functions/sem-remove.xml diff -u phpdoc-it/reference/sem/functions/sem-remove.xml:1.2 phpdoc-it/reference/sem/functions/sem-remove.xml:1.3 --- phpdoc-it/reference/sem/functions/sem-remove.xml:1.2 Wed Apr 17 03:08:21 2002 +++ phpdoc-it/reference/sem/functions/sem-remove.xml Sat Feb 22 08:00:12 2003 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./it/functions/sem.xml, last change in rev 1.7 --> <!-- last change to 'sem-remove' in en/ tree in rev 1.7 --> -<!-- EN-Revision: 1.2 Maintainer: darvina Status: ready --> +<!-- EN-Revision: 1.3 Maintainer: darvina Status: ready --> <!-- OLD-Revision: 1.19/EN.1.7 --> <refentry id="function.sem-remove"> <refnamediv> @@ -15,14 +15,13 @@ <methodparam><type>int</type><parameter>sem_identifier</parameter></methodparam> </methodsynopsis> <para> - La funzione restituisce: &true; se ha successo, &false; - se si verifica un errore. - </para> - <para> La funzione <function>sem_remove</function> rimuove il semaforo indicato da <parameter>sem_identifier</parameter> se questo è stato generato in orecedenza da <function>sem_get</function>. In caso contrario si genera un messaggio di warning + </para> + <para> + &return.success; </para> <para> Una volta rimosso, il semaforo non è più accessibile. Index: phpdoc-it/reference/sem/functions/shm-attach.xml diff -u phpdoc-it/reference/sem/functions/shm-attach.xml:1.3 phpdoc-it/reference/sem/functions/shm-attach.xml:1.4 --- phpdoc-it/reference/sem/functions/shm-attach.xml:1.3 Wed May 15 15:59:59 2002 +++ phpdoc-it/reference/sem/functions/shm-attach.xml Sat Feb 22 08:00:12 2003 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./it/functions/sem.xml, last change in rev 1.1 --> <!-- last change to 'shm-attach' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.3 Maintainer: darvina Status: ready --> +<!-- EN-Revision: 1.5 Maintainer: darvina Status: ready --> <!-- OLD-Revision: 1.19/EN.1.2 --> <refentry id="function.shm-attach"> <refnamediv> @@ -19,10 +19,9 @@ <para> La funzione <function>shm_attach</function> restituisce un identificativo che può essere utilizzato per accedere alla memoria condivisa identificata dalla chiave <parameter>key</parameter> - la prima chiamata crea il segmento di memoria condivisa - (la dimensione di default può essere indicata in sysvshm.init_mem nel <link - linkend="configuration.file">file di configurazione</link>, altrimenti - viene fissata a 10000 bytes) e con i bit dei permessi (default: 0666). + la prima chiamata crea il segmento di memoria condivisa di dimensione <parameter>memsize</parameter> + (la dimensione di default può essere indicata in sysvshm.init_mem in &php.ini;, + altrimenti viene fissata a 10000 bytes) e con i bit dei permessi (default: 0666). </para> <para> Una seconda chiamata alla funzione <function>shm_attach</function> con il medesimo parametro Index: phpdoc-it/reference/sem/functions/shm-detach.xml diff -u phpdoc-it/reference/sem/functions/shm-detach.xml:1.2 phpdoc-it/reference/sem/functions/shm-detach.xml:1.3 --- phpdoc-it/reference/sem/functions/shm-detach.xml:1.2 Wed Apr 17 03:08:21 2002 +++ phpdoc-it/reference/sem/functions/shm-detach.xml Sat Feb 22 08:00:12 2003 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./it/functions/sem.xml, last change in rev 1.1 --> <!-- last change to 'shm-detach' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: darvina Status: ready --> +<!-- EN-Revision: 1.4 Maintainer: darvina Status: ready --> <!-- OLD-Revision: 1.19/EN.1.2 --> <refentry id="function.shm-detach"> <refnamediv> @@ -11,7 +11,7 @@ <refsect1> <title>Descrizione</title> <methodsynopsis> - <type>int</type><methodname>shm_detach</methodname> + <type>bool</type><methodname>shm_detach</methodname> <methodparam><type>int</type><parameter>shm_identifier</parameter></methodparam> </methodsynopsis> <para> @@ -19,6 +19,9 @@ indicato dal parametro <parameter>shm_identifier</parameter> creato tramite la funzione <function>shm_attach</function>. Si ricordi che la memoria condivisa continua a esistere nel sistema Unix e i dati sono ancora presenti. + </para> + <para> + La funzione <function>shm_detach</function> restituisce sempre &true;. </para> </refsect1> </refentry>