Re: [Acl-devel] Moving attr(5) man page to man-pages

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



Michael,

2015-04-22 10:55 GMT+02:00 Michael Kerrisk (man-pages) <mtk.manpages@xxxxxxxxx>:
> Hi Andreas,
> I'll move this page into Section 7, since that's where overview
> type pages such as this are normally placed in man-pages, but
> I'll also create a link in Section 5, so that acl(5) references
> will continue to work.

okay.

> I've made a number of edits to the page. Some of these were just
> to bring the page closer to man-pages style,

The \(em dashes don't render in terminals very well.

> but others were to amend incorrect technical details and add new
> details. I'd be pleased if you checked over these commits

Thanks, that all looks good.

In addition, I would remove the list of file systems with extended
attribute support; they are supported pretty much everywhere to some
degree at least, even on  tmpfs.

I'm attaching a patch that also includes a few other minor changes.

Thanks,
Andreas
diff --git a/man7/attr.7 b/man7/attr.7
index 75379e6..3fc8f76 100644
--- a/man7/attr.7
+++ b/man7/attr.7
@@ -48,11 +48,8 @@ Extended attributes are accessed as atomic objects.
 Reading retrieves the whole value of an attribute and stores it in a buffer.
 Writing replaces any previous value with the new value.
 .PP
-Space consumed for extended attributes is counted towards the disk quotas
+Space consumed for extended attributes may be counted towards the disk quotas
 of the file owner and file group.
-.PP
-Currently, the filesystems that support extended attributes include
-Btrfs, ext2, ext3, ext4, XFS, JFS, and Reiserfs.
 .SS Extended attribute namespaces
 Attribute names are null-terminated strings.
 The attribute name is always specified in the fully qualified
@@ -130,12 +127,13 @@ and access to extended user attributes is restricted to the
 owner and to users with appropriate capabilities for directories with the
 sticky bit set (see the
 .BR chmod (1)
-manual page for an explanation of Sticky Directories).
+manual page for an explanation of the sticky bit).
 .SS Filesystem differences
 The kernel and the filesystem may place limits on the maximum number
 and size of extended attributes that can be associated with a file.
 The VFS imposes limitations that an attribute names is limited to 255 bytes
-and an attribute value if limited to 64kB.
+and an attribute value if limited to 64 kB. The list of attribute names that
+can be returned is also limited to 64 kB.
 
 Some filesystems, such as Reiserfs (and, historically, ext2 and ext3),
 require the filesystem to be mounted with the
@@ -160,7 +158,7 @@ In the Btrfs filesystem implementation,
 the total bytes used for the name, value, and implementation overhead bytes
 is limited to the filesystem
 .I nodesize
-value (16kB by default).
+value (16 kB by default).
 .SH CONFORMING TO
 Extended attributes are not specified in POSIX.1, but some other systems
 (e.g., the BSDs and Solaris) provide a similar feature.

[Index of Archives]     [Kernel Documentation]     [Netdev]     [Linux Ethernet Bridging]     [Linux Wireless]     [Kernel Newbies]     [Security]     [Linux for Hams]     [Netfilter]     [Bugtraq]     [Yosemite News]     [MIPS Linux]     [ARM Linux]     [Linux RAID]     [Linux Admin]     [Samba]

  Powered by Linux