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)

Jan Chaloupka | 18 Oct 17:36 2014
Picon

[PATCH] unix.7: mentioning SOCK_STREAM socket for ioctl_type of ioctl function

from https://bugzilla.redhat.com/show_bug.cgi?id=1110401.

unix.7 is not clear about socket type of ioctl_type argument of ioctl
function. The description of SIOCINQ is applicable only for SOCK_STREAM
socket. For SOCK_DGRAM, udp(7) man page gives correct description of
SIOCINQ

Changelog: reformulation of referrence to udp(7) by Michael Kerrisk

Signed-off-by: Jan Chaloupka <jchaloup@...>
---
 man7/unix.7 |   14 ++++++++++++--
 1 file changed, 12 insertions(+), 2 deletions(-)

diff --git a/man7/unix.7 b/man7/unix.7
index 1ab70d5..7c9cb36 100644
--- a/man7/unix.7
+++ b/man7/unix.7
 <at>  <at>  -382,7 +382,9  <at>  <at>  The correct syntax is:
 can be:
 .TP
 .B SIOCINQ
-Returns the amount of queued unread data in the receive buffer.
+For
+.B SOCK_STREAM
+socket the function returns the amount of queued unread data in the receive buffer.
 The socket must not be in LISTEN state, otherwise an error
 .RB ( EINVAL )
 is returned.
 <at>  <at>  -402,6 +404,13  <at>  <at>  defined in
(Continue reading)

Jan Chaloupka | 18 Oct 17:22 2014
Picon

[PATCH] madvise.2: madvise(, , MADV_REMOVE) supports ext4, ocfs2 and xfs as well

As from upstream commit:

commit 3f31d07571eeea18a7d34db9af21d2285b807a17
Author: Hugh Dickins <hughd@...>
Date:   Tue May 29 15:06:40 2012 -0700

     mm/fs: route MADV_REMOVE to FALLOC_FL_PUNCH_HOLE

     Now tmpfs supports hole-punching via fallocate(), switch madvise_remove()
     to use do_fallocate() instead of vmtruncate_range(): which extends
     madvise(,,MADV_REMOVE) support from tmpfs to ext4, ocfs2 and xfs.

madvise(,,MADV_REMOVE) support was extended by ext4, ocfs2 and xfs.

bug report: https://bugzilla.redhat.com/show_bug.cgi?id=1120294

Justification from Rafael Aquini:
Well, that code is committed in kernel since v3.5 (2012) and it surely is
the expected behaviour since. It seems to me that madvise(2) man page text
for MADV_REMOVE just got out-of-date in that regard.

This patch mentions this support in madvise.2 man page.

Reworded and corrected by Michael Kerrisk and Hugh Dickins. Thank you.

Signed-off-by: Jan Chaloupka <jchaloup@...>
---
 man2/madvise.2 |   17 ++++++++++++-----
 1 file changed, 12 insertions(+), 5 deletions(-)

(Continue reading)


Gmane