Zeng Linggang | 20 May 12:00 2015

[PATCH] clock_getres.2: ATTRIBUTES: Note functions that are thread-safe

After research, We think clock_getres(), clock_gettime() and
clock_settime() are thread-safe. But, there are not markings of
clock_getres(), clock_gettime() and clock_settime() in glibc document.

Signed-off-by: Zeng Linggang <zenglg.jy@...>
---
 man2/clock_getres.2 | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/man2/clock_getres.2 b/man2/clock_getres.2
index 6809c7b..c7ecd3d 100644
--- a/man2/clock_getres.2
+++ b/man2/clock_getres.2
 <at>  <at>  -204,6 +204,21  <at>  <at>  specified is not supported on this system.
 does not have permission to set the clock indicated.
 .SH VERSIONS
 These system calls first appeared in Linux 2.6.
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lbw16 lb lb
+l l l.
+Interface	Attribute	Value
+T{
+.BR clock_getres (),
+.BR clock_gettime (),
+.BR clock_settime ()
+T}	Thread safety	MT-Safe
(Continue reading)

Marko Myllynen | 13 May 11:50 2015
Picon

[PATCH] proc.5: tfix


---
 man5/proc.5 |    6 +++---
 1 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/man5/proc.5 b/man5/proc.5
index d0a7629..c3996eb 100644
--- a/man5/proc.5
+++ b/man5/proc.5
 <at>  <at>  -93,15 +93,15  <at>  <at>  directories but their own (the
 .IR /proc/[pid]
 directories themselves remain visible).
 Sensitive files such as
-.IR /proc/[pid]cmdline
+.IR /proc/[pid]/cmdline
 and
-.IR /proc/[pid]status
+.IR /proc/[pid]/status
 are now protected against other users.
 This makes it impossible to learn whether any user is running a
 specific program
 (so long as the program doesn't otherwise reveal itself by its behavior).
 .\" As an additional bonus, since
-.\" .IR /proc/[pid]cmdline
+.\" .IR /proc/[pid]/cmdline
 .\" is unaccessible for other users,
 .\" poorly written programs passing sensitive information via
 .\" program arguments are now protected against local eavesdroppers.
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
(Continue reading)

Marko Myllynen | 13 May 11:50 2015
Picon

/proc/{diskstats,schedstat,vmstat} documentation

Hi Michael,

it seems that /proc/vmstat is undocumented in proc(5), is it just
because nobody has written the documentation yet or are some files
considered out of scope for proc(5)? Other such "interesting" file which
would be nice to have documented in-line is IMHO /proc/diskstats.

FWIW, for /proc/vmstat first search hit is
http://www.linuxinsight.com/proc_vmstat.html which looks decent.

I also see that /proc/schedstat and /proc/≤pid>/schedstat are missing,
some information about them can be found at
http://eaglet.rain.com/rick/linux/schedstat/v15/format-15.html and
https://www.kernel.org/doc/Documentation/scheduler/sched-stats.txt.

Lastly, /proc/≤pid>/{loginuid,sessionid} are missing.

PS. Yes, I think I try to provide patches at least for a couple of these
cases if time permits.

Thanks,

--

-- 
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)

Marko Myllynen | 13 May 10:50 2015
Picon

[PATCH] locale.5: add iconv(1) reference

Hi,

one more tweak to locale(5) page, since it now describes transliteration
let's add a reference to iconv(1) which has an example how it works and
how it can be tested.

---
 man5/locale.5 |    1 +
 1 files changed, 1 insertions(+), 0 deletions(-)

diff --git a/man5/locale.5 b/man5/locale.5
index a1b94be..40c360e 100644
--- a/man5/locale.5
+++ b/man5/locale.5
 <at>  <at>  -1236,6 +1236,7  <at>  <at>  This manual page isn't complete.
 .\" .SH AUTHOR
 .\" Jochen Hein (Hein@...)
 .SH SEE ALSO
+.BR iconv (1),
 .BR locale (1),
 .BR localedef (1),
 .BR localeconv (3),

Thanks,

--

-- 
Marko Myllynen
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo@...
(Continue reading)

Zeng Linggang | 13 May 08:53 2015

[PATCH] getifaddrs.3: ATTRIBUTES: Note functions that are thread-safe

After research, We think getifaddrs() and freeifaddrs() are not
thread-safe. But, there is not markings of getifaddrs() and
freeifaddrs() in glibc document.
- getifaddrs:  MT-Safe
- freeifaddrs: MT-Safe

Signed-off-by: Zeng Linggang <zenglg.jy@...>
---
 man3/getifaddrs.3 | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/man3/getifaddrs.3 b/man3/getifaddrs.3
index ae6ac8e..0437b08 100644
--- a/man3/getifaddrs.3
+++ b/man3/getifaddrs.3
 <at>  <at>  -167,6 +167,20  <at>  <at>  the implementation supported only IPv4 addresses;
 IPv6 support was added in glibc 2.3.3.
 Support of address families other than IPv4 is available only
 on kernels that support netlink.
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lbw27 lb lb
+l l l.
+Interface	Attribute	Value
+T{
+.BR getifaddrs (),
+.BR freeifaddrs ()
(Continue reading)

Vegard Nossum | 12 May 16:31 2015
Picon

ptrace.2: BUGS (missing WIFEXITED notification)

[resend with Cc: linux-man]

Hi again :-)

We hit another edge case in the ptrace() interface and after several
hours of chasing it down, we found that it was already described in the
"BUGS" section:

"If a thread group leader is traced and exits by calling _exit(2), a
PTRACE_EVENT_EXIT stop will happen for it (if requested), but the
subsequent WIFEXITED notification will not be delivered until all other
threads exit. As explained above, if one of other threads calls
execve(2), the death of the thread group leader will never be reported.
If the execed thread is not traced by this tracer, the tracer will never
know that execve(2) happened. One possible workaround is to
PTRACE_DETACH the thread group leader instead of restarting it in this
case. Last confirmed on 2.6.38.6."

I wanted to write that we've also noticed the same thing not only for
_exit() but also for terminating signals, however we also came across
this bit in the manual source:

.\" Note from Denys Vlasenko:
.\" Here "exits" means any kind of death - _exit, exit_group,
.\" signal death. Signal death and exit_group cases are trivial,
.\" though: since signal death and exit_group kill all other threads
.\" too, "until all other threads exit" thing happens rather soon
.\" in these cases. Therefore, only _exit presents observably
.\" puzzling behavior to ptrace users: thread leader _exit's,
.\" but WIFEXITED isn't reported! We are trying to explain here
(Continue reading)

Marko Myllynen | 12 May 16:21 2015
Picon

[PATCH] locale.5: fix country_isbn format

Both plain numbers and Unicode code points are used in glibc locales but checking the code reveals that
country_isbn is handled like the rest of its category expect for country_num which was clarified earlier.

---
 man5/locale.5 |    2 +-
 1 files changed, 1 insertions(+), 1 deletions(-)

diff --git a/man5/locale.5 b/man5/locale.5
index d2c67dc..bc9ed8e 100644
--- a/man5/locale.5
+++ b/man5/locale.5
 <at>  <at>  -213,7 +213,7  <at>  <at>  followed by the numeric country code as plain numbers (ISO 3166).
 followed by the code for the country car number.
 .TP
 .I country_isbn
-followed by the ISBN code as plain numbers (for books).
+followed by the ISBN code (for books).
 .TP
 .I lang_name
 followed by the language name in the language of the current document.
--

-- 
1.7.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

Marko Myllynen | 12 May 15:59 2015
Picon

[PATCH] locale.5: document class in LC_CTYPE

See e.g. the locale zh_CN and

http://en.cppreference.com/w/cpp/string/wide/towctrans
http://en.cppreference.com/w/cpp/string/wide/wctrans

---
 man5/locale.5 |    5 +++++
 1 files changed, 5 insertions(+), 0 deletions(-)

diff --git a/man5/locale.5 b/man5/locale.5
index 2519ad2..314adf6 100644
--- a/man5/locale.5
+++ b/man5/locale.5
 <at>  <at>  -437,6 +437,11  <at>  <at>  followed by a list of mapping pairs of
 characters and letters
 to be used in titles (headings).
 .TP
+.I class
+followed by a locale-specific character class definition,
+starting with the class name followed by the characters
+belonging to the class.
+.TP
 .I charclass
 followed by a list of locale-specific character class names
 which are then to be defined in the locale.
--

-- 
1.7.1

--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
(Continue reading)

Marko Myllynen | 12 May 15:59 2015
Picon

[PATCH] locale.5: document default_missing


---
 man5/locale.5 |    6 ++++++
 1 files changed, 6 insertions(+), 0 deletions(-)

diff --git a/man5/locale.5 b/man5/locale.5
index ae60879..2519ad2 100644
--- a/man5/locale.5
+++ b/man5/locale.5
 <at>  <at>  -483,6 +483,12  <at>  <at>  a transliteration rule file
 (and optionally a repertoire map file)
 .
 .TP
+.I default_missing
+in the transliteration rules section 
+defines the default character to be used for 
+transliteration where none of the targets cannot be presented
+in the target character set.
+.TP
 .I translit_end
 marks the end of the transliteration rules.
 .PP
--

-- 
1.7.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)

Marko Myllynen | 12 May 15:58 2015
Picon

[PATCH] locale.5: document character transliteration

See e.g. da_DK for reference.

(Not sure should we actually provide an example here?)

---
 man5/locale.5 |   31 ++++++++++++++++++++++++++++---
 1 files changed, 28 insertions(+), 3 deletions(-)

diff --git a/man5/locale.5 b/man5/locale.5
index 16bf39c..ae60879 100644
--- a/man5/locale.5
+++ b/man5/locale.5
 <at>  <at>  -249,9 +249,6  <at>  <at>  The definition starts with the string
 in the first column.

 The following keywords are allowed:
-.\" FIXME The following LC_CTYPE keywords are not documented:
-.\"	translit_start + translit_end
-.\"	include
 .TP
 .I upper
 followed by a list of uppercase letters.
 <at>  <at>  -460,6 +457,34  <at>  <at>  for input digits for the locale.
 followed by a list of mapping pairs of
 alternate separators
 for output for the locale.
+.TP
+.I translit_start
+marks the start of the transliteration rules section.
+The section can contain the
(Continue reading)

Marko Myllynen | 12 May 15:58 2015
Picon

[PATCH] locale.5: document map "totitle"

See e.g. locales/i18n for reference.

---
 man5/locale.5 |    5 +++++
 1 files changed, 5 insertions(+), 0 deletions(-)

diff --git a/man5/locale.5 b/man5/locale.5
index 9a32fa0..16bf39c 100644
--- a/man5/locale.5
+++ b/man5/locale.5
 <at>  <at>  -435,6 +435,11  <at>  <at>  letters.
 If the keyword tolower is not present, the reverse of the
 toupper list is used.
 .TP
+.I map "totitle"
+followed by a list of mapping pairs of
+characters and letters
+to be used in titles (headings).
+.TP
 .I charclass
 followed by a list of locale-specific character class names
 which are then to be defined in the locale.
--

-- 
1.7.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)


Gmane