Commit Graph

28 Commits

Author SHA1 Message Date
Michael Kerrisk 43834827b8 xattr.7: Rename from attr.7
"xattr" is a more meaningful name than "attr" (it resonates
with the names of the system calls), so as long as we are
moving the page to a new section, we'll change the name as well,
and retain an acl(5) link so that old references remain valid.

Reported-by: Christoph Hellwig <hch@infradead.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-22 14:38:56 +02:00
Michael Kerrisk 5c69f84a29 attr.7: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-22 13:46:26 +02:00
Andreas Grünbacher 54015724f8 attr.7: Minor tweaks
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-22 13:44:16 +02:00
Michael Kerrisk 7f4f24eaf1 attr.7: Document EA limits for Btrfs
From experimentation, I found a 16kB limit on name + value +
overhead bytes. Digger deeper, I see that
https://btrfs.wiki.kernel.org/index.php/Project_ideas#Unlimited_extended_attributes
says:

    Unlimited extended attributes

    Not claimed — no patches yet — Not in kernel yet

    Currently size of value of an extended attribute must fit into
    inline space (~3900 on 4k leaf size), while other filesystems
    do not limit the size. Add a new b-tree item to hold the xattr
    value in extents.

And reading mkfs.btrfs(8) reveals that the default node (AKA leaf)
size is 16kB.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-22 10:51:09 +02:00
Michael Kerrisk edb159da63 attr.7: Describe limit on EA values for JFS, XFS, and Reiserfs
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-22 10:42:38 +02:00
Michael Kerrisk 6db035a320 attr.7: Document VFS-imposed limits on EAs
VFS imposes a 255-byte limit on EA names, and a 64kB limit on
EA values.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-22 10:42:38 +02:00
Michael Kerrisk 3d33987bdb attr.7: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-22 10:42:38 +02:00
Michael Kerrisk 6ad46a9d8c attr.7: The ext[234] block limitation applies to sum of all EAs
It is not a per-EA limit.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-22 10:42:38 +02:00
Michael Kerrisk 9a7d1c23ae attr.7: ext2 and ext3 no longer need mounting with 'user_xattr' for user EAs
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-22 10:42:30 +02:00
Michael Kerrisk 03a93c3778 attr.7: Clarify permissions required to work with 'user' EAs
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-22 10:07:27 +02:00
Michael Kerrisk 7ee629abee attr.7: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-22 10:07:27 +02:00
Michael Kerrisk 355657c248 attr.7: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-22 10:07:27 +02:00
Michael Kerrisk 8d75a7a852 attr.7: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-22 10:07:27 +02:00
Michael Kerrisk b4a61f89a2 attr.7: wfix: remove unneeded statement that superuser has CAP_SYS_ADMIN
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-22 10:07:27 +02:00
Michael Kerrisk d8ba76940b attr.7: File capabilities are implemented using *security* attributes
Not *system* attributes

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-22 10:07:27 +02:00
Michael Kerrisk 68d53b6d9c attr.7: wfix (s/zero-terminated/null/terminated)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-22 10:07:27 +02:00
Michael Kerrisk 5871fb36fc attr.7: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-22 10:07:27 +02:00
Michael Kerrisk b124a27b19 attr.7: Add CONFORMING TO section
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-22 10:07:27 +02:00
Michael Kerrisk b68d4dc382 attr.7: Btrfs also supports extended attributes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-22 10:07:27 +02:00
Michael Kerrisk b5792ba5dc attr.7: ffix: s/reiserfs/Reiserfs/
For consistency with other man-pages pages.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-22 09:14:58 +02:00
Michael Kerrisk aad5c29757 attr.7: Add various relevant pages to SEE ALSO
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-22 09:11:27 +02:00
Michael Kerrisk 5ee7f61c3e attr.7: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-22 09:03:37 +02:00
Michael Kerrisk ca7d9e3443 attr.7: Minor tweaks
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-22 09:00:28 +02:00
Michael Kerrisk ebce8403ab attr.7: Minor wording fixes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-22 09:00:28 +02:00
Michael Kerrisk b63436d873 attr.7: Modify headings to man-pages norms
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-22 09:00:28 +02:00
Michael Kerrisk 31a369b843 attr.7: ffix: drop AUTHORS section
man-pages generally avoids AUTHORS sections.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-22 09:00:21 +02:00
Michael Kerrisk 933e467539 attr.7: srcfix: wrap long lines and wrap at end of sentences
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-22 08:50:55 +02:00
Andreas Gruenbacher 544a5910f7 attr.7: Import attr(5) man page from the 'attr' project
After discussions with Andreas Gruenbacher, it makes sense to
move this page into man-pages, since it mostly relates to
kernel details.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-22 08:34:32 +02:00