diff options
author | Andreas Gruenbacher <andreas.gruenbacher@gmail.com> | 2015-04-14 23:53:11 +0200 |
---|---|---|
committer | Andreas Gruenbacher <andreas.gruenbacher@gmail.com> | 2015-04-15 01:44:57 +0200 |
commit | 8d1263bca95722d66a6f8e83450f49d0956ea534 (patch) | |
tree | d8ee6e2d8f263ab196854ad1d931468a1a7d7e69 /man/man2/setxattr.2 | |
parent | 07cdd574b01309599c5ceddcd3d6553a5f5cd75d (diff) | |
download | attr-8d1263bca95722d66a6f8e83450f49d0956ea534.tar.gz |
Remove the section 2 man pages
The section 2 man pages have long since been added to the man-pages package
which documents all system calls; they were disabled in attr by default since
January 2014. Get rid of them here.
Diffstat (limited to 'man/man2/setxattr.2')
-rw-r--r-- | man/man2/setxattr.2 | 143 |
1 files changed, 0 insertions, 143 deletions
diff --git a/man/man2/setxattr.2 b/man/man2/setxattr.2 deleted file mode 100644 index b20dc9f..0000000 --- a/man/man2/setxattr.2 +++ /dev/null @@ -1,143 +0,0 @@ -.\" -.\" Extended attributes system calls manual pages -.\" -.\" (C) Andreas Gruenbacher, February 2001 -.\" (C) Silicon Graphics Inc, September 2001 -.\" -.\" This is free documentation; you can redistribute it and/or -.\" modify it under the terms of the GNU General Public License as -.\" published by the Free Software Foundation; either version 2 of -.\" the License, or (at your option) any later version. -.\" -.\" The GNU General Public License's references to "object code" -.\" and "executables" are to be interpreted as the output of any -.\" document formatting or typesetting system, including -.\" intermediate and printed output. -.\" -.\" This manual is distributed in the hope that it will be useful, -.\" but WITHOUT ANY WARRANTY; without even the implied warranty of -.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the -.\" GNU General Public License for more details. -.\" -.\" You should have received a copy of the GNU General Public -.\" License along with this manual. If not, see -.\" <http://www.gnu.org/licenses/>. -.\" -.TH SETXATTR 2 "Extended Attributes" "Dec 2001" "System calls" -.SH NAME -setxattr, lsetxattr, fsetxattr \- set an extended attribute value -.SH SYNOPSIS -.fam C -.nf -.B #include <sys/types.h> -.B #include <attr/xattr.h> -.sp -.BI "int setxattr (const char\ *" path ", const char\ *" name ", -.BI "\t\t\t const void\ *" value ", size_t " size ", int " flags ); -.BI "int lsetxattr (const char\ *" path ", const char\ *" name ", -.BI "\t\t\t const void\ *" value ", size_t " size ", int " flags ); -.BI "int fsetxattr (int " filedes ", const char\ *" name ", -.BI "\t\t\t const void\ *" value ", size_t " size ", int " flags ); -.fi -.fam T -.SH DESCRIPTION -Extended attributes are -.IR name :\c -.I value -pairs associated with inodes (files, directories, symlinks, etc). -They are extensions to the normal attributes which are associated -with all inodes in the system (i.e. the -.BR stat (2) -data). -A complete overview of extended attributes concepts can be found in -.BR attr (5). -.PP -.B setxattr -sets the -.I value -of the extended attribute identified by -.I name -and associated with the given -.I path -in the filesystem. -The -.I size -of the -.I value -must be specified. -.PP -.B lsetxattr -is identical to -.BR setxattr , -except in the case of a symbolic link, where the extended attribute is -set on the link itself, not the file that it refers to. -.PP -.B fsetxattr -is identical to -.BR setxattr , -only the extended attribute is set on the open file pointed to by -.I filedes -(as returned by -.BR open (2)) -in place of -.IR path . -.PP -An extended attribute name is a simple NULL-terminated string. -The -.I name -includes a namespace prefix \- there may be several, disjoint -namespaces associated with an individual inode. -The -.I value -of an extended attribute is a chunk of arbitrary textual or -binary data of specified length. -.PP -The -.I flags -parameter can be used to refine the semantics of the operation. -XATTR_CREATE specifies a pure create, which fails if the named -attribute exists already. -XATTR_REPLACE specifies a pure replace operation, which fails if the -named attribute does not already exist. -By default (no flags), the extended attribute will be created if -need be, or will simply replace the value if the attribute exists. -.SH RETURN VALUE -On success, zero is returned. -On failure, \-1 is returned and -.I errno -is set appropriately. -.PP -If XATTR_CREATE is specified, and the attribute exists already, -.I errno -is set to EEXIST. -If XATTR_REPLACE is specified, and the attribute does not exist, -.I errno -is set to ENOATTR. -.PP -If there is insufficient space remaining to store the extended attribute, -.I errno -is set to either ENOSPC, or EDQUOT if quota enforcement was the cause. -.PP -If extended attributes are not supported by the filesystem, or are disabled, -.I errno -is set to ENOTSUP. -.PP -The errors documented for the -.BR stat (2) -system call are also applicable here. -.SH AUTHORS -Andreas Gruenbacher, -.RI < a.gruenbacher@bestbits.at > -and the SGI XFS development team, -.RI < linux-xfs@oss.sgi.com >. -Please send any bug reports or comments to these addresses. -.SH SEE ALSO -.BR getfattr (1), -.BR setfattr (1), -.BR open (2), -.BR stat (2), -.BR getxattr (2), -.BR listxattr (2), -.BR removexattr (2), -and -.BR attr (5). |