1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161
|
.\" (c) 1993 by Thomas Koenig (ig25@rz.uni-karlsruhe.de)
.\"
.\" Permission is granted to make and distribute verbatim copies of this
.\" manual provided the copyright notice and this permission notice are
.\" preserved on all copies.
.\"
.\" Permission is granted to copy and distribute modified versions of this
.\" manual under the conditions for verbatim copying, provided that the
.\" entire resulting derived work is distributed under the terms of a
.\" permission notice identical to this one
.\"
.\" Since the Linux kernel and libraries are constantly changing, this
.\" manual page may be incorrect or out-of-date. The author(s) assume no
.\" responsibility for errors or omissions, or for damages resulting from
.\" the use of the information contained herein. The author(s) may not
.\" have taken the same level of care in the production of this manual,
.\" which is licensed free of charge, as they might when working
.\" professionally.
.\"
.\" Formatted or processed versions of this manual, if unaccompanied by
.\" the source, must acknowledge the copyright and authors of this work.
.\" License.
.\" Modified Wed Jul 28 11:12:26 1993 by Rik Faith (faith@cs.unc.edu)
.\" Translated into Spanish Tue Jan 20 1998 by Gerardo Aburruzaga
.\" García <gerardo.aburruzaga@uca.es>
.\"
.TH FPATHCONF 3 "4 abril 1993" "GNU" "Manual del Programador de Linux"
.SH NOMBRE
fpathconf, pathconf \- obtiene valores de configuración para ficheros
.SH SINOPSIS
.nf
.B #include <unistd.h>
.sp
.BI "long fpathconf(int " descf ", int " nombre ");"
.nl
.BI "long pathconf(const char *" camino ", int " nombre ");"
.fi
.SH DESCRIPCIÓN
.B fpathconf()
obtiene un valor para la opción de configuración
.I nombre
para el descriptor de fichero abierto
.IR descf .
.PP
.B pathconf()
obtiene un valor para la opción de configuración
.I nombre
para el nombre de fichero
.IR camino .
.PP
Las correspondientes macros definidas en
.B <unistd.h>
son valores mínimos; si una aplicación quiere enterarse con seguridad
de valores que pueden cambiar, puede hacer una llamada a
.B fpathconf()
o a
.B pathconf()
obteniendo así resultados más liberales.
.PP
Hacer
.I nombre
igual a una de las siguientes constantes devuelve las siguientes
opciones de configuración:
.TP
.B _PC_LINK_MAX
devuelve el número máximo de enlaces al fichero. Si
.I descf
o
.I camino
se refieren a un directorio, entonces el valor se aplica al directorio
entero.
La macro correspondiente es
.BR _POSIX_LINK_MAX .
.TP
.B _PC_MAX_CANON
devuelve la longitud máxima de una línea de entrada formateada, donde
.I descf
o
.I camino
deben referirse a una terminal.
La macro correspondiente es
.BR _POSIX_MAX_CANON .
.TP
.B _PC_MAX_INPUT
devuelve la longitud máxima de una línea de entrada, donde
.I descf
o
.I camino
deben referirse a una terminal.
La macro correspondiente es
.BR _POSIX_MAX_INPUT .
.TP
.B _PC_NAME_MAX
devuelve la máxima longitud de un nombre de fichero en el directorio
.I camino
o
.I descf
que el proceso es capaz de crear.
La macro correspondiente es
.BR _POSIX_NAME_MAX .
.TP
.B _PC_PATH_MAX
devuelve la máxima longitud de un nombre de camino relativo donde
.I camino
o
.I descf
es el directorio de trabajo. La macro correspondiente es
.BR _POSIX_PATH_MAX .
.TP
.B _PC_PIPE_BUF
devuelve el tamaño del búfer de interconexión, donde
.I descf
debe referirse a una interconexión o FIFO y
.I camino
debe referirse a un fichero FIFO. La macro correspondiente es
.BR _POSIX_PIPE_BUF .
.TP
.B _PC_CHOWN_RESTRICTED
devuelve no-cero si la llamada
.BR chown (2)
no puede emplearse en este fichero. Si
.I descf
o
.I camino
se refieren a un directorio, entonces esto se aplica a todos los
ficheros de dicho directorio. La macro correspondiente es
.BR _POSIX_CHOWN_RESTRICTED .
.TP
.B _PC_NO_TRUNC
devuelve no-cero si acceder a nombres de ficheros de longitud mayor que
.B _POSIX_NAME_MAX
genera un error. La macro correspondiente es
.BR _POSIX_NO_TRUNC .
.TP
.B _PC_VDISABLE
devuelve no-cero si se puede inhabilitar el procesamiento de
caracteres especiales, donde
.I descf
o
.I camino
deben referirse a una terminal.
.SH "VALO DEVUELTO"
Se devuelve el límite, si es que existe. Si el sistema no tiene un
límite para el recurso pedido, se devuelve \-1 y
.I errno
permanece inalterado. Si hay un error, se devuelve \-1 y se pone un
valor en
.I errno
tal que refleje la naturaleza del error.
.SH "CONFORME A"
POSIX.1
.SH OBSERVACIONES
Pueden existir en el directorio dado ficheros cuyos nombres sean de
longitud mayor que el valor devuelto para
.I nombre
igual a \fB_PC_NAME_MAX\fP.
.PP
Algunos valores devueltos pueden ser enormes; no son adecuados para
pedir memoria.
.SH "VÉASE TAMBIÉN"
.BR getconf "(1), " statfs "(2), " open "(2), " sysconf (3)
|