From 4908d1bd122a541bcad95f676e6effb08c9bfaef Mon Sep 17 00:00:00 2001 From: Gina Peter Banyard Date: Mon, 26 Jan 2026 15:16:36 +0000 Subject: [PATCH] shmop: remove function documentation of files without EN Revcheck tags This is the only blocker to update the XML markup across translations and we don't know how out of shape these files are. --- reference/shmop/functions/shmop-close.xml | 61 ------------ reference/shmop/functions/shmop-delete.xml | 63 ------------ reference/shmop/functions/shmop-open.xml | 107 --------------------- reference/shmop/functions/shmop-read.xml | 65 ------------- reference/shmop/functions/shmop-size.xml | 65 ------------- reference/shmop/functions/shmop-write.xml | 67 ------------- 6 files changed, 428 deletions(-) delete mode 100644 reference/shmop/functions/shmop-close.xml delete mode 100644 reference/shmop/functions/shmop-delete.xml delete mode 100644 reference/shmop/functions/shmop-open.xml delete mode 100644 reference/shmop/functions/shmop-read.xml delete mode 100644 reference/shmop/functions/shmop-size.xml delete mode 100644 reference/shmop/functions/shmop-write.xml diff --git a/reference/shmop/functions/shmop-close.xml b/reference/shmop/functions/shmop-close.xml deleted file mode 100644 index d2082c019..000000000 --- a/reference/shmop/functions/shmop-close.xml +++ /dev/null @@ -1,61 +0,0 @@ - - - - - - - - shmop_close - Chiusura di un blocco di memoria condivisa - - - Descrizione - - intshmop_close - intshmid - - - Si utilizza la funzione shmop_close per chiudere un segmento di memoria condivisa. - - - La funzione shmop_close ha un solo parametro, shmid, che è l'identificativo - del blocco di memoria condivisa creato da shmop_open. - - - - Chiusura di un blocco di memoria condivisa - - -]]> - - - - - In questo esempio si chiude il blocco di memoria condivisa identificata da $shm_id. - - - - - diff --git a/reference/shmop/functions/shmop-delete.xml b/reference/shmop/functions/shmop-delete.xml deleted file mode 100644 index 3fc31e8f2..000000000 --- a/reference/shmop/functions/shmop-delete.xml +++ /dev/null @@ -1,63 +0,0 @@ - - - - - - - - shmop_delete - Cancella un blocco di memoria condivisa - - - Descrizione - - intshmop_delete - intshmid - - - La funzione shmop_delete viene utilizzata per cancellare un blocco di memoria condivisa. - - - La funzione shmop_delete ha un solo parametro, shmid, che è l'identificativo - del blocco di memoria condiviso creato da shmop_open. Se la funzione ha - successo restituisce 1, altrimenti 0. - - - - Cancellazione di un segmento di memoria condivisa - - -]]> - - - - - In questo esempio si cancella il segmento di memoria condivisa identificato da - $shm_id. - - - - - diff --git a/reference/shmop/functions/shmop-open.xml b/reference/shmop/functions/shmop-open.xml deleted file mode 100644 index f938fc3d1..000000000 --- a/reference/shmop/functions/shmop-open.xml +++ /dev/null @@ -1,107 +0,0 @@ - - - - - shmop_open - Crea oppure apre un segmento di memoria condivisa - - - Descrizione - - intshmop_open - intkey - stringflags - intmode - intsize - - - La funzione shmop_open può creare oppure aprire un segmento di memoria condivisa. - - - La funzione shmop_open utilizza 4 parametri: key, indica l'identificativo - di sistema per il segmento di memoria condivisa, questo parametro può essere passato - come numero decimale o esadecimale. Il secondo parametro è un flag che può assumere i seguenti valori: - - - - "a" per accesso (SHM_RDONLY per shmat), - usare questo flag quando occorre aprire un segmento di memoria - condivisa esistente in sola lettura - - - - - "c" per creazione (IPC_CREATE), - usare questo flag quando si ha la necessità di creare un nuovo segmento di memoria condivisa oppure, - se esiste già un segmento con la medesima chiave, tentare di aprirlo in lettura - e scrittura - - - - - "w" per accesso in lettura & scrittura, - usare questo flag quando si deve accedere al segmento di memoria condivisa in lettura e scrittura, - nella maggior parte dei casi si usa questo flag. - - - - - "n" per creare un nuovo segmento (IPC_CREATE|IPC_EXCL), - usare questo flag quando si vuole creare un nuovo segmento di memoria condivisa, ma, - se già ne esiste uno con il medesimo flag, la funzione fallisce. Ciò è utile per motivi di sicurezza, - infatti questo permette di evitare problemi di concorrenza. - - - - Il terzo parametro, mode, indica i permessi che si desidera assegnare - al segmento di memoria, questi sono i medesimi permessi utilizzati per - un file. Occorre passare i permessi in forma ottale, ad esempio 0644. - L'ultimo parametro è la dimensione in bytes del blocco di memoria condivisa che si - desidera creare. - - Il terzo ed il quarto parametro dovrebbero essere a 0 se si sta aprendo - un segmento di memoria esistene. Se la funzione shmop_open ha - successo, sarà restituito un id da usarsi per accedere al segmento di memoria - condivisa appena creato. - - - - - Creazione di un nuovo blocco di memoria condivisa - - -]]> - - - - - Questo esempio apre un blocco di memoria condivisa con id di sistema - restituito da ftok. - - - - - diff --git a/reference/shmop/functions/shmop-read.xml b/reference/shmop/functions/shmop-read.xml deleted file mode 100644 index 10018798f..000000000 --- a/reference/shmop/functions/shmop-read.xml +++ /dev/null @@ -1,65 +0,0 @@ - - - - - - - - shmop_read - Legge i dati da un segmento di memoria condivisa - - - Descrizione - - stringshmop_read - intshmid - intstart - intcount - - - La funzione shmop_read legge una stringa da un blocco di memoria condivisa. - - - La funzione shmop_read utilizza 3 parametri: shmid, che è l'identificativo - del blocco di memoria condivisa creato da shmop_open; start, che indica - l'offset da cui partire a leggere e count che indica il numero dei byte da leggere. - - - - Lettura di un segmento di memoria condivisa - - -]]> - - - - - Questo esempio legge 50 byte da un blocco di memoria condivisa e posiziona - i dati nella variabile $shm_data. - - - - - diff --git a/reference/shmop/functions/shmop-size.xml b/reference/shmop/functions/shmop-size.xml deleted file mode 100644 index dda53abc3..000000000 --- a/reference/shmop/functions/shmop-size.xml +++ /dev/null @@ -1,65 +0,0 @@ - - - - - - - - shmop_size - Restituisce la dimensione di un blocco di memoria condivisa - - - Descrizione - - intshmop_size - intshmid - - - Si utilizza la funzione shmop_size per ottenere la dimensione in byte - del segmento di memoria condivisa. - - - La funzione shmop_size ha un solo parametro, shmid, che è l'identificativo - del blocco di memoria condiviso creato da shmop_open; la funzione - restituisce un numero intero che rappresenta il numero dei byte occupati - dal segmento di memoria condivisa. - - - - Come ottenere la dimensione della memoria condivisa - - -]]> - - - - - In questo esempio si memorizza nella variabile $shm_size - la dimensione del blocco di memoria identificato da $shm_id. - - - - - diff --git a/reference/shmop/functions/shmop-write.xml b/reference/shmop/functions/shmop-write.xml deleted file mode 100644 index b32346ff4..000000000 --- a/reference/shmop/functions/shmop-write.xml +++ /dev/null @@ -1,67 +0,0 @@ - - - - - - - - shmop_write - Scrittura di dati nel blocco di memoria condivisa - - - Descrizione - - intshmop_write - intshmid - stringdata - intoffset - - - La funzione shmop_write scrive una stringa in un segmento di memoria condivisa. - - - La funzione shmop_write utilizza 3 parametri: shmid, che è l'identificativo - del blocco di memoria condiviso creato da shmop_open; - data, che è la stringa che si vuole scrivere nel blocco di memoria e offset, - che specifica dove cominciare a scrivere nella memoria condivisa. - - - - Scrittura di un blocco di memoria condivisa - - -]]> - - - - - Questo esempio scrive i dati della variabile $my_string nel - blocco di memoria condivisa, mentre $shm_bytes_written contiene - il numero dei byte scritti. - - - - -