Commit Graph

13796 Commits

Author SHA1 Message Date
Stéphane Aulery f6ab153e73 resolv.conf.5: Document RES_SNGLKUPREOP
Fix Ubuntu bug #1110781:
https://bugs.launchpad.net/ubuntu/+source/manpages/+bug/1110781
This bug have been partially resolved by commit
aa87a3f3f8 and tagged
fixed-upstream by Simon Paillard for Debian bug #699387.

The Ubuntu bug #1110781 report is more comprehensive and passing
I saw that RES_SNGLKUPREOP was missed.

Reported-by: Thomas Hood <jdthood@gmail.com>
Signed-off-by: Stéphane Aulery <saulery@free.fr>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-22 12:04:26 +02:00
Michael Kerrisk 174dfad254 resolv.conf.5: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-22 11:08:02 +02:00
Stéphane Aulery 7d9f4717fd resolv.conf.5: Document use-vc option added to glibc 2.14
Fix Ubuntu bug #1110781:
https://bugs.launchpad.net/ubuntu/+source/manpages/+bug/1110781

Reported-by: Thomas Hood <jdthood@gmail.com>
Signed-off-by: Stéphane Aulery <saulery@free.fr>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-22 11:07:35 +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
Michael Kerrisk 5d993ac57d attr.5: New link to attr(7)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-22 08:40:37 +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
Michael Kerrisk 44b1f5a0c2 stat.2: Minor fixes
Reported-by: Andreas Grünbacher <andreas.gruenbacher@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-21 16:50:34 +02:00
Michael Kerrisk bba094e3f9 stat.2: Remove excessive leading zeros on some constants
Reported-by: Andreas Grünbacher <andreas.gruenbacher@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-21 16:35:23 +02:00
Michael Kerrisk addfd6c39c stat.2: Wording tweaks to Jann Horn's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-21 15:56:15 +02:00
Michael Kerrisk 5ec64a3abd mkdir.2: Further tweaks to text on S_ISVTX and 'mode' argument
Reported-by: Andreas Grünbacher <andreas.gruenbacher@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-21 15:50:05 +02:00
Michael Kerrisk 1dab8564e2 stat.2: Add text on POSIX terms "file mode bits" and "file permission bits"
Recent changes to various pages employ this distinction.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-21 15:42:40 +02:00
Michael Kerrisk 3a9c5a29b6 open.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-21 15:42:40 +02:00
Michael Kerrisk 7e64d33c18 shutdown.2: BUGS: UNIX domain sockets now detect invalid 'how' values
Bug fixed in Linux 3.7.
See https://bugzilla.kernel.org/show_bug.cgi?id=47111

Reported-by: Stéphane Aulery <saulery@free.fr>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-21 15:42:31 +02:00
Michael Kerrisk 5b12fe6d92 resolver.3: Add descriptions of some other resolver functions
Add res_ninit(), res_nquery(), res_nsearch(),
and res_nquerydomain(), res_nmkquery(), res_nsend().

Reported-by: Jonathan Nieder <jrnieder@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-21 15:01:13 +02:00
Michael Kerrisk 11e8504e29 resolver.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-21 15:01:13 +02:00
Michael Kerrisk b6a4576f23 res_ninit.3, res_nmkquery.3, res_nquery.3, res_nquerydomain.3, res_nsearch.3, res_nsend.3: New links to resolver(3) man page
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-21 15:01:13 +02:00
Stéphane Aulery 25fe58e4c7 resolver.3: Add info about RES_INSECURE1 and RES_INSECURE2 option in debug mode
Signed-off-by: Stéphane Aulery <saulery@free.fr>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-21 14:59:59 +02:00
William Woodruff b9e14fc975 undocumented.3: Remove documented functions
Signed-off-by: William Woodruff <william@tuffbizz.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-21 14:45:25 +02:00
Michael Kerrisk 64639e9aa6 stat.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-21 14:44:20 +02:00
Jann Horn f240296dee stat.2: Add note about stat() being racy
The same thing was fixed for execve() in kernel commit
8b01fc86b9f425899f8a3a8fc1c47d73c2c20543, but for performance
reasons, that simple patch won't work for stat().

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-21 14:40:39 +02:00
Michael Kerrisk 9e1d8950a2 open.2: open() honors the S_ISVTX, S_ISUID, and S_ISGID bits in 'mode'
Reported-by: Andreas Gruenbacher <agruenba@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-21 14:37:15 +02:00
Michael Kerrisk 10ef5a5549 mkdir.2: Fix a small error added by Andreas's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-21 14:37:15 +02:00
Michael Kerrisk 2fc8395c2b mkdir.2: Wording fixes + point reader at stat(2) for explanation of file mode
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-21 14:37:09 +02:00
Michael Kerrisk 9fcca5a033 mknod.2: Rewordings + point reader at stat(2) for details of mode bits
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-21 14:37:09 +02:00
Michael Kerrisk 58222012f8 open.2: Tighten wording: use 'mode bit' rather than 'permission bit'
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-21 14:37:09 +02:00
Michael Kerrisk a57c98a000 mkdir.2, mknod.2, open.2, umask.2: Tweaks to Andreas's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-21 14:37:09 +02:00
Andreas Gruenbacher 5d817eb475 umask.2, open.2, mknod.2, mkdir.2: Explain what default ACLs do
Explain the effect that default ACLs have (instead of the umask)
in umask.2.  Mention that default ACLs can have an affect in
open.2, mknod.2, and mkdir.2.

Signed-off-by: Andreas Gruenbacher <agruenba@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-21 14:37:09 +02:00