Heinrich Schuchardt | 23 Oct 22:09 2014
Picon
Picon

[PATCH 1/1] fanotify.7: double mounted paths

Unfortunately fanotify does not inform listeners for all paths
under which a touched file system object is visible
but only the listener using the same path as the process
touching the file system object.

Signed-off-by: Heinrich Schuchardt <xypron.glpk@...>
---
 man7/fanotify.7 | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/man7/fanotify.7 b/man7/fanotify.7
index bc5a11c..7f915c2 100644
--- a/man7/fanotify.7
+++ b/man7/fanotify.7
 <at>  <at>  -488,6 +488,14  <at>  <at>  In this case, events are lost.
 As of Linux 3.17,
 the following bugs exist:
 .IP * 3
+On Linux a file system object may be accessible through multiple paths,
+e.g. a part of the file system may be remounted using
+.B mount (8)
+--bind.
+A listener that marked a mount will only be notified of events that were
+triggered for a file system object using the same mount.
+Any other event will pass unnoticed.
+.IP *
 .\" FIXME . A patch was proposed.
 When an event is generated,
 no check is made to see whether the user ID of the
--

-- 
(Continue reading)

Heinrich Schuchardt | 23 Oct 22:06 2014
Picon
Picon

[PATCH 1/1] fanotify.7: kernel version in BUGS section

Change kernel version in BUGS section to 3.17

Signed-off-by: Heinrich Schuchardt <xypron.glpk@...>
---
 man7/fanotify.7 | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/man7/fanotify.7 b/man7/fanotify.7
index b6456d5..bc5a11c 100644
--- a/man7/fanotify.7
+++ b/man7/fanotify.7
 <at>  <at>  -485,7 +485,7  <at>  <at>  Monitoring mounts offers the capability to monitor a whole directory tree.
 The event queue can overflow.
 In this case, events are lost.
 .SH BUGS
-As of Linux 3.15,
+As of Linux 3.17,
 the following bugs exist:
 .IP * 3
 .\" FIXME . A patch was proposed.
--

-- 
2.1.1

--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo@...
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Andreas Schwab | 21 Oct 12:58 2014
Picon

[PATCH] prctl.2: Correct description of null-termination in PR_[GS]ET_NAME

The size of the process name has always been at most 16 byte _including_
the null terminator.  This also means that the name returned by
PR_GET_NAME is always null-terminated.

Signed-off-by: Andreas Schwab <schwab@...>
---
 man2/prctl.2 | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/man2/prctl.2 b/man2/prctl.2
index 1199891..4351ff9 100644
--- a/man2/prctl.2
+++ b/man2/prctl.2
 <at>  <at>  -240,7 +240,7  <at>  <at>  using the value in the location pointed to by
 .IR "(char\ *) arg2" .
 The name can be up to 16 bytes long,
 .\" TASK_COMM_LEN in include/linux/sched.h
-and should be null-terminated if it contains fewer bytes.
+including the terminating null byte.
 This is the same attribute that can be set via
 .BR pthread_setname_np (3)
 and retrieved using
 <at>  <at>  -256,7 +256,7  <at>  <at>  Return the name of the calling thread,
 in the buffer pointed to by
 .IR "(char\ *) arg2" .
 The buffer should allow space for up to 16 bytes;
-the returned string will be null-terminated if it is shorter than that.
+the returned string will be null-terminated.
 .TP
 .BR PR_SET_NO_NEW_PRIVS " (since Linux 3.5)"
(Continue reading)

Josh Triplett | 20 Oct 10:08 2014

[PATCH] sysconf.3: Document _SC_NGROUPS_MAX

Already documented in getgroups(2), but not in sysconf(3).

Signed-off-by: Josh Triplett <josh@...>
---
 man3/sysconf.3 | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/man3/sysconf.3 b/man3/sysconf.3
index dc1ea5c..9f6c5c0 100644
--- a/man3/sysconf.3
+++ b/man3/sysconf.3
 <at>  <at>  -154,6 +154,9  <at>  <at>  Must not be less than
 .B _POSIX_LOGIN_NAME_MAX
 (9).
 .TP
+.BR NGROUPS_MAX " - " _SC_NGROUPS_MAX
+Maximum number of supplementary group IDs.
+.TP
 .BR "" "clock ticks - " _SC_CLK_TCK
 The number of clock ticks per second.
 The corresponding variable is obsolete.
--

-- 
2.1.1

--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo@...
More majordomo info at  http://vger.kernel.org/majordomo-info.html

(Continue reading)

Josh Triplett | 20 Oct 10:07 2014

[PATCH] credentials.7: Cross-reference getgroups(2)

Since credentials.7 discusses supplementary GIDs, it should reference
getgroups(2).

Signed-off-by: Josh Triplett <josh@...>
---
 man7/credentials.7 | 1 +
 1 file changed, 1 insertion(+)

diff --git a/man7/credentials.7 b/man7/credentials.7
index 51d5312..acb799d 100644
--- a/man7/credentials.7
+++ b/man7/credentials.7
 <at>  <at>  -309,6 +309,7  <at>  <at>  is carried through to all of the POSIX threads in a process.
 .BR execve (2),
 .BR faccessat (2),
 .BR fork (2),
+.BR getgroups (2),
 .BR getpgrp (2),
 .BR getpid (2),
 .BR getppid (2),
--

-- 
2.1.1

--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo@...
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Michael Kerrisk (man-pages | 20 Oct 07:47 2014
Picon

For review: attributes(7) man page

Hello Haitao, and all,

I have taken the text written by Alexandre Oliva and provided by Carlos
to create a draft attributes(7) page for man-pages.

The page was created by:

1. Taking Alexandre's text (which appears in the glibc manual).
2. Stripping out all details except those relating to MT-Safety,
   since currently man-pages does not document details of AC-Safety
   and AS-Safety. (Text for the latter does however remain in the
   man page source, as commented out text.)
3. Making minor wording improvements/fixes to fit with man-pages
   conventions.

Haitao, would you be willing to review, to check that the page
is consistent with the patches that you have been making to
the man pages? I have appended the page source below.

Carlos, Alexandre, if you have any comments on the approach
I've taken, please let me know.

Cheers,

Michael

.\" Copyright (c) 2014, Red Hat, Inc.
.\"
.\" %%%LICENSE_START(GPLv2+_DOC_FULL)
.\" This is free documentation; you can redistribute it and/or
(Continue reading)

Marko Myllynen | 20 Oct 07:25 2014
Picon

[PATCH] locale.5: describe the formats of values

Hi,

locale(5) described what a locale should define but didn't spell out how (in what format). The patch below
attempts to address this, it also has few trivial additional enhancements.

---

Reference to locale(7) for category descriptions.

Clarify first_workday in NOTES a bit.

Add upstream BZ reference for two missing LC_ADDRESS fields.
---
 man5/locale.5 |   73 ++++++++++++++++++++++++++++++++++++++++++---------------
 1 files changed, 54 insertions(+), 19 deletions(-)

diff --git a/man5/locale.5 b/man5/locale.5
index 5bdb728..80e23ff 100644
--- a/man5/locale.5
+++ b/man5/locale.5
 <at>  <at>  -1,3 +1,4  <at>  <at> 
+'\" t -*- coding: UTF-8 -*-
 .\" Copyright (C) 1994  Jochen Hein (Hein@...)
 .\" Copyright (C) 2008  Petr Baudis (pasky@...)
 .\" Copyright (C) 2014 Michael Kerrisk <mtk <at> manpages@...>
 <at>  <at>  -54,7 +55,22  <at>  <at>  can be defined from scratch.
 If the category should be copied,
 the only valid keyword in the definition is
 .B copy
-followed by the name of the locale which should be copied.
(Continue reading)

Marko Myllynen | 20 Oct 07:23 2014
Picon

Subject: [PATCH] locale.7: improve LOCPATH description


LOCPATH is ignored by privileged programs.

Add locale archive references.

Add FILES section.

---
 man7/locale.7 |   22 ++++++++++++++++------
 1 files changed, 16 insertions(+), 6 deletions(-)

diff --git a/man7/locale.7 b/man7/locale.7
index 6270739..3fb2ad3 100644
--- a/man7/locale.7
+++ b/man7/locale.7
 <at>  <at>  -330,17 +330,20  <at>  <at>  The following environment variable is used by
 .BR newlocale (3)
 and
 .BR setlocale (3),
-and thus affects all localized programs:
+and thus affects all unprivileged localized programs:
 .TP
 .B LOCPATH
 A list of pathnames, separated by colons (\(aq:\(aq),
 that should be used to find locale data.
-If this variable is set, only the individual locale data files from
+If this variable is set, only the individual compiled locale data files
+from
 .I LOCPATH
-and the system default locale data path are used; any available locale
(Continue reading)

Marko Myllynen | 20 Oct 07:21 2014
Picon

[PATCH] localedef.1: list default path for compiled files


---
 man1/localedef.1 |    3 +++
 1 files changed, 3 insertions(+), 0 deletions(-)

diff --git a/man1/localedef.1 b/man1/localedef.1
index 24da5d0..1f2cd7a 100644
--- a/man1/localedef.1
+++ b/man1/localedef.1
 <at>  <at>  -291,6 +291,9  <at>  <at>  Usual default repertoire map path.
 .TP
 .I /usr/lib/locale/locale-archive
 Usual default locale archive location.
+.TP 
+.I /usr/lib/locale               
+Usual default path for compiled individual locale data files.
 .TP
 .I outputpath/LC_ADDRESS
 An output file that contains information about formatting of
-- 
1.7.1

--

-- 
Marko Myllynen
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo@...
More majordomo info at  http://vger.kernel.org/majordomo-info.html

(Continue reading)

刘湃 | 20 Oct 05:23 2014

typos error in man page pthread_setschedparam(3)

In Example, Program source 

- fpe("\-i {e|s}         Set inherit scheduler attribute to\\n");
+ fpe("\-i {e|i}         Set inherit scheduler attribute to\\n");

- usage(argv[0], "Bad policy for main thread (-s)\n");
+ usage(argv[0], "Bad policy for main thread (-m)\n");
Florian Westphal | 19 Oct 22:21 2014
Picon

[PATCH v2] proc.5: Document /proc/net/netfilter/nfnetlink_queue

---
 Changes since v1:
 made a minor edit to better explain the difference between
 'dropped' and 'user dropped' counters.

 man5/proc.5 | 57 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 57 insertions(+)

diff --git a/man5/proc.5 b/man5/proc.5
index 7ca2226..da4b5b6 100644
--- a/man5/proc.5
+++ b/man5/proc.5
 <at>  <at>  -2770,6 +2770,63  <at>  <at>  not yet supported in the kernel).
 \&"St" is the internal state of the
 socket and Path is the bound path (if any) of the socket.
 .TP
+.I /proc/net/netfilter/nfnetlink_queue
+This file contains information about netfilter userspace queueing, if used.
+Each line represents a queue.  Queues that have not been subscribed to
+by userspace are not shown.
+.nf
+
+   1   4207     0  2 65535     0     0        0  1
+  (1)   (2)    (3)(4)  (5)    (6)   (7)      (8)
+.fi
+.IP
+The fields in each line are:
+.RS 7
+.TP 5
+(1)
(Continue reading)


Gmane