#, fuzzy msgid "" msgstr "" "Project-Id-Version: man-pages-l10n VERSION\n" "POT-Creation-Date: 2014-07-17 17:57+0900\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" #. type: TH #: man-pages-posix/man0p/sys_stat.h.0p:2 #, no-wrap msgid "sys_stat.h" msgstr "" #. type: TH #: man-pages-posix/man0p/sys_stat.h.0p:2 #, no-wrap msgid "2013" msgstr "" #. type: TH #: man-pages-posix/man0p/sys_stat.h.0p:2 #, no-wrap msgid "IEEE/The Open Group" msgstr "" #. type: TH #: man-pages-posix/man0p/sys_stat.h.0p:2 #, no-wrap msgid "POSIX Programmer's Manual" msgstr "" #. type: SH #: man-pages-posix/man0p/sys_stat.h.0p:3 #, no-wrap msgid "PROLOG" msgstr "" #. type: Plain text #: man-pages-posix/man0p/sys_stat.h.0p:8 msgid "" "This manual page is part of the POSIX Programmer's Manual. The Linux " "implementation of this interface may differ (consult the corresponding Linux " "manual page for details of Linux behavior), or the interface may not be " "implemented on Linux." msgstr "" #. type: SH #: man-pages-posix/man0p/sys_stat.h.0p:9 #, no-wrap msgid "NAME" msgstr "" #. type: Plain text #: man-pages-posix/man0p/sys_stat.h.0p:12 msgid "sys/stat.h \\(em data returned by the stat(\\|) function" msgstr "" #. type: SH #: man-pages-posix/man0p/sys_stat.h.0p:12 #, no-wrap msgid "SYNOPSIS" msgstr "" #. type: Plain text #: man-pages-posix/man0p/sys_stat.h.0p:16 #, no-wrap msgid "#include Esys/stat.hE\n" msgstr "" #. type: SH #: man-pages-posix/man0p/sys_stat.h.0p:17 #, no-wrap msgid "DESCRIPTION" msgstr "" #. type: Plain text #: man-pages-posix/man0p/sys_stat.h.0p:26 msgid "" "The Isys/stat.hE> header shall define the structure of the data " "returned by the I(), I(), and I() functions." msgstr "" #. type: Plain text #: man-pages-posix/man0p/sys_stat.h.0p:32 msgid "" "The Isys/stat.hE> header shall define the B structure, which " "shall include at least the following members:" msgstr "" #. type: Plain text #: man-pages-posix/man0p/sys_stat.h.0p:57 #, no-wrap msgid "" "B<\n" "dev_t st_dev >Device ID of device containing file.\n" "ino_t st_ino File serial number.\n" "mode_t st_mode Mode of file (see below).\n" "nlink_t st_nlink Number of hard links to the file.\n" "uid_t st_uid User ID of file.\n" "gid_t st_gid Group ID of file.\n" "dev_t st_rdev Device ID (if file is character or block special).\n" "off_t st_size For regular files, the file size in bytes.\n" " For symbolic links, the length in bytes of the\n" " pathname contained in the symbolic link.\n" " For a shared memory object, the length in bytes.\n" " For a typed memory object, the length in bytes.\n" " For other file types, the use of this field is\n" " unspecified.\n" "struct timespec st_atim Last data access timestamp.\n" "struct timespec st_mtim Last data modification timestamp.\n" "struct timespec st_ctim Last file status change timestamp.\n" "blksize_t st_blksize A file system-specific preferred I/O block size\n" " for this object. In some file system types, this\n" " may vary from file to file.\n" "blkcnt_t st_blocks Number of blocks allocated for this object.\n" msgstr "" #. type: Plain text #: man-pages-posix/man0p/sys_stat.h.0p:66 msgid "" "The I and I fields taken together uniquely identify the file " "within the system." msgstr "" #. type: Plain text #: man-pages-posix/man0p/sys_stat.h.0p:83 msgid "" "The Isys/stat.hE> header shall define the B, " "B, B, B, B, B, B, B, " "B, and B types as described in Isys/types.hE>." msgstr "" #. type: Plain text #: man-pages-posix/man0p/sys_stat.h.0p:91 msgid "" "The Isys/stat.hE> header shall define the B structure as " "described in Itime.hE>. Times shall be given in seconds since the " "Epoch." msgstr "" #. type: Plain text #: man-pages-posix/man0p/sys_stat.h.0p:99 msgid "" "Which structure members have meaningful values depends on the type of file. " "For further information, see the descriptions of I(), I(), and " "I() in the System Interfaces volume of POSIX.1\\(hy2008." msgstr "" #. type: Plain text #: man-pages-posix/man0p/sys_stat.h.0p:113 msgid "" "For compatibility with earlier versions of this standard, the I " "macro shall be defined with the value I. Similarly, " "I and I shall be defined as macros with the values " "I and I, respectively." msgstr "" #. type: Plain text #: man-pages-posix/man0p/sys_stat.h.0p:123 msgid "" "The Isys/stat.hE> header shall define the following symbolic " "constants for the file types encoded in type B. The values shall be " "suitable for use in B<#if> preprocessing directives:" msgstr "" #. type: IP #: man-pages-posix/man0p/sys_stat.h.0p:123 #, no-wrap msgid "S_IFMT" msgstr "" #. type: Plain text #: man-pages-posix/man0p/sys_stat.h.0p:125 msgid "Type of file." msgstr "" #. type: IP #: man-pages-posix/man0p/sys_stat.h.0p:126 #, no-wrap msgid "S_IFBLK" msgstr "" #. type: Plain text #: man-pages-posix/man0p/sys_stat.h.0p:128 msgid "Block special." msgstr "" #. type: IP #: man-pages-posix/man0p/sys_stat.h.0p:128 #, no-wrap msgid "S_IFCHR" msgstr "" #. type: Plain text #: man-pages-posix/man0p/sys_stat.h.0p:130 msgid "Character special." msgstr "" #. type: IP #: man-pages-posix/man0p/sys_stat.h.0p:130 #, no-wrap msgid "S_IFIFO" msgstr "" #. type: Plain text #: man-pages-posix/man0p/sys_stat.h.0p:132 msgid "FIFO special." msgstr "" #. type: IP #: man-pages-posix/man0p/sys_stat.h.0p:132 #, no-wrap msgid "S_IFREG" msgstr "" #. type: Plain text #: man-pages-posix/man0p/sys_stat.h.0p:134 msgid "Regular." msgstr "" #. type: IP #: man-pages-posix/man0p/sys_stat.h.0p:134 #, no-wrap msgid "S_IFDIR" msgstr "" #. type: Plain text #: man-pages-posix/man0p/sys_stat.h.0p:136 msgid "Directory." msgstr "" #. type: IP #: man-pages-posix/man0p/sys_stat.h.0p:136 #, no-wrap msgid "S_IFLNK" msgstr "" #. type: Plain text #: man-pages-posix/man0p/sys_stat.h.0p:138 msgid "Symbolic link." msgstr "" #. type: IP #: man-pages-posix/man0p/sys_stat.h.0p:138 #, no-wrap msgid "S_IFSOCK" msgstr "" #. type: Plain text #: man-pages-posix/man0p/sys_stat.h.0p:140 msgid "Socket." msgstr "" #. type: Plain text #: man-pages-posix/man0p/sys_stat.h.0p:156 msgid "" "The Isys/stat.hE> header shall define the following symbolic " "constants for the file mode bits encoded in type B, with the " "indicated numeric values. These macros shall expand to an expression which " "has a type that allows them to be used, either singly or OR'ed together, as " "the third argument to I() without the need for a B cast. The " "values shall be suitable for use in B<#if> preprocessing directives." msgstr "" #. type: tbl table #: man-pages-posix/man0p/sys_stat.h.0p:160 #, no-wrap msgid "Name@Numeric Value@Description\n" msgstr "" #. type: tbl table #: man-pages-posix/man0p/sys_stat.h.0p:161 man-pages-posix/man0p/sys_stat.h.0p:166 man-pages-posix/man0p/sys_stat.h.0p:171 man-pages-posix/man0p/sys_stat.h.0p:176 #, no-wrap msgid "_\n" msgstr "" #. type: tbl table #: man-pages-posix/man0p/sys_stat.h.0p:162 #, no-wrap msgid "S_IRWXU@0700@Read, write, execute/search by owner.\n" msgstr "" #. type: tbl table #: man-pages-posix/man0p/sys_stat.h.0p:163 #, no-wrap msgid "S_IRUSR@0400@Read permission, owner.\n" msgstr "" #. type: tbl table #: man-pages-posix/man0p/sys_stat.h.0p:164 #, no-wrap msgid "S_IWUSR@0200@Write permission, owner.\n" msgstr "" #. type: tbl table #: man-pages-posix/man0p/sys_stat.h.0p:165 #, no-wrap msgid "S_IXUSR@0100@Execute/search permission, owner.\n" msgstr "" #. type: tbl table #: man-pages-posix/man0p/sys_stat.h.0p:167 #, no-wrap msgid "S_IRWXG@070@Read, write, execute/search by group.\n" msgstr "" #. type: tbl table #: man-pages-posix/man0p/sys_stat.h.0p:168 #, no-wrap msgid "S_IRGRP@040@Read permission, group.\n" msgstr "" #. type: tbl table #: man-pages-posix/man0p/sys_stat.h.0p:169 #, no-wrap msgid "S_IWGRP@020@Write permission, group.\n" msgstr "" #. type: tbl table #: man-pages-posix/man0p/sys_stat.h.0p:170 #, no-wrap msgid "S_IXGRP@010@Execute/search permission, group.\n" msgstr "" #. type: tbl table #: man-pages-posix/man0p/sys_stat.h.0p:172 #, no-wrap msgid "S_IRWXO@07@Read, write, execute/search by others.\n" msgstr "" #. type: tbl table #: man-pages-posix/man0p/sys_stat.h.0p:173 #, no-wrap msgid "S_IROTH@04@Read permission, others.\n" msgstr "" #. type: tbl table #: man-pages-posix/man0p/sys_stat.h.0p:174 #, no-wrap msgid "S_IWOTH@02@Write permission, others.\n" msgstr "" #. type: tbl table #: man-pages-posix/man0p/sys_stat.h.0p:175 #, no-wrap msgid "S_IXOTH@01@Execute/search permission, others.\n" msgstr "" #. type: tbl table #: man-pages-posix/man0p/sys_stat.h.0p:177 #, no-wrap msgid "S_ISUID@04000@Set-user-ID on execution.\n" msgstr "" #. type: tbl table #: man-pages-posix/man0p/sys_stat.h.0p:178 #, no-wrap msgid "S_ISGID@02000@Set-group-ID on execution.\n" msgstr "" #. type: tbl table #: man-pages-posix/man0p/sys_stat.h.0p:179 #, no-wrap msgid "\\*!S_ISVTX@01000@On directories, restricted deletion flag.\\0\\0\\0\\*?\n" msgstr "" #. type: Plain text #: man-pages-posix/man0p/sys_stat.h.0p:191 msgid "" "The following macros shall be provided to test whether a file is of the " "specified type. The value I supplied to the macros is the value of " "I from a B structure. The macro shall evaluate to a non-zero " "value if the test is true; 0 if the test is false." msgstr "" #. type: IP #: man-pages-posix/man0p/sys_stat.h.0p:191 #, no-wrap msgid "S_ISBLK(I)" msgstr "" #. type: Plain text #: man-pages-posix/man0p/sys_stat.h.0p:193 msgid "Test for a block special file." msgstr "" #. type: IP #: man-pages-posix/man0p/sys_stat.h.0p:193 #, no-wrap msgid "S_ISCHR(I)" msgstr "" #. type: Plain text #: man-pages-posix/man0p/sys_stat.h.0p:195 msgid "Test for a character special file." msgstr "" #. type: IP #: man-pages-posix/man0p/sys_stat.h.0p:195 #, no-wrap msgid "S_ISDIR(I)" msgstr "" #. type: Plain text #: man-pages-posix/man0p/sys_stat.h.0p:197 msgid "Test for a directory." msgstr "" #. type: IP #: man-pages-posix/man0p/sys_stat.h.0p:197 #, no-wrap msgid "S_ISFIFO(I)" msgstr "" #. type: Plain text #: man-pages-posix/man0p/sys_stat.h.0p:199 msgid "Test for a pipe or FIFO special file." msgstr "" #. type: IP #: man-pages-posix/man0p/sys_stat.h.0p:199 #, no-wrap msgid "S_ISREG(I)" msgstr "" #. type: Plain text #: man-pages-posix/man0p/sys_stat.h.0p:201 msgid "Test for a regular file." msgstr "" #. type: IP #: man-pages-posix/man0p/sys_stat.h.0p:201 #, no-wrap msgid "S_ISLNK(I)" msgstr "" #. type: Plain text #: man-pages-posix/man0p/sys_stat.h.0p:203 msgid "Test for a symbolic link." msgstr "" #. type: IP #: man-pages-posix/man0p/sys_stat.h.0p:203 #, no-wrap msgid "S_ISSOCK(I)" msgstr "" #. type: Plain text #: man-pages-posix/man0p/sys_stat.h.0p:205 msgid "Test for a socket." msgstr "" #. type: Plain text #: man-pages-posix/man0p/sys_stat.h.0p:220 msgid "" "The implementation may implement message queues, semaphores, or shared " "memory objects as distinct file types. The following macros shall be " "provided to test whether a file is of the specified type. The value of the " "I argument supplied to the macros is a pointer to a B structure. " "The macro shall evaluate to a non-zero value if the specified object is " "implemented as a distinct file type and the specified file type is contained " "in the B structure referenced by I. Otherwise, the macro shall " "evaluate to zero." msgstr "" #. type: IP #: man-pages-posix/man0p/sys_stat.h.0p:220 #, no-wrap msgid "S_TYPEISMQ(I)" msgstr "" #. type: Plain text #: man-pages-posix/man0p/sys_stat.h.0p:222 msgid "Test for a message queue." msgstr "" #. type: IP #: man-pages-posix/man0p/sys_stat.h.0p:222 #, no-wrap msgid "S_TYPEISSEM(I)" msgstr "" #. type: Plain text #: man-pages-posix/man0p/sys_stat.h.0p:224 msgid "Test for a semaphore." msgstr "" #. type: IP #: man-pages-posix/man0p/sys_stat.h.0p:224 #, no-wrap msgid "S_TYPEISSHM(I)" msgstr "" #. type: Plain text #: man-pages-posix/man0p/sys_stat.h.0p:226 msgid "Test for a shared memory object." msgstr "" #. type: Plain text #: man-pages-posix/man0p/sys_stat.h.0p:240 msgid "" "The implementation may implement typed memory objects as distinct file " "types, and the following macro shall test whether a file is of the specified " "type. The value of the I argument supplied to the macros is a pointer " "to a B structure. The macro shall evaluate to a non-zero value if the " "specified object is implemented as a distinct file type and the specified " "file type is contained in the B structure referenced by I. " "Otherwise, the macro shall evaluate to zero." msgstr "" #. type: IP #: man-pages-posix/man0p/sys_stat.h.0p:240 #, no-wrap msgid "S_TYPEISTMO(I)" msgstr "" #. type: Plain text #: man-pages-posix/man0p/sys_stat.h.0p:242 msgid "Test macro for a typed memory object." msgstr "" #. type: Plain text #: man-pages-posix/man0p/sys_stat.h.0p:254 msgid "" "The Isys/stat.hE> header shall define the following symbolic " "constants as distinct integer values outside of the range " "[0,999\\|999\\|999], for use with the I() and I() " "functions: UTIME_NOW UTIME_OMIT" msgstr "" #. type: Plain text #: man-pages-posix/man0p/sys_stat.h.0p:257 msgid "" "The following shall be declared as functions and may also be defined as " "macros. Function prototypes shall be provided." msgstr "" #. type: Plain text #: man-pages-posix/man0p/sys_stat.h.0p:277 #, no-wrap msgid "" "B<\n" "int chmod(const char *, mode_t);\n" "int fchmod(int, mode_t);\n" "int fchmodat(int, const char *, mode_t, int);\n" "int fstat(int, struct stat *);\n" "int fstatat(int, const char *restrict, struct stat *restrict, int);\n" "int futimens(int, const struct timespec [2]);\n" "int lstat(const char *restrict, struct stat *restrict);\n" "int mkdir(const char *, mode_t);\n" "int mkdirat(int, const char *, mode_t);\n" "int mkfifo(const char *, mode_t);\n" "int mkfifoat(int, const char *, mode_t);\n" "int mknod(const char *, mode_t, dev_t);\n" "int mknodat(int, const char *, mode_t, dev_t);\n" "int stat(const char *restrict, struct stat *restrict);\n" "mode_t umask(mode_t);\n" "int utimensat(int, const char *, const struct timespec [2], int);>\n" msgstr "" #. type: Plain text #: man-pages-posix/man0p/sys_stat.h.0p:282 msgid "I" msgstr "" #. type: SH #: man-pages-posix/man0p/sys_stat.h.0p:282 #, no-wrap msgid "APPLICATION USAGE" msgstr "" #. type: Plain text #: man-pages-posix/man0p/sys_stat.h.0p:284 msgid "Use of the macros is recommended for determining the type of a file." msgstr "" #. type: SH #: man-pages-posix/man0p/sys_stat.h.0p:284 #, no-wrap msgid "RATIONALE" msgstr "" #. type: Plain text #: man-pages-posix/man0p/sys_stat.h.0p:292 msgid "" "A conforming C-language application must include Isys/stat.hE> for " "functions that have arguments or return values of type B, so that " "symbolic values for that type can be used. An alternative would be to " "require that these constants are also defined by including Isys/types." "hE>." msgstr "" #. type: Plain text #: man-pages-posix/man0p/sys_stat.h.0p:297 msgid "" "The S_ISUID and S_ISGID bits may be cleared on any write, not just on " "I(), as some historical implementations do." msgstr "" #. type: Plain text #: man-pages-posix/man0p/sys_stat.h.0p:304 msgid "" "System calls that update the time entry fields in the B structure must " "be documented by the implementors. POSIX-conforming systems should not " "update the time entry fields for functions listed in the System Interfaces " "volume of POSIX.1\\(hy2008 unless the standard requires that they do, except " "in the case of documented extensions to the standard." msgstr "" #. type: Plain text #: man-pages-posix/man0p/sys_stat.h.0p:319 msgid "" "Upon assignment, file timestamps are immediately converted to the resolution " "of the file system by truncation (i.e., the recorded time can be older than " "the actual time). For example, if the file system resolution is 1 " "microsecond, then a conforming I() must always return an I that is a multiple of 1000. Some older implementations returned " "higher-resolution timestamps while the I information was cached, and " "then spontaneously truncated the I fields when they were stored to " "and retrieved from disk, but this behavior does not conform." msgstr "" #. type: Plain text #: man-pages-posix/man0p/sys_stat.h.0p:324 msgid "" "Note that I must be unique within a Local Area Network (LAN) in a " "``system'' made up of multiple computers' file systems connected by a LAN." msgstr "" #. type: Plain text #: man-pages-posix/man0p/sys_stat.h.0p:334 msgid "" "Networked implementations of a POSIX-conforming system must guarantee that " "all files visible within the file tree (including parts of the tree that may " "be remotely mounted from other machines on the network) on each individual " "processor are uniquely identified by the combination of the I and " "I fields." msgstr "" #. type: Plain text #: man-pages-posix/man0p/sys_stat.h.0p:350 msgid "" "The unit for the I member of the B structure is not defined " "within POSIX.1\\(hy2008. In some implementations it is 512 bytes. It may " "differ on a file system basis. There is no correlation between values of the " "I and I, and the I (from Isys/statvfs." "hE>) structure members." msgstr "" #. type: Plain text #: man-pages-posix/man0p/sys_stat.h.0p:356 msgid "" "Traditionally, some implementations defined the multiplier for I " "in Isys/param.hE> as the symbol DEV_BSIZE." msgstr "" #. type: Plain text #: man-pages-posix/man0p/sys_stat.h.0p:366 msgid "" "Some earlier versions of this standard did not specify values for the file " "mode bit macros. The expectation was that some implementors might choose to " "use a different encoding for these bits than the traditional one, and that " "new applications would use symbolic file modes instead of numeric. This " "version of the standard specifies the traditional encoding, in recognition " "that nearly 20 years after the first publication of this standard numeric " "file modes are still in widespread use by application developers, and that " "all conforming implementations still use the traditional encoding." msgstr "" #. type: SH #: man-pages-posix/man0p/sys_stat.h.0p:366 #, no-wrap msgid "FUTURE DIRECTIONS" msgstr "" #. type: Plain text #: man-pages-posix/man0p/sys_stat.h.0p:375 msgid "" "No new S_IFMT symbolic names for the file type values of B will be " "defined by POSIX.1\\(hy2008; if new file types are required, they will only " "be testable through I(\\|) or I(\\|) macros instead." msgstr "" #. type: SH #: man-pages-posix/man0p/sys_stat.h.0p:375 #, no-wrap msgid "SEE ALSO" msgstr "" #. type: Plain text #: man-pages-posix/man0p/sys_stat.h.0p:379 msgid "" "Bsys_statvfs.hE>, Bsys_types.hE>, Btime.hE>" msgstr "" #. type: Plain text #: man-pages-posix/man0p/sys_stat.h.0p:390 msgid "" "The System Interfaces volume of POSIX.1\\(hy2008, I\\^(\\|), " "I\\^(\\|), I\\^(\\|), I\\^(\\|), " "I\\^(\\|), I\\^(\\|), I\\^(\\|), I\\^(\\|), " "I\\^(\\|)" msgstr "" #. type: SH #: man-pages-posix/man0p/sys_stat.h.0p:390 #, no-wrap msgid "COPYRIGHT" msgstr "" #. type: Plain text #: man-pages-posix/man0p/sys_stat.h.0p:401 msgid "" "Portions of this text are reprinted and reproduced in electronic form from " "IEEE Std 1003.1, 2013 Edition, Standard for Information Technology -- " "Portable Operating System Interface (POSIX), The Open Group Base " "Specifications Issue 7, Copyright (C) 2013 by the Institute of Electrical " "and Electronics Engineers, Inc and The Open Group. (This is POSIX.1-2008 " "with the 2013 Technical Corrigendum 1 applied.) In the event of any " "discrepancy between this version and the original IEEE and The Open Group " "Standard, the original IEEE and The Open Group Standard is the referee " "document. The original Standard can be obtained online at http://www.unix." "org/online.html ." msgstr "" #. type: Plain text #: man-pages-posix/man0p/sys_stat.h.0p:406 msgid "" "Any typographical or formatting errors that appear in this page are most " "likely to have been introduced during the conversion of the source files to " "man page format. To report such errors, see https://www.kernel.org/doc/man-" "pages/reporting_bugs.html ." msgstr ""