(split) Import translated manuals from JM CVS Repository.

[linuxjm/LDP_man-pages.git] / draft / man3 / fpathconf.3

.\" Copyright (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)
.\"
.\" Japanese Version Copyright (c) 1998 NAKANO Takeo all rights reserved.
.\" Translated Fri Mar 20 1998 by NAKANO Takeo <nakano@apm.seikei.ac.jp>
.\"
.TH FPATHCONF 3  1993-04-04 "GNU" "Linux Programmer's Manual"
.\"O .SH NAME
.SH ̾Á°
.\"O fpathconf, pathconf \- get configuration values for files
fpathconf, pathconf \- ¥Õ¥¡¥¤¥ë¤ÎÀßÄêÃͤò¼èÆÀ¤¹¤ë
.\"O .SH SYNOPSIS
.SH ½ñ¼°
.nf
.B #include <unistd.h>
.sp
.BI "long fpathconf(int " fd ", int " name );
.br
.BI "long pathconf(char *" path ", int " name );
.fi
.\"O .SH DESCRIPTION
.SH ÀâÌÀ
.\"O .BR fpathconf ()
.\"O gets a value for the configuration option
.\"O .I name
.\"O for the open file descriptor
.\"O .IR fd .
.BR fpathconf ()
¤Ï¥ª¡¼¥×¥ó¤µ¤ì¤Æ¤¤¤ë¥Õ¥¡¥¤¥ë¥Ç¥¹¥¯¥ê¥×¥¿¡¼
.I fd
¤ËÂФ·¤ÆÀßÄꤵ¤ì¤Æ¤¤¤ë¥ª¥×¥·¥ç¥ó
.I name
¤ÎÃͤò¼èÆÀ¤¹¤ë¡£
.PP
.\"O .BR pathconf ()
.\"O gets a value for configuration option
.\"O .I name
.\"O for the filename
.\"O .IR path .
.BR pathconf ()
¤Ï¥Õ¥¡¥¤¥ë̾
.I path
¤ËÂФ·¤ÆÀßÄꤵ¤ì¤Æ¤¤¤ë¥ª¥×¥·¥ç¥ó
.I name
¤ÎÃͤò¼èÆÀ¤¹¤ë¡£
.PP
.\"O The corresponding macros defined in
.\"O .I <unistd.h>
.\"O are minimum values; if an application wants to take advantage of values
.\"O which may change, a call to
.\"O .BR fpathconf ()
.\"O or
.\"O .BR pathconf ()
.\"O can be made, which may yield more liberal results.
Âбþ¤¹¤ë¥Þ¥¯¥í¤Î¤¦¤Á
.I <unistd.h>
¤ÇÄêµÁ¤µ¤ì¤Æ¤¤¤ë¤â¤Î¤ÏºÇ¾®ÃͤǤ¢¤ë¡£¥¢¥×¥ê¥±¡¼¥·¥ç¥ó¤Ë¤è¤Ã¤Æ¤Ï¤³¤ì¤é¤Î
ÃͤòÊѹ¹¤·¤Æ¤è¤êÍ­Íø¤ÊÆ°ºî¤ò¹Ô¤ª¤¦¤È¤¹¤ë¤â¤Î¤¬¤¢¤ë¡£¤³¤Î¾ì¹ç¤Ç¤â
.BR fpathconf ()
¤Þ¤¿¤Ï
.BR pathconf ()
¤Ï¸Æ¤Ó½Ð¤¹¤³¤È¤¬¤Ç¤­¤ë¡£¤³¤Î¾ì¹ç¤Ï¤è¤êÂ礭¤ÊÃͤ¬Ê֤뤳¤È¤Ë¤Ê¤í¤¦¡£
.PP
.\"O Setting
.\"O .I name
.\"O equal to one of the following constants returns the following
.\"O configuration options:
.I name
¤ò°Ê²¼¤ÎÄê¿ô¤Î¤É¤ì¤«¤Ë¤¹¤ë¤È¡¢Âбþ¤¹¤ëÀßÄꥪ¥×¥·¥ç¥ó¤¬ÊÖ¤µ¤ì¤ë¡£
.TP
.B _PC_LINK_MAX
.\"O returns the maximum number of links to the file.
.\"O If
.\"O .I fd
.\"O or
.\"O .I path
.\"O refer to a directory, then the value applies to the whole directory.
.\"O The corresponding macro is
.\"O .BR _POSIX_LINK_MAX .
¥Õ¥¡¥¤¥ë¤Ø¤Î¥ê¥ó¥¯¤ÎºÇÂç¿ô¤òÊÖ¤¹¡£
.I fd
¤Þ¤¿¤Ï
.I path
¤¬¥Ç¥£¥ì¥¯¥È¥ê¤Î¾ì¹ç¤Ï¡¢¤³¤ÎÃͤϥǥ£¥ì¥¯¥È¥êÁ´ÂΤËŬÍѤµ¤ì¤ë¡£Âбþ¤¹¤ë
¥Þ¥¯¥í¤Ï
.B _POSIX_LINK_MAX
¤Ç¤¢¤ë¡£
.TP
.B _PC_MAX_CANON
.\"O returns the maximum length of a formatted input line, where
.\"O .I fd
.\"O or
.\"O .I path
.\"O must refer to a terminal.
.\"O The corresponding macro is
.\"O .BR _POSIX_MAX_CANON .
¥Õ¥©¡¼¥Þ¥Ã¥ÈÉÕ¤­ÆþÎϹԤκÇÂçŤòÊÖ¤¹¡£¤³¤Î¤È¤­
.I fd
¤Þ¤¿¤Ï
.I path
¤ÏüËö¤ò»²¾È¤·¤Æ¤¤¤Ê¤±¤ì¤Ð¤Ê¤é¤Ê¤¤¡£
Âбþ¤¹¤ë¥Þ¥¯¥í¤Ï
.B _POSIX_MAX_CANON
¤Ç¤¢¤ë¡£
.TP
.B _PC_MAX_INPUT
.\"O returns the maximum length of an input line, where
.\"O .I fd
.\"O or
.\"O .I path
.\"O must refer to a terminal.
.\"O The corresponding macro is
.\"O .BR _POSIX_MAX_INPUT .
ÆþÎϹԤκÇÂçŤòÊÖ¤¹¡£¤³¤Î¤È¤­
.I fd
¤Þ¤¿¤Ï
.I path
¤ÏüËö¤ò»²¾È¤·¤Æ¤¤¤Ê¤±¤ì¤Ð¤Ê¤é¤Ê¤¤¡£
Âбþ¤¹¤ë¥Þ¥¯¥í¤Ï
.B _POSIX_MAX_INPUT
¤Ç¤¢¤ë¡£
.TP
.B _PC_NAME_MAX
.\"O returns the maximum length of a filename in the directory
.\"O .I path
.\"O or
.\"O .IR fd
.\"O that the process is allowed to create.
.\"O The corresponding macro is
.\"O .BR _POSIX_NAME_MAX .
¥Ç¥£¥ì¥¯¥È¥ê
.I path
¤Þ¤¿¤Ï
.I fd
Æâ¤Ë¡¢¤½¤Î¥×¥í¥»¥¹¤¬ºîÀ®¤¹¤ë¤³¤È¤¬¤Ç¤­¤ë¥Õ¥¡¥¤¥ë̾¤ÎºÇÂçŤòÊÖ¤¹¡£
Âбþ¤¹¤ë¥Þ¥¯¥í¤Ï
.B _POSIX_NAME_MAX
¤Ç¤¢¤ë¡£
.TP
.B _PC_PATH_MAX
.\"O returns the maximum length of a relative pathname when
.\"O .I path
.\"O or
.\"O .I fd
.\"O is the current working directory.
.\"O The corresponding macro is
.\"O .BR _POSIX_PATH_MAX .
.I path
¤Þ¤¿¤Ï
.I fd
¤¬¥«¥ì¥ó¥È¥Ç¥£¥ì¥¯¥È¥ê¤Î¾ì¹ç¡¢ÁêÂХѥ¹Ì¾¤ÎºÇÂçŤòÊÖ¤¹¡£
Âбþ¤¹¤ë¥Þ¥¯¥í¤Ï
.B _POSIX_PATH_MAX
¤Ç¤¢¤ë¡£
.TP
.B _PC_PIPE_BUF
.\"O returns the size of the pipe buffer, where
.\"O .I fd
.\"O must refer to a pipe or FIFO and
.\"O .I path
.\"O must refer to a FIFO.
.\"O The corresponding macro is
.\"O .BR _POSIX_PIPE_BUF .
¥Ñ¥¤¥× (pipe) ¥Ð¥Ã¥Õ¥¡¤Î¥µ¥¤¥º¤òÊÖ¤¹¡£¤³¤Î¤È¤­
.I fd
¤Ï¥Ñ¥¤¥×¤« FIFO ¤ò»²¾È¤·¤Æ¤¤¤Ê¤±¤ì¤Ð¤Ê¤é¤º¡¢
.I path
¤Ï FIFO ¤ò»²¾È¤·¤Æ¤¤¤Ê¤±¤ì¤Ð¤Ê¤é¤Ê¤¤¡£
Âбþ¤¹¤ë¥Þ¥¯¥í¤Ï
.B _POSIX_PIPE_BUF
¤Ç¤¢¤ë¡£
.TP
.B _PC_CHOWN_RESTRICTED
.\"O returns nonzero if the
.\"O .BR chown (2)
.\"O call may not be used on this file.
.\"O If
.\"O .I fd
.\"O or
.\"O .I path
.\"O refer to a directory, then this applies to all files in that
.\"O directory.
.\"O The corresponding macro is
.\"O .BR _POSIX_CHOWN_RESTRICTED .
¤³¤Î¥Õ¥¡¥¤¥ë¤ËÂФ¹¤ë
.BR chown (2)
¤Î¸Æ¤Ó½Ð¤·¤¬µö¤µ¤ì¤Æ¤¤¤Ê¤¤¾ì¹ç¤Ë¤Ï 0 °Ê³°¤ÎÃͤòÊÖ¤¹¡£
.I fd
¤Þ¤¿¤Ï
.I path
¤¬¥Ç¥£¥ì¥¯¥È¥ê¤ò»²¾È¤·¤Æ¤¤¤ë¾ì¹ç¤Ï¡¢¤³¤ÎÀ©¸Â¤Ï¤½¤Î¥Ç¥£¥ì¥¯¥È¥ê¤Î¤¹¤Ù¤Æ
¤Î¥Õ¥¡¥¤¥ë¤ËŬÍѤµ¤ì¤ë¡£
Âбþ¤¹¤ë¥Þ¥¯¥í¤Ï
.B _POSIX_CHOWN_RESTRICTED
¤Ç¤¢¤ë¡£
.TP
.B _PC_NO_TRUNC
.\"O returns nonzero if accessing filenames longer than
.\"O .B _POSIX_NAME_MAX
.\"O generates an error.
.\"O The corresponding macro is
.\"O .BR _POSIX_NO_TRUNC .
¥¢¥¯¥»¥¹Ãæ¤Î¥Õ¥¡¥¤¥ë̾¤¬
.B _POSIX_NAME_MAX
¤è¤ê¤âŤ¯¡¢¥¨¥é¡¼¤È¤Ê¤ë¾ì¹ç¤Ë¤Ï 0 °Ê³°¤ÎÃͤòÊÖ¤¹¡£
Âбþ¤¹¤ë¥Þ¥¯¥í¤Ï
.B _POSIX_NAME_MAX
¤Ç¤¢¤ë¡£
.TP
.B _PC_VDISABLE
.\"O returns nonzero if special character processing can be disabled, where
.\"O .I fd
.\"O or
.\"O .I path
.\"O must refer to a terminal.
Æüìʸ»ú (special character) ¤Î½èÍý¤¬µö¤µ¤ì¤Æ¤¤¤Ê¤¤¾ì¹ç¤Ï 0 °Ê³°¤ÎÃͤò
ÊÖ¤¹¡£¤³¤Î¤È¤­
.I fd
¤Þ¤¿¤Ï
.I path
¤ÏüËö¤ò»²¾È¤·¤Æ¤¤¤Ê¤±¤ì¤Ð¤Ê¤é¤Ê¤¤¡£
.\"O .SH "RETURN VALUE"
.SH ÊÖ¤êÃÍ
.\"O The limit is returned, if one exists.
.\"O If the system does not have a
.\"O limit for the requested resource, \-1 is returned, and
.\"O .I errno
.\"O is unchanged.
.\"O If there is an error, \-1 is returned, and
.\"O .I errno
.\"O is set to reflect the nature of the error.
(¸ºß¤·¤Æ¤¤¤ì¤Ð) À©¸ÂÃͤ¬ÊÖ¤µ¤ì¤ë¡£Í׵ᤵ¤ì¤¿¥ê¥½¡¼¥¹¤Ø¤Î¥·¥¹¥Æ¥à¤ÎÀ©
¸Â¤¬Â¸ºß¤·¤Æ¤¤¤Ê¤±¤ì¤Ð \-1 ¤¬ÊÖ¤µ¤ì¡¢
.I errno
¤ÏÊѹ¹¤µ¤ì¤Ê¤¤¡£¥¨¥é¡¼¤¬µ¯¤³¤Ã¤¿¾ì¹ç¤Ë¤Ï \-1 ¤¬ÊÖ¤µ¤ì¡¢
.I errno
¤¬¥¨¥é¡¼¤ËÂбþ¤·¤¿ÃͤËÀßÄꤵ¤ì¤ë¡£
.\"O .SH "CONFORMING TO"
.SH ½àµò
POSIX.1-2001.
.\"O .SH NOTES
.SH Ãí°Õ
.\"O Files with name lengths longer than the value returned for
.\"O .I name
.\"O equal to
.\"O .B _PC_NAME_MAX
.\"O may exist in the given directory.
.I name
¤Ë
.B _PC_NAME_MAX
¤òÆþ¤ì¤ÆÊÖ¤µ¤ì¤¿Ãͤè¤ê¤âŤ¤¥Õ¥¡¥¤¥ë̾¤ò»ý¤Ä¥Õ¥¡¥¤¥ë¤¬¡¢Í¿¤¨¤é¤ì¤¿¥Ç¥£
¥ì¥¯¥È¥ê¤Ë¸ºß¤¹¤ë¤«¤â¤·¤ì¤Ê¤¤¡£
.PP
.\"O Some returned values may be huge; they are not suitable for allocating
.\"O memory.
ÊÖ¤êÃͤÏÈó¾ï¤ËÂ礭¤ÊÃͤˤʤ뤳¤È¤â¤¢¤ë¡£¥á¥â¥ê¡¼¤Î³ä¤êÅö¤ÆÍѤÎÃͤˤÏÂç
¤­¤¹¤®¤ÆŬ¤µ¤Ê¤¤¤«¤âÃΤì¤Ê¤¤¡£
.\"O .SH "SEE ALSO"
.SH ´ØÏ¢¹àÌÜ
.BR getconf (1),
.BR open (2),
.BR statfs (2),
.BR sysconf (3)