Documentation: Remove :manpage: from non-existing man pages

+8 -8

Documentation/process/adding-syscalls.rst

··· 111 111 new type of userspace object handle when the kernel already has mechanisms and 112 112 well-defined semantics for using file descriptors. 113 113 114 - If your new :manpage:`xyzzy(2)` system call does return a new file descriptor, 114 + If your new xyzzy(2) system call does return a new file descriptor, 115 115 then the flags argument should include a value that is equivalent to setting 116 116 ``O_CLOEXEC`` on the new FD. This makes it possible for userspace to close 117 117 the timing window between ``xyzzy()`` and calling ··· 127 127 normal way for the kernel to indicate to userspace that an event has 128 128 occurred on the corresponding kernel object. 129 129 130 - If your new :manpage:`xyzzy(2)` system call involves a filename argument:: 130 + If your new xyzzy(2) system call involves a filename argument:: 131 131 132 132 int sys_xyzzy(const char __user *path, ..., unsigned int flags); 133 133 134 - you should also consider whether an :manpage:`xyzzyat(2)` version is more appropriate:: 134 + you should also consider whether an xyzzyat(2) version is more appropriate:: 135 135 136 136 int sys_xyzzyat(int dfd, const char __user *path, ..., unsigned int flags); 137 137 138 138 This allows more flexibility for how userspace specifies the file in question; 139 139 in particular it allows userspace to request the functionality for an 140 140 already-opened file descriptor using the ``AT_EMPTY_PATH`` flag, effectively 141 - giving an :manpage:`fxyzzy(3)` operation for free:: 141 + giving an fxyzzy(3) operation for free:: 142 142 143 143 - xyzzyat(AT_FDCWD, path, ..., 0) is equivalent to xyzzy(path,...) 144 144 - xyzzyat(fd, "", ..., AT_EMPTY_PATH) is equivalent to fxyzzy(fd, ...) ··· 147 147 :manpage:`openat(2)` man page; for an example of AT_EMPTY_PATH, see the 148 148 :manpage:`fstatat(2)` man page.) 149 149 150 - If your new :manpage:`xyzzy(2)` system call involves a parameter describing an 150 + If your new xyzzy(2) system call involves a parameter describing an 151 151 offset within a file, make its type ``loff_t`` so that 64-bit offsets can be 152 152 supported even on 32-bit architectures. 153 153 154 - If your new :manpage:`xyzzy(2)` system call involves privileged functionality, 154 + If your new xyzzy(2) system call involves privileged functionality, 155 155 it needs to be governed by the appropriate Linux capability bit (checked with 156 156 a call to ``capable()``), as described in the :manpage:`capabilities(7)` man 157 157 page. Choose an existing capability bit that governs related functionality, ··· 160 160 the power of root. In particular, avoid adding new uses of the already 161 161 overly-general ``CAP_SYS_ADMIN`` capability. 162 162 163 - If your new :manpage:`xyzzy(2)` system call manipulates a process other than 163 + If your new xyzzy(2) system call manipulates a process other than 164 164 the calling process, it should be restricted (using a call to 165 165 ``ptrace_may_access()``) so that only a calling process with the same 166 166 permissions as the target process, or with the necessary capabilities, can ··· 196 196 Generic System Call Implementation 197 197 ---------------------------------- 198 198 199 - The main entry point for your new :manpage:`xyzzy(2)` system call will be called 199 + The main entry point for your new xyzzy(2) system call will be called 200 200 ``sys_xyzzy()``, but you add this entry point with the appropriate 201 201 ``SYSCALL_DEFINEn()`` macro rather than explicitly. The 'n' indicates the 202 202 number of arguments to the system call, and the macro takes the system call name

+8 -8

Documentation/translations/it_IT/process/adding-syscalls.rst

··· 124 124 accesso da spazio utente quando il kernel ha già dei meccanismi e una semantica 125 125 ben definita per utilizzare i descrittori di file. 126 126 127 - Se la vostra nuova chiamata di sistema :manpage:`xyzzy(2)` ritorna un nuovo 127 + Se la vostra nuova chiamata di sistema xyzzy(2) ritorna un nuovo 128 128 descrittore di file, allora l'argomento *flags* dovrebbe includere un valore 129 129 equivalente a ``O_CLOEXEC`` per i nuovi descrittori. Questo rende possibile, 130 130 nello spazio utente, la chiusura della finestra temporale fra le chiamate a ··· 140 140 per la lettura o la scrittura è il tipico modo del kernel per notificare lo 141 141 spazio utente circa un evento associato all'oggetto del kernel. 142 142 143 - Se la vostra nuova chiamata di sistema :manpage:`xyzzy(2)` ha un argomento 143 + Se la vostra nuova chiamata di sistema xyzzy(2) ha un argomento 144 144 che è il percorso ad un file:: 145 145 146 146 int sys_xyzzy(const char __user *path, ..., unsigned int flags); 147 147 148 148 dovreste anche considerare se non sia più appropriata una versione 149 - :manpage:`xyzzyat(2)`:: 149 + `xyzzyat(2)`:: 150 150 151 151 int sys_xyzzyat(int dfd, const char __user *path, ..., unsigned int flags); 152 152 ··· 154 154 in questione; in particolare, permette allo spazio utente di richiedere la 155 155 funzionalità su un descrittore di file già aperto utilizzando il *flag* 156 156 ``AT_EMPTY_PATH``, in pratica otterremmo gratuitamente l'operazione 157 - :manpage:`fxyzzy(3)`:: 157 + fxyzzy(3):: 158 158 159 159 - xyzzyat(AT_FDCWD, path, ..., 0) is equivalent to xyzzy(path,...) 160 160 - xyzzyat(fd, "", ..., AT_EMPTY_PATH) is equivalent to fxyzzy(fd, ...) ··· 163 163 man :manpage:`openat(2)`; per un esempio di AT_EMPTY_PATH, leggere la pagina 164 164 man :manpage:`fstatat(2)`). 165 165 166 - Se la vostra nuova chiamata di sistema :manpage:`xyzzy(2)` prevede un parametro 166 + Se la vostra nuova chiamata di sistema xyzzy(2) prevede un parametro 167 167 per descrivere uno scostamento all'interno di un file, usate ``loff_t`` come 168 168 tipo cosicché scostamenti a 64-bit potranno essere supportati anche su 169 169 architetture a 32-bit. 170 170 171 - Se la vostra nuova chiamata di sistema :manpage:`xyzzy(2)` prevede l'uso di 171 + Se la vostra nuova chiamata di sistema xyzzy(2) prevede l'uso di 172 172 funzioni riservate, allora dev'essere gestita da un opportuno bit di privilegio 173 173 (verificato con una chiamata a ``capable()``), come descritto nella pagina man 174 174 :manpage:`capabilities(7)`. Scegliete un bit di privilegio già esistente per ··· 178 178 evitate di aggiungere nuovi usi al fin-troppo-generico privilegio 179 179 ``CAP_SYS_ADMIN``. 180 180 181 - Se la vostra nuova chiamata di sistema :manpage:`xyzzy(2)` manipola altri 181 + Se la vostra nuova chiamata di sistema xyzzy(2) manipola altri 182 182 processi oltre a quello chiamato, allora dovrebbe essere limitata (usando 183 183 la chiamata ``ptrace_may_access()``) di modo che solo un processo chiamante 184 184 con gli stessi permessi del processo in oggetto, o con i necessari privilegi, ··· 219 219 ------------------------------------------------ 220 220 221 221 Il principale punto d'accesso alla vostra nuova chiamata di sistema 222 - :manpage:`xyzzy(2)` verrà chiamato ``sys_xyzzy()``; ma, piuttosto che in modo 222 + `xyzzy(2)` verrà chiamato ``sys_xyzzy()``; ma, piuttosto che in modo 223 223 esplicito, lo aggiungerete tramite la macro ``SYSCALL_DEFINEn``. La 'n' 224 224 indica il numero di argomenti della chiamata di sistema; la macro ha come 225 225 argomento il nome della chiamata di sistema, seguito dalle coppie (tipo, nome)

+8 -8

Documentation/translations/sp_SP/process/adding-syscalls.rst

··· 128 128 userspace cuando el kernel ya tiene mecanismos y semánticas bien definidas 129 129 para usar los descriptores de archivos. 130 130 131 - Si su nueva llamada a sistema :manpage:`xyzzy(2)` retorna un nuevo 131 + Si su nueva llamada a sistema xyzzy(2) retorna un nuevo 132 132 descriptor de archivo, entonces el argumento flag debe incluir un valor que 133 133 sea equivalente a definir ``O_CLOEXEC`` en el nuevo FD. Esto hace posible 134 134 al userspace acortar la brecha de tiempo entre ``xyzzy()`` y la llamada a ··· 145 145 indique al espacio de usuario que un evento ha ocurrido en el 146 146 correspondiente objeto del kernel. 147 147 148 - Si su nueva llamada de sistema :manpage:`xyzzy(2)` involucra algún nombre 148 + Si su nueva llamada de sistema xyzzy(2) involucra algún nombre 149 149 de archivo como argumento:: 150 150 151 151 int sys_xyzzy(const char __user *path, ..., unsigned int flags); 152 152 153 - debería considerar también si una versión :manpage:`xyzzyat(2)` es mas 153 + debería considerar también si una versión xyzzyat(2) es mas 154 154 apropiada:: 155 155 156 156 int sys_xyzzyat(int dfd, const char __user *path, ..., unsigned int flags); ··· 158 158 Esto permite más flexibilidad en como el userspace especifica el archivo en 159 159 cuestión; en particular esto permite al userspace pedir la funcionalidad a 160 160 un descriptor de archivo ya abierto usando el flag ``AT_EMPTY_PATH``, 161 - efectivamente dando una operación :manpage:`fxyzzy(3)` gratis:: 161 + efectivamente dando una operación fxyzzy(3) gratis:: 162 162 163 163 - xyzzyat(AT_FDCWD, path, ..., 0) es equivalente a xyzzy(path, ...) 164 164 - xyzzyat(fd, "", ..., AT_EMPTY_PATH) es equivalente a fxyzzy(fd, ...) ··· 167 167 revise el man page :manpage:`openat(2)`; para un ejemplo de AT_EMPTY_PATH, 168 168 mire el man page :manpage:`fstatat(2)` manpage.) 169 169 170 - Si su nueva llamada de sistema :manpage:`xyzzy(2)` involucra un parámetro 170 + Si su nueva llamada de sistema xyzzy(2) involucra un parámetro 171 171 describiendo un describiendo un movimiento dentro de un archivo, ponga de 172 172 tipo ``loff_t`` para que movimientos de 64-bit puedan ser soportados 173 173 incluso en arquitecturas de 32-bit. 174 174 175 - Si su nueva llamada de sistema :manpage:`xyzzy` involucra una 175 + Si su nueva llamada de sistema xyzzy(2) involucra una 176 176 funcionalidad privilegiada, esta necesita ser gobernada por la capability 177 177 bit linux apropiada (revisado con una llamada a ``capable()``), como se 178 178 describe en el man page :manpage:`capabilities(7)`. Elija una parte de ··· 182 182 dividir el poder del usuario root. En particular, evite agregar nuevos usos 183 183 de la capacidad ya demasiado general de la capabilities ``CAP_SYS_ADMIN``. 184 184 185 - Si su nueva llamada de sistema :manpage:`xyzzy(2)` manipula un proceso que 185 + Si su nueva llamada de sistema xyzzy(2) manipula un proceso que 186 186 no es el proceso invocado, este debería ser restringido (usando una llamada 187 187 a ``ptrace_may_access()``) de forma que el único proceso con los mismos 188 188 permisos del proceso objetivo, o con las capacidades (capabilities) ··· 221 221 Implementation de Llamada de Sistema Generica 222 222 --------------------------------------------- 223 223 224 - La entrada principal a su nueva llamada de sistema :manpage:`xyzzy(2)` será 224 + La entrada principal a su nueva llamada de sistema xyzzy(2) será 225 225 llamada ``sys_xyzzy()``, pero incluya este punto de entrada con la macro 226 226 ``SYSCALL_DEFINEn()`` apropiada en vez de explicitamente. El 'n' indica el 227 227 numero de argumentos de la llamada de sistema, y la macro toma el nombre de

Configure Feed

Configure Feed