Akihiro Motoki | 26 Jan 17:21 2015
Picon

restart_syscall.2: remove section number

diff --git a/man2/restart_syscall.2 b/original/man2/restart_syscall.2
index a71b618..33081b7 100644
--- a/man2/restart_syscall.2
+++ b/man2/restart_syscall.2
 <at>  <at>  -115,7 +115,7  <at>  <at>  In the case of system calls that take a timeout argument and
 automatically restart after a stop signal plus
 .BR SIGCONT ,
 but which do not have the
-.BR restart_syscall (2)
+.BR restart_syscall ()
 mechanism built in, then, after the process resumes execution,
 the time that the process spent in the stop state is
 .I not
 <at>  <at>  -127,7 +127,7  <at>  <at>  and
 .BR pselect (2).

 From user space, the operation of
-.BR restart_syscall (2)
+.BR restart_syscall ()
 is largely invisible:
 to the process that made the system call that is restarted,
 it appears as though that system call executed and

--

-- 
Akihiro Motoki <amotoki@...>
--
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)

Akihiro Motoki | 26 Jan 17:21 2015
Picon

locale.1: format fix

diff --git a/man1/locale.1 b/original/man1/locale.1
index ef240be..650a36e 100644
--- a/man1/locale.1
+++ b/man1/locale.1
 <at>  <at>  -65,7 +65,7  <at>  <at>  metadata about each locale to be included in the output.
 Display the available charmaps (character set description files).
 .PP
 The
-.I locale
+.B locale
 command can also be provided with one or more arguments,
 which are the names of locale keywords (for example,
 .IR date_fmt ,
 <at>  <at>  -108,7 +108,7  <at>  <at>  so that the output has the format:
     \fIkeyword\fP="\fIvalue\fP"
 .PP
 The
-.I locale
+.B locale
 command also knows about the following options:
 .TP
 .BR \-v ", " \-\-verbose

--

-- 
Akihiro Motoki <amotoki@...>
--
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)

Heinrich Schuchardt | 23 Jan 20:54 2015
Picon
Picon

[PATCH v3 1/1] ioctl-fat.2: new manpage for the ioctl fat API

The ioctl(2) system call may be used to retrieve information about
the fat file system and to set file attributes.

This new manpage describes the details.

Michael Kerrisk suggested to CC linux-fsdevel@... and
linux-kernel@... for review.

version 3: correct typos
version 2: consider comments by Michael Kerrisk
verison 1: original patch

Signed-by: Heinrich Schuchardt <xypron.glpk@...>
---
 man2/ioctl-fat.2 | 442 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 442 insertions(+)
 create mode 100644 man2/ioctl-fat.2

diff --git a/man2/ioctl-fat.2 b/man2/ioctl-fat.2
new file mode 100644
index 0000000..80891d8
--- /dev/null
+++ b/man2/ioctl-fat.2
 <at>  <at>  -0,0 +1,442  <at>  <at> 
+.\" Copyright (C) 2014, Heinrich Schuchardt <xypron.glpk@...>
+.\"
+.\" %%%LICENSE_START(VERBATIM)
+.\" Permission is granted to make and distribute verbatim copies of this
+.\" manual provided the copyright notice and this permission notice are
+.\" preserved on all copies.
(Continue reading)

Vince Weaver | 23 Jan 18:58 2015
Picon

[patch] perf_event_open.2: Add git commit references


I noticed you were adding git commit references to the various
Linux version markers.

This adds git commit references for all Linux kernel version
notes in perf_event_open.2

Signed-off-by: Vince Weaver <vincent.weaver@...>

diff --git a/man2/perf_event_open.2 b/man2/perf_event_open.2
index 27885f3..e91ef21 100644
--- a/man2/perf_event_open.2
+++ b/man2/perf_event_open.2
 <at>  <at>  -158,6 +158,7  <at>  <at>  using the
 flag.
 .TP
 .BR PERF_FLAG_FD_OUTPUT " (broken since Linux 2.6.35)"
+.\" commit ac9721f3f54b27a16c7e1afb2481e7ee95a70318
 This flag re-routes the event's sampled output to instead
 be included in the mmap buffer of the event specified by
 .IR group_fd .
 <at>  <at>  -301,7 +302,8  <at>  <at>  Breakpoints can be read/write accesses to an address as well as
 execution of an instruction address.
 .TP
 .RB "dynamic PMU"
-Since Linux 2.6.39,
+Since Linux 2.6.38,
+.\" commit 2e80a82a49c4c7eca4e35734380f28298ba5db19
 .BR perf_event_open ()
 can support multiple PMUs.
(Continue reading)

bugzilla | 23 Jan 17:15 2015

[Bug 91931] New: fflush(3) is misleading about input streams

https://bugzilla.kernel.org/show_bug.cgi?id=91931

            Bug ID: 91931
           Summary: fflush(3) is misleading about input streams
           Product: Documentation
           Version: unspecified
          Hardware: All
                OS: Linux
            Status: NEW
          Severity: normal
          Priority: P1
         Component: man-pages
          Assignee: documentation_man-pages@...
          Reporter: cubbi@...
        Regression: No

Current fflush(3) claims that

"For input streams, fflush() discards any buffered data that has been fetched
from the underlying file, but has not been consumed by the application."

While technically true (assuming 'file' implies seekable device), this is
incomplete: flushing an input stream associated with a non-seekable device,
such as the terminal input, does nothing (the update to fp->_IO_read_end at
libio/fileops.c:872 does not happen due to ESPIPE from lseek)

There have been enough confused beginner posts to various internet forums
asking why flushing stdin doesn't work on Linux. I believe it is worth making
the man page more explicit. At the very least, it should begin that sentence
with "For input streams associated with seekable devices", or perhaps it should
(Continue reading)

Michael Kerrisk (man-pages | 23 Jan 09:52 2015
Picon

man-pages-3.78 released

Gidday,

The Linux man-pages maintainer proudly announces:

    man-pages-3.78 - man pages for Linux

Tarball download:
    http://www.kernel.org/doc/man-pages/download.html
Git repository:
    https://git.kernel.org/cgit/docs/man-pages/man-pages.git/
Online changelog:
    http://man7.org/linux/man-pages/changelog.html#release_3.78

A short summary of the release is blogged at:
http://linux-man-pages.blogspot.com/2015/01/man-pages-378-is-released.html

The current version of the pages is browsable at:
http://man7.org/linux/man-pages/

You are receiving this message either because:

a) You contributed to the content of this release.

b) You are subscribed to linux-man@...

c) I have information (possibly inaccurate) that you are the maintainer
   of a translation of the manual pages, or are the maintainer of the
   manual pages set in a particular distribution, or have expressed
   interest in helping with man-pages maintenance, or have otherwise
   expressed interest in being notified about man-pages releases.
(Continue reading)

Elie De Brauwer | 22 Jan 20:21 2015
Picon

[PATCH 0/2] proc.5 modification

Hello Michael,

Two patches related to proc.5:
 - the first patch adds an explanation of /proc/sys/vm/compact_memory
 - the second patch fixes two typo's (of which I'm guilty myself) in the 
   buddyinfo section of proc.5

my 2 cents
E.

Elie De Brauwer (2):
  proc.5: Explain /proc/sys/vm/compact_memory
  proc.5: tfix

 man5/proc.5 | 13 +++++++++++--
 1 file changed, 11 insertions(+), 2 deletions(-)

--

-- 
2.1.4

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

Akihiro Motoki | 21 Jan 21:41 2015
Picon

sigaction.2: tfix and ffix

diff --git a/man2/sigaction.2 b/original/man2/sigaction.2
index 682678c..adfacd6 100644
--- a/man2/sigaction.2
+++ b/man2/sigaction.2
 <at>  <at>  -451,7 +451,7  <at>  <at>  delivering the trap.
 In the case of
 .BR seccomp (2),
 the tracee will be shown as delivering the event.
-.B BUS_MCERR_*
+.B BUS_MCEERR_*
 and
 .I si_addr_lsb
 are Linux-specific extensions.
 <at>  <at>  -470,7 +470,7  <at>  <at>  The
 .I si_fd
 field indicates the file descriptor for which the I/O event occurred.
 .IP *
-.BR SIGSYS,
+.BR SIGSYS ,
 generated (since Linux 3.5)
 .\" commit a0727e8ce513fe6890416da960181ceb10fbfae6
 when a seccomp filter returns

--

-- 
Akihiro Motoki <amotoki@...>
--
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)

Akihiro Motoki | 21 Jan 21:40 2015
Picon

fanotify_mark.2: tfix

diff --git a/man2/fanotify_mark.2 b/man2/fanotify_mark.2
index 32ecfd5..bab5d2c 100644
--- a/man2/fanotify_mark.2
+++ b/man2/fanotify_mark.2
 <at>  <at>  -72,7 +72,7  <at>  <at>  will occur.
 .B FAN_MARK_FLUSH
 Remove either all mount or all non-mount marks from the fanotify group.
 If
-.I flag
+.I flags
 contains
 .BR FAN_MARK_MOUNT ,
 all marks for mounts are removed from the group.

--

-- 
Akihiro Motoki <amotoki@...>
--
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 | 21 Jan 18:44 2015
Picon

fcntl(2) man page patch for OFD locks

Hi Jeff,

I was recently checking some details of the man page for OFD locks,
and realized that one paragraph is somewhat misleading:

       Open file description  locks  always  conflict  with  traditional
       record  locks, even when they are acquired by the same process on
       the same file descriptor.

This doesn't capture the full story, as far as I can tell. In
particular if we have two processes that take locks on the same region
of a file as follows:

F_OFD_SETLK F_RDLCK
and
F_SETLK F_RDLCK

then those pair of locks are compatible. I assume that's expected
behavior, right? I've drafted the patch below for the man page. Seem
okay?

Cheers,

Michael

diff --git a/man2/fcntl.2 b/man2/fcntl.2
index 59f22ce..03c2ae8 100644
--- a/man2/fcntl.2
+++ b/man2/fcntl.2
 <at>  <at>  -495,7 +495,10  <at>  <at>  and are only automatically released on the last close
(Continue reading)

Ma Shimiao | 21 Jan 10:07 2015

[PATCH] termios.3: Modify thread-safety information

As this is man page for Linux, we don't need thread safety information
for bsd

Signed-off-by: Ma Shimiao <mashimiao.fnst@...>
---
 man3/termios.3 | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/man3/termios.3 b/man3/termios.3
index 8eb04be..314218f 100644
--- a/man3/termios.3
+++ b/man3/termios.3
 <at>  <at>  -984,9 +984,12  <at>  <at>  Interface	Attribute	Value
 T{
 .BR tcgetattr (),
 .BR tcsetattr (),
+.BR tcsendbreak (),
 .BR tcdrain (),
 .br
 .BR tcflush (),
+.br
+.BR tcflow (),
 .BR cfmakeraw (),
 .BR cfgetispeed (),
 .BR cfgetospeed (),
 <at>  <at>  -994,10 +997,6  <at>  <at>  T{
 .BR cfsetospeed (),
 .BR cfsetspeed ()
 T}	Thread safety	MT-Safe
-T{
(Continue reading)


Gmane