From 0854cf069b6db90842f5444f8d323235b1189d66 Mon Sep 17 00:00:00 2001 From: Gina Peter Banyard Date: Fri, 8 Nov 2024 09:41:42 +0000 Subject: [PATCH] Sync part of POSIX docs with EN to improve build situation --- reference/posix/configure.xml | 9 ++--- reference/posix/functions/posix-access.xml | 16 +++----- reference/posix/functions/posix-ctermid.xml | 21 +++++----- .../posix/functions/posix-get-last-error.xml | 8 +++- reference/posix/functions/posix-getcwd.xml | 17 ++++---- reference/posix/functions/posix-getegid.xml | 22 +++++----- reference/posix/functions/posix-geteuid.xml | 18 +++++---- reference/posix/functions/posix-getgid.xml | 20 ++++++---- reference/posix/functions/posix-getgroups.xml | 23 ++++++----- reference/posix/functions/posix-getlogin.xml | 23 ++++++----- reference/posix/functions/posix-getpgid.xml | 28 ++++++------- reference/posix/functions/posix-getpgrp.xml | 13 +++--- reference/posix/functions/posix-getpid.xml | 13 +++--- reference/posix/functions/posix-getppid.xml | 19 +++++---- reference/posix/functions/posix-getpwnam.xml | 18 ++++----- reference/posix/functions/posix-getpwuid.xml | 25 ++++++------ reference/posix/functions/posix-getsid.xml | 30 +++++++------- reference/posix/functions/posix-getuid.xml | 21 +++++----- .../posix/functions/posix-initgroups.xml | 23 +++++------ reference/posix/functions/posix-kill.xml | 26 ++++++------ reference/posix/functions/posix-mkfifo.xml | 18 ++++----- reference/posix/functions/posix-mknod.xml | 22 +++++----- reference/posix/functions/posix-setegid.xml | 11 +++-- reference/posix/functions/posix-seteuid.xml | 15 +++---- reference/posix/functions/posix-setgid.xml | 20 +++++----- reference/posix/functions/posix-setpgid.xml | 26 ++++++------ reference/posix/functions/posix-setrlimit.xml | 14 +++---- reference/posix/functions/posix-setsid.xml | 18 +++++---- reference/posix/functions/posix-setuid.xml | 20 +++++----- reference/posix/functions/posix-strerror.xml | 13 +++--- reference/posix/functions/posix-times.xml | 40 ++++++++++--------- reference/posix/functions/posix-uname.xml | 22 ++++++---- reference/posix/setup.xml | 25 +----------- 33 files changed, 328 insertions(+), 329 deletions(-) diff --git a/reference/posix/configure.xml b/reference/posix/configure.xml index 9d465af34..05965993f 100644 --- a/reference/posix/configure.xml +++ b/reference/posix/configure.xml @@ -1,12 +1,11 @@ - - + +
&reftitle.install; -Las funciones POSIX son habilitadas por defecto. Puede deshabilitar -las funciones tipo POSIX con . + &installation.enabled.disable; +
diff --git a/reference/posix/functions/posix-access.xml b/reference/posix/functions/posix-access.xml index 31e4499fb..761a35ea8 100644 --- a/reference/posix/functions/posix-access.xml +++ b/reference/posix/functions/posix-access.xml @@ -1,6 +1,5 @@ - - + posix_access @@ -12,8 +11,8 @@ &reftitle.description; boolposix_access - stringfile - intmodePOSIX_F_OK + stringfilename + intflags0 posix_access verifica el permiso del usuario sobre un archivo. @@ -25,7 +24,7 @@ - file + filename El nombre del archivo a ser probado. @@ -33,7 +32,7 @@ - mode + flags Una máscara consistente de uno o más de los valores POSIX_F_OK, @@ -91,10 +90,6 @@ if (posix_access($archivo, POSIX_R_OK | POSIX_W_OK)) { - - &reftitle.notes; - - &reftitle.seealso; @@ -106,7 +101,6 @@ if (posix_access($archivo, POSIX_R_OK | POSIX_W_OK)) { - - + posix_ctermid Obtener el nombre de la ruta del terminal controlador - + &reftitle.description; - stringposix_ctermid + stringfalseposix_ctermid Genera un string que es el nombre de la ruta del terminal - controlador actual para el proceso. En caso de error se establecerá a errno, + controlador actual para el proceso. En caso de error se establecerá a errno, que puede ser comprobado usando posix_get_last_error - + + + &reftitle.parameters; + &no.function.parameters; + + &reftitle.returnvalues; @@ -29,7 +33,7 @@ errno, que puede ser comprobado con posix_get_last_error. - + &reftitle.examples; @@ -48,7 +52,7 @@ echo "Esto ejecutándome desde ".posix_ctermid(); - + &reftitle.seealso; @@ -59,7 +63,6 @@ echo "Esto ejecutándome desde ".posix_ctermid(); - - + posix_get_last_error @@ -20,6 +19,11 @@ + + &reftitle.parameters; + &no.function.parameters; + + &reftitle.returnvalues; diff --git a/reference/posix/functions/posix-getcwd.xml b/reference/posix/functions/posix-getcwd.xml index ff91ec9f7..0e9ad19c3 100644 --- a/reference/posix/functions/posix-getcwd.xml +++ b/reference/posix/functions/posix-getcwd.xml @@ -1,17 +1,16 @@ - - + posix_getcwd Nombre de la ruta del directorio actual - + &reftitle.description; - stringposix_getcwd + stringfalseposix_getcwd @@ -21,6 +20,11 @@ + + &reftitle.parameters; + &no.function.parameters; + + &reftitle.returnvalues; @@ -49,7 +53,7 @@ echo 'Mi directorio actual de trabajo es '.posix_getcwd(); - + &reftitle.notes; @@ -62,13 +66,12 @@ echo 'Mi directorio actual de trabajo es '.posix_getcwd(); El nombre de la ruta ya no existe - + - - + posix_getegid Devuelve el ID efectivo de grupo del proceso actual - + &reftitle.description; @@ -18,14 +17,19 @@ Devuelve el ID efectivo de grupo efectivo numérico del proceso actual. - + + + &reftitle.parameters; + &no.function.parameters; + + &reftitle.returnvalues; - Devuelve un integer del ID del grupo efectivo. + Devuelve un int del ID del grupo efectivo. - + &reftitle.examples; @@ -48,7 +52,7 @@ echo 'Mi id del grupo efectivo es '.posix_getegid(); //40 - + &reftitle.notes; @@ -57,7 +61,7 @@ echo 'Mi id del grupo efectivo es '.posix_getegid(); //40 una llamada al proceso usando posix_setegid. - + &reftitle.seealso; @@ -68,7 +72,7 @@ echo 'Mi id del grupo efectivo es '.posix_getegid(); //40 - + - + posix_geteuid Devolver el ID efectivo de usuario del proceso actual - + &reftitle.description; @@ -20,14 +19,19 @@ convertirlo en un nombre de usuario utilizable. - + + + &reftitle.parameters; + &no.function.parameters; + + &reftitle.returnvalues; - Devuelve el id de usuario, como un valor de tipo integer + Devuelve el id de usuario, como un valor de tipo int - + &reftitle.examples; @@ -51,7 +55,7 @@ echo posix_geteuid()."\n"; //10000 - + &reftitle.seealso; diff --git a/reference/posix/functions/posix-getgid.xml b/reference/posix/functions/posix-getgid.xml index 48f657401..ff1baa4d8 100644 --- a/reference/posix/functions/posix-getgid.xml +++ b/reference/posix/functions/posix-getgid.xml @@ -1,13 +1,12 @@ - - + posix_getgid Devuelve el ID real de grupo del proceso actual - + &reftitle.description; @@ -18,14 +17,19 @@ Devuelve el ID real numérico de grupo del proceso actual. - + + + &reftitle.parameters; + &no.function.parameters; + + &reftitle.returnvalues; - Devuelve el id real de grupo, como un valor de tipo integer. + Devuelve el id real de grupo, como un valor de tipo int. - + &reftitle.examples; @@ -48,7 +52,7 @@ echo 'Mi id efectivo de grupo es '.posix_getegid(); //40 - + &reftitle.seealso; @@ -60,7 +64,7 @@ echo 'Mi id efectivo de grupo es '.posix_getegid(); //40 - + - + posix_getgroups Devolver el conjunto de grupos del proceso actual - + &reftitle.description; - arrayposix_getgroups + arrayfalseposix_getgroups Obtiene el conjunto de grupos del proceso actual. - + + + &reftitle.parameters; + &no.function.parameters; + + &reftitle.returnvalues; Devuelve un array de enteros que contiene los ids numéricos del conjunto - de grupos del proceso actual. + de grupos del proceso actual, &return.falseforfailure;. - + &reftitle.examples; @@ -66,7 +70,7 @@ Array - + &reftitle.seealso; @@ -75,9 +79,8 @@ Array - - + - + posix_getlogin Devuelve el nombre del inicio de sesión - + &reftitle.description; - stringposix_getlogin + stringfalseposix_getlogin Delvuelve el nombre del inicio de sesión del usuario propietarios del proceso actual. - + + + &reftitle.parameters; + &no.function.parameters; + + &reftitle.returnvalues; - Devuelve el nombre de inicio de sesión del usuario, como valor de tipo string. + Devuelve el nombre de inicio de sesión del usuario, como valor de tipo string, &return.falseforfailure;. - + &reftitle.examples; @@ -41,7 +45,7 @@ echo posix_getlogin(); //apache - + &reftitle.seealso; @@ -51,9 +55,8 @@ echo posix_getlogin(); //apache - - + - + posix_getpgid Obtener el id del grupo de procesos para un control de trabajo - + &reftitle.description; - intposix_getpgid - intpid + intfalseposix_getpgid + intprocess_id Devuelve el identificador del grupo de procesos del proceso - pid&return.falseforfailure;. + process_id&return.falseforfailure;. - + &reftitle.parameters; - pid + process_id El ide del proceso. @@ -35,14 +34,14 @@ - + &reftitle.returnvalues; - Devuelve el identificador, como valor de tipo integer. + Devuelve el identificador, como valor de tipo int. - + &reftitle.examples; @@ -59,7 +58,7 @@ echo posix_getpgid($pid); //35 - + &reftitle.notes; @@ -71,7 +70,7 @@ echo posix_getpgid($pid); //35 - + &reftitle.seealso; @@ -81,9 +80,8 @@ echo posix_getpgid($pid); //35 - - + - + posix_getpgrp Devolver el identificador de grupo de proceso actual - + &reftitle.description; @@ -19,10 +18,15 @@ + + &reftitle.parameters; + &no.function.parameters; + + &reftitle.returnvalues; - Devuelve el identificador, como valor de tipo integer. + Devuelve el identificador, como valor de tipo int. @@ -37,7 +41,6 @@ - - + posix_getpid Devolver el identificador del proceso actual - + &reftitle.description; @@ -19,10 +18,15 @@ + + &reftitle.parameters; + &no.function.parameters; + + &reftitle.returnvalues; - Devuelve el identificador, como valor de tipo integer. + Devuelve el identificador, como valor de tipo int. @@ -53,7 +57,6 @@ echo posix_getpid(); //8805 - - + posix_getppid Devolver el identificador del proceso padre - + &reftitle.description; @@ -19,14 +18,19 @@ proceso actual. - + + + &reftitle.parameters; + &no.function.parameters; + + &reftitle.returnvalues; - Devuelve el identificador, como valor de tipo integer. + Devuelve el identificador, como valor de tipo int. - + &reftitle.examples; @@ -42,9 +46,8 @@ echo posix_getppid(); //8259 - - + - + posix_getpwnam Devolver información sobre un usuario mediante su nombre de usuario - + &reftitle.description; - arrayposix_getpwnam + arrayfalseposix_getpwnam stringusername Devuelve un array de información sobre el usuario dado. - + &reftitle.parameters; @@ -34,7 +33,7 @@ - + &reftitle.returnvalues; @@ -113,7 +112,7 @@ - + &reftitle.examples; @@ -147,7 +146,7 @@ Array - + &reftitle.seealso; @@ -157,9 +156,8 @@ Array - - + - + posix_getpwuid Devolver información sobre un usuario mediante su id de usuario - + &reftitle.description; - arrayposix_getpwuid - intuid + arrayfalseposix_getpwuid + intuser_id Devuelve un array de información sobre el usuario denotado por el ID de usuario dado. - + &reftitle.parameters; - uid + user_id El identificador de usuario. @@ -35,7 +34,7 @@ - + &reftitle.returnvalues; @@ -70,7 +69,7 @@ uid El ID del usuario, debería ser el mismo que el del - parámetro uid empleado al llamar a la + parámetro user_id empleado al llamar a la función, y por lo tanto redundante. @@ -111,9 +110,10 @@ + La función devuelve &false; en caso de fallo. - + &reftitle.examples; @@ -147,7 +147,7 @@ Array - + &reftitle.seealso; @@ -157,9 +157,8 @@ Array - - + - + posix_getsid Obtener el sid actual del proceos - + &reftitle.description; - intposix_getsid - intpid + intfalseposix_getsid + intprocess_id - Devuelve el identificador de sesión del proceso pid. + Devuelve el identificador de sesión del proceso process_id. El identificador de sesión de un proceso es el id de grupo del proceso del líder de la sesión. - + &reftitle.parameters; - pid + process_id Eñ identificador de proceso. Si se establece a 0, se asume el proceso - actual. Si se especifica un pid no + actual. Si se especifica un process_id no válido, se devuelve &false; y se establece un error que puede ser verificado con posix_get_last_error. @@ -38,14 +37,14 @@ - + &reftitle.returnvalues; - Devuelve el identificador, como valor de tipo integer. + Devuelve el identificador, como valor de tipo int, &return.falseforfailure;. - + &reftitle.examples; @@ -62,7 +61,7 @@ echo posix_getsid($pid); //8805 - + &reftitle.seealso; @@ -77,10 +76,9 @@ echo posix_getsid($pid); //8805 - - - + + - + posix_getuid Devolver el ID real de usuario del proceso actual - + &reftitle.description; @@ -18,14 +17,19 @@ Devuelve el ID real numérico de usuario del proceso actual. - + + + &reftitle.parameters; + &no.function.parameters; + + &reftitle.returnvalues; - Devuelve el id de usuario, como valor de tipo integer + Devuelve el id de usuario, como valor de tipo int - + &reftitle.examples; @@ -41,7 +45,7 @@ echo posix_getuid(); //10000 - + &reftitle.seealso; @@ -52,9 +56,8 @@ echo posix_getuid(); //10000 - - + - + posix_initgroups Calcular la lista de acceso al grupo - + &reftitle.description; boolposix_initgroups - stringname - intbase_group_id + stringusername + intgroup_id Calcula la lista de acceso al grupo para el usuario especificado en el parámetro name. - + &reftitle.parameters; - name + username El usuario para el que se va a calcular la lista. @@ -33,7 +32,7 @@ - base_group_id + group_id Normalmente el número de grupo del fichero de contraseñas. @@ -43,14 +42,14 @@ - + &reftitle.returnvalues; &return.success; - + &reftitle.seealso; @@ -59,9 +58,8 @@ - - + - diff --git a/reference/posix/functions/posix-kill.xml b/reference/posix/functions/posix-kill.xml index fcdb6d1e1..ff5694ede 100644 --- a/reference/posix/functions/posix-kill.xml +++ b/reference/posix/functions/posix-kill.xml @@ -1,32 +1,31 @@ - - + posix_kill Enviar una señal a un proceso - + &reftitle.description; boolposix_kill - intpid - intsig + intprocess_id + intsignal - Envía la señal sig al proceso con - el identificador de proceso pid. + Envía la señal signal al proceso con + el identificador de proceso process_id. - + &reftitle.parameters; - pid + process_id El identificador de proceso. @@ -34,7 +33,7 @@ - sig + signal Una de las constantes de señales PCNTL. @@ -44,14 +43,14 @@ - + &reftitle.returnvalues; &return.success; - + &reftitle.seealso; @@ -64,9 +63,8 @@ - - + - + + posix_mkfifo @@ -11,8 +11,8 @@ &reftitle.description; boolposix_mkfifo - stringpathname - intmode + stringfilename + intpermissions posix_mkfifo crea un archivo FIFO @@ -26,7 +26,7 @@ - pathname + filename Ruta al archivo FIFO. @@ -34,10 +34,10 @@ - mode + permissions - El segundo parámetro modo tiene que ser + El segundo parámetro permissions tiene que ser definido en notación octal (p.ej. 0644). El permiso del FIFO recién creado depende también del valor umask actual. Los permisos del archivo creado @@ -56,10 +56,6 @@ - - &reftitle.notes; - - - + @@ -13,8 +12,8 @@ &reftitle.description; boolposix_mknod - stringpathname - intmode + stringfilename + intflags intmajor0 intminor0 @@ -22,13 +21,13 @@ Crea un fichero especial u ordinario. - + &reftitle.parameters; - pathname + filename El fichero a crear @@ -36,7 +35,7 @@ - mode + flags Este parámetro se construye mediante un operador a nivel de bits OR entre el tipo de fichero (una de @@ -67,14 +66,14 @@ - + &reftitle.returnvalues; &return.success; - + &reftitle.examples; @@ -100,7 +99,7 @@ if (!posix_mknod($fichero, $tipo | $permisos, $mayor, $menor)) { - + &reftitle.seealso; @@ -109,9 +108,8 @@ if (!posix_mknod($fichero, $tipo | $permisos, $mayor, $menor)) { - - + - + + posix_setegid @@ -11,7 +11,7 @@ &reftitle.description; boolposix_setegid - intgid + intgroup_id Establece el ID de grupo efectivo del proceso actual. Esta es una función @@ -25,7 +25,7 @@ - gid + group_id El id de grupo. @@ -78,7 +78,6 @@ echo 'Mi id de grupo efectivo es '.posix_getegid(); //40 - \ No newline at end of file +--> diff --git a/reference/posix/functions/posix-seteuid.xml b/reference/posix/functions/posix-seteuid.xml index 52a9b8c1a..cc83a9653 100644 --- a/reference/posix/functions/posix-seteuid.xml +++ b/reference/posix/functions/posix-seteuid.xml @@ -1,6 +1,6 @@ - - + + posix_seteuid @@ -11,10 +11,10 @@ &reftitle.description; boolposix_seteuid - intuid + intuser_id - Establece el ID de usuario real del proceso actual. Esta es una función + Establece el ID de usuario efectivo del proceso actual. Esta es una función privilegiada y se necesitan los permisos apropiados (usualmente root) en el sistema para tener la capacidad de ejecutar esta función. @@ -25,7 +25,7 @@ - uid + user_id El id de usuario. @@ -47,13 +47,14 @@ &reftitle.seealso; - posix_setgid + posix_geteuid + posix_setuid + posix_getuid - - + posix_setgid Establecer el GID de proceso actual - + &reftitle.description; boolposix_setgid - intgid + intgroup_id Establece el ID real de grupo al proceso actual. Esta en una @@ -29,13 +28,13 @@ - + &reftitle.parameters; - gid + group_id El id de grupo. @@ -45,14 +44,14 @@ - + &reftitle.returnvalues; &return.success; - + &reftitle.examples; @@ -74,7 +73,7 @@ echo 'Mi id efectivo de grupo es '.posix_getegid(); //40 - + &reftitle.seealso; @@ -84,9 +83,8 @@ echo 'Mi id efectivo de grupo es '.posix_getegid(); //40 - - + - + posix_setpgid Establecer el id de grupo de procesos para el control de trabajo - + &reftitle.description; boolposix_setpgid - intpid - intpgid + intprocess_id + intprocess_group_id - Permite al proceso pid unirse al grupo de procesos - pgid. + Permite al proceso process_id unirse al grupo de procesos + process_group_id. - + &reftitle.parameters; - pid + process_id El id del proceso. @@ -34,7 +33,7 @@ - pgid + process_group_id El id de grupo de procesos. @@ -44,14 +43,14 @@ - + &reftitle.returnvalues; &return.success; - + &reftitle.seealso; @@ -63,9 +62,8 @@ - - + - + posix_setrlimit Establecer los límites de recursos del sistema - + &reftitle.description; boolposix_setrlimit intresource - intsoftlimit - inthardlimit + intsoft_limit + inthard_limit posix_setrlimit establece los límites blando y duro para un @@ -38,7 +37,7 @@ - softlimit + soft_limit El límite blando, en la unidad que el límite del recurso requiera, o @@ -47,7 +46,7 @@ - hardlimit + hard_limit El límite duro, en la unidad que el límite del recurso requiera, o @@ -77,7 +76,6 @@ - - + posix_setsid Hacer del proceso actual un líder de sesión - + &reftitle.description; @@ -15,17 +14,22 @@ - Hace del proceso actual un líder de sesión. + Hace del proceso actual un líder de sesión. - + + + &reftitle.parameters; + &no.function.parameters; + + &reftitle.returnvalues; Devuelve un id de sesión, o -1 si ocurrió algún error. - + &reftitle.seealso; @@ -37,7 +41,7 @@ - + - + posix_setuid Establecer el UID del proceso actual - + &reftitle.description; boolposix_setuid - intuid + intuser_id Establece el ID real de usuario del proceso actual. Esta es una función @@ -20,13 +19,13 @@ sistema para que sea capaz de realizar esta función. - + &reftitle.parameters; - uid + user_id El id de usuario. @@ -36,14 +35,14 @@ - + &reftitle.returnvalues; &return.success; - + &reftitle.examples; @@ -65,7 +64,7 @@ echo posix_geteuid()."\n"; //10000 - + &reftitle.seealso; @@ -77,9 +76,8 @@ echo posix_geteuid()."\n"; //10000 - - + - + + posix_strerror @@ -11,12 +11,12 @@ &reftitle.description; stringposix_strerror - interrno + interror_code Devuelve el mensaje de error del sistema POSIX asociado con el - errno. Es posible obtener el parámetro - errno llamando la función + error_code. Es posible obtener el parámetro + error_code llamando la función posix_get_last_error. @@ -26,7 +26,7 @@ - errno + error_code Un número de error POSIX, devuelto por @@ -83,7 +83,6 @@ No such process - - + posix_times Obtener los tiempos de procesos - + &reftitle.description; - arrayposix_times + arrayfalseposix_times Obtiene informaciónsobre el uso actual de CPU. - + + + &reftitle.parameters; + &no.function.parameters; + + &reftitle.returnvalues; @@ -52,19 +56,10 @@ + La función devuelve &false; en caso de fallo. - - - &reftitle.notes; - - - Esta función no es fiable de usar, puede devolver valores negativos para - tiempos altos. - - - - + &reftitle.examples; @@ -96,9 +91,18 @@ Array - - + + &reftitle.notes; + + + Esta función no es fiable de usar, puede devolver valores negativos para + tiempos altos. + + + + + - + posix_uname Obtener el nombre del sistema - + &reftitle.description; - arrayposix_uname + arrayfalseposix_uname @@ -23,7 +22,12 @@ tres dígitos o cualquier otra cosa devuelta por esta función. - + + + &reftitle.parameters; + &no.function.parameters; + + &reftitle.returnvalues; @@ -56,8 +60,11 @@ campo solamente está disponible en sistemas GNU o cuando se usa GNU libc. + + La función devuelve &false; en caso de fallo. + - + &reftitle.examples; @@ -87,9 +94,8 @@ Array - - + - + + &reftitle.setup; - -
- &reftitle.required; - &no.requirement; -
- - &reference.posix.configure; - -
- &reftitle.runtime; - &no.config; -
- - - -
- &reftitle.resources; - &no.resource; -
- -