Michael Kerrisk (man-pages | 20 Apr 20:48 2014
Picon

man-pages-3.65 released

Gidday,

The Linux man-pages maintainer proudly announces:

    man-pages-3.65 - 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.65

A short summary of the release is blogged at:
http://linux-man-pages.blogspot.com/2014/04/man-pages-365-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)

Heinrich Schuchardt | 20 Apr 12:28 2014
Picon
Picon

munmap, msync: synchronization

Hello Michael,

when analyzing how the fanotify API interacts with mmap(2) I stumbled 
over the following issues in the manpages:

The manpage of msync(2) says:
"msync() flushes changes made to the in-core copy of a file that was 
mapped into memory using mmap(2) back to disk."

"back to disk" implies that the file system is forced to actually write 
to the hard disk, somewhat equivalent to invoking sync(1). Is that 
guaranteed for all file systems?

Not all file systems are necessarily disk based (e.g. davfs, tmpfs).

So shouldn't we write:
"... back to the file system."

http://pubs.opengroup.org/onlinepubs/007904875/functions/msync.html
says
"... to permanent storage locations, if any,"

The manpage of munmap(2) leaves it unclear, if copying back to the 
filesystem is synchronous or asynchronous.
This bit of information is important, because, if munmap is 
asynchronous, applications might want to call msync(,,MS_SYNC), before 
calling munmap. If munmap is synchronous it might block until the file 
system responds (think of waiting for a tape to be loaded, or a webdav 
server to respond).

(Continue reading)

Yuri Kozlov | 20 Apr 06:41 2014
Picon

[PATCH] timer_getoverrun.2:tfix

---
 man2/timer_getoverrun.2 | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/man2/timer_getoverrun.2 b/man2/timer_getoverrun.2
index d64255a..c14230b 100644
--- a/man2/timer_getoverrun.2
+++ b/man2/timer_getoverrun.2
 <at>  <at>  -78,7 +78,7  <at>  <at>  Timer overruns can also occur when expiration notifications
 are delivered via invocation of a thread,
 since there may be an arbitrary delay between an expiration of the timer
 and the invocation of the notification thread,
-and in that delay interval, additional timer expirations may occur
+and in that delay interval, additional timer expirations may occur.
 .SH RETURN VALUE
 On success,
 .BR timer_getoverrun ()
--

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

bugzilla | 20 Apr 04:36 2014

[Bug 74481] New: It should be documented that using fexecve on a file opened in O_CLOEXEC that is a script cannot possibly work.

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

            Bug ID: 74481
           Summary: It should be documented that using fexecve on a file
                    opened in O_CLOEXEC that is a script cannot possibly
                    work.
           Product: Documentation
           Version: unspecified
          Hardware: All
                OS: Linux
            Status: NEW
          Severity: normal
          Priority: P1
         Component: man-pages
          Assignee: documentation_man-pages@...
          Reporter: sstewartgallus00@...
        Regression: No

Consider the following program:

#include <errno.h>
#include <fcntl.h>
#include <unistd.h>

int main()
{
    int test = open("./test.sh", O_RDONLY | O_CLOEXEC);
    if (-1 == test) {
        perror("open");
    }
(Continue reading)

Nicolas Del Piano | 19 Apr 19:56 2014
Picon

[PATCH] octeon-usb/octeon-hcd.c


Subject: [PATCH] coding style errors fix
From: Nicolas Del Piano <ndel314@...>

Fixed all the coding style errors.
There are some warnings that may be fixed.
Signed-off-by: Nicolas Del Piano <ndel314@...>
---
--- linux-next/drivers/staging/octeon-usb/octeon-hcd.c.orig	2014-04-19 02:31:31.626040005 -0300
+++ linux-next/drivers/staging/octeon-usb/octeon-hcd.c	2014-04-19 02:18:49.282259735 -0300
 <at>  <at>  -159,13 +159,13  <at>  <at>  enum cvmx_usb_complete {
  *			status call.
  */
 struct cvmx_usb_port_status {
-	uint32_t reserved		: 25;
-	uint32_t port_enabled		: 1;
-	uint32_t port_over_current	: 1;
-	uint32_t port_powered		: 1;
-	enum cvmx_usb_speed port_speed	: 2;
-	uint32_t connected		: 1;
-	uint32_t connect_change		: 1;
+	uint32_t reserved:25;
+	uint32_t port_enabled:1;
+	uint32_t port_over_current:1;
+	uint32_t port_powered:1;
+	enum cvmx_usb_speed port_speed:2;
+	uint32_t connected:1;
+	uint32_t connect_change:1;
(Continue reading)

Simon Paillard | 18 Apr 22:00 2014
Picon

[PATCH] open_by_handle_at.2: file_handle is named handle

---
 man2/open_by_handle_at.2 | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/man2/open_by_handle_at.2 b/man2/open_by_handle_at.2
index 8a67143..55dbd1f 100644
--- a/man2/open_by_handle_at.2
+++ b/man2/open_by_handle_at.2
 <at>  <at>  -276,7 +276,7  <at>  <at>  points outside your accessible address space.
 includes an invalid bit value.
 .TP
 .B EINVAL
-.IR handle_bytes\->handle_bytes
+.IR handle\->handle_bytes
 is greater than
 .BR MAX_HANDLE_SZ .
 .TP
--

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

Mike Frysinger | 17 Apr 19:48 2014
Picon

[PATCH] crypt(3): use real dashes in regex

I don't think rendering the dashes in the regex expression as the en
style makes sense.  This is a literal regex, so use literal dashes.

Signed-off-by: Mike Frysinger <vapier@...>
---
 man3/crypt.3 | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/man3/crypt.3 b/man3/crypt.3
index 9baa80a..453bcec 100644
--- a/man3/crypt.3
+++ b/man3/crypt.3
 <at>  <at>  -65,7 +65,7  <at>  <at>  is a user's typed password.
 .PP
 .I salt
 is a two-character string chosen from the set
-[\fBa\fP\(en\fBzA\fP\(en\fBZ0\fP\(en\fB9./\fP].
+[\fBa\-zA\-Z0\-9./\fP].
 This string is used to
 perturb the algorithm in one of 4096 different ways.
 .PP
 <at>  <at>  -241,7 +241,7  <at>  <at>  SHA-512 | 86 characters
 .TE

 The characters in "\fIsalt\fP" and "\fIencrypted\fP" are drawn from the set
-[\fBa\fP\(en\fBzA\fP\(en\fBZ0\fP\(en\fB9./\fP].
+[\fBa-zA-Z0-9./\fP].
 In the MD5 and SHA implementations the entire
 .I key
 is significant (instead of only the first
(Continue reading)

David Prévot | 17 Apr 02:20 2014
Picon

[PATCH] termios.3: sfix

---
 man3/termios.3 | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/man3/termios.3 b/man3/termios.3
index ec5a847..c0e3c45 100644
--- a/man3/termios.3
+++ b/man3/termios.3
 <at>  <at>  -751,7 +751,7  <at>  <at>  If the timer expires without any input becoming available,
 .BR read (2)
 returns 0.
 If data is already available at the time of the call to
-.BR read (),
+.BR read (2),
 the call behaves as though the data was received immediately after the call.
 .TP
 MIN > 0, TIME > 0 (read with interbyte timeout)
 <at>  <at>  -772,14 +772,14  <at>  <at>  has been received.
 (POSIX does not specify this termination condition,
 and on some other implementations
 .\" e.g., Solaris
-.BR read ()
+.BR read (2)
 does not return in this case.)
 .RE
 .IP
 Because the timer is started only after the initial byte
 becomes available, at least one byte will be read.
 If data is already available at the time of the call to
-.BR read (),
(Continue reading)

David Prévot | 17 Apr 01:00 2014
Picon

[PATCH] inotify.7 exfix

---
 man7/inotify.7 | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/man7/inotify.7 b/man7/inotify.7
index 6579a59..17462c6 100644
--- a/man7/inotify.7
+++ b/man7/inotify.7
 <at>  <at>  -416,13 +416,13  <at>  <at>  and
 Suppose an application is watching the directories
 .I dir1
 and
-.IR dir ,
+.IR dir2 ,
 and the file
 .IR dir1/myfile .
 The following examples show some events that may be generated.
 .RS 4
 .TP
-link("dir/myfile", "dir2/new");
+link("dir1/myfile", "dir2/new");
 Generates an
 .B IN_ATTRIB
 event for
 <at>  <at>  -469,7 +469,7  <at>  <at>  the following events:
 .RS 4
 .TP
 unlink("dir2/yy");
-Generates
+Generates an
(Continue reading)

isabelle | 15 Apr 21:47 2014
Picon

spende /Donation

Hallo
Wenn ich diese Nachricht zu senden wollte, ist dies nicht einfach Zufall. Dies ist, weil Ihre e-Mail vom
elektronischen Roboter gesichert meine WX.7AR BW ausgewählt wurde.
Zunächst möchte ich mich für dieses Eindringen in Ihr Leben zu entschuldigen, obwohl ich zugeben, dass
es mir sehr wichtig. Ich bin Isabelle Vasudev. Ich leide an Krebs im Hals seit nun mehr als 3 Jahre und eine
halbe und es leider, mein Arzt hat gerade informiert mich, dass ich bin voller unheilbar und, dass meine
Tage, wegen meinen etwas gezählt sind abgebaut Zustand. Ich bin eine Witwe und ich habe keine Kind, das
ich beginne zu bedauern.
In der Tat ist der Grund, warum ich Sie kontaktieren bin, möchte ich einen Teil von meinem Grundstück zu
spenden, weil ich niemand, wer die Erben konnte. Ich habe fast mein ganzes Zeug, darunter ein Unternehmen
der Export von Holz, Gummi und Stahl-Industrie in Afrika, wo ich wohne nun mehr 10 Jahren, verkauft. Ein
großer Teil der Gelder gesammelt wurde mit unterschiedlichen Verbänden humanitären Charakter
überall in der Welt, aber besonders hier in Afrika bezahlt.
Im Hinblick auf den Rest der Summe genau in Höhe von 750.000, 00euros (sieben hundert und fünfzig tausend
Euro) auf eine gesperrte Mitarbeiter-Account, meine letzte wünschen würde Sie es spenden, so dass Sie
in Ihrer Branche und vor allem den humanitären investieren können. Ich bin ganz bewusst was ich zu tun
beabsichtigen, und ich denke, trotz der Tatsache, die wir nicht wissen, werdet ihr diese Summe gut
nutzen. Ich bitte Sie, bitte dieses Erbe zu akzeptieren, ohne jedoch Fragen Sie alles, was in
zurückgeben wenn es nicht immer denken, gutes zu tun, um dich herum, was ich nicht getan habe, in meiner Existenz.
Das heißt, wird auf einer verantwortlichen Person und besonders gutem Glauben fallen zu lassen
beruhigt, ich möchte bitten, dass Sie bitte mich bei den meisten schnell kontaktieren, um weitere
Erklärung über die Gründe für meine Geste und den Verlauf der Dinge zu geben. Bitte kontaktieren Sie
mich so bald wie möglich, wenn Sie mein Angebot akzeptieren.
Gott möge mit dir sein!
Ich fordere Sie auf, mich über meine persönliche e-Mail-Adresse zu kontaktieren:
Isabelle.claude654@...
Der Frieden und Barmherzigkeit Gottes möge mit dir sein.
Mrs Isabelle

--
(Continue reading)

Vince Weaver | 15 Apr 20:28 2014
Picon

[patch] perf_event_open.2 -- clarify EACCES and EPERM errors


Attempt to clarify the reasons for EACCES and EPERM errors.

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

diff --git a/man2/perf_event_open.2 b/man2/perf_event_open.2
index e513905..00842df 100644
--- a/man2/perf_event_open.2
+++ b/man2/perf_event_open.2
 <at>  <at>  -2385,11 +2385,14  <at>  <at>  field is overwritten by the kernel to be the size of the structure
 it was expecting.
 .TP
 .B EACCES
-Returned when the requested event requires root permissions
-(or a more permissive perf_event paranoid setting).
-Some common cases where an unprivileged process 
-may encounter this error: are attaching to a process owned by a different user;
-monitoring all processes on a given CPU;
+Returned when the requested event requires
+.B CAP_SYS_ADMIN
+permissions (or a more permissive perf_event paranoid setting).
+Some common cases where an unprivileged process
+may encounter this error:
+attaching to a process owned by a different user;
+monitoring all processes (including those not belonging to the user)
+on a given CPU;
 and not setting
 .I exclude_kernel
 when the paranoid setting requires it.
 <at>  <at>  -2477,9 +2480,17  <at>  <at>  branch tracing if it is not available, sampling if no PMU
(Continue reading)


Gmane