[PATCH 1/5] kcmp.2: note about SECURITY_YAMA

[PATCH 1/5] kcmp.2: note about SECURITY_YAMA

[Shawn Landden]

Signed-off-by: Shawn Landden <shawn-01I/ocv1qBBILuwUvNxBeQ@public.gmane.org>
---
 man2/kcmp.2 | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/man2/kcmp.2 b/man2/kcmp.2
index 59dd4d1..c910ac2 100644
--- a/man2/kcmp.2
+++ b/man2/kcmp.2
@@ -187,7 +187,12 @@ is invalid.
 Insufficient permission to inspect process resources.
 The
 .B CAP_SYS_PTRACE
-capability is required to inspect processes that you do not own.
+capability is required to inspect processes that you do not own. Other
+limitations on ptrace apply, such as
+.BR CONFIG_SECURITY_YAMA ,
+which when /proc/sys/kernel/yama/ptrace_scope is 2 (the default) limits
+.BR kcmp()
+to child processes.
 .TP
 .B ESRCH
 Process
-- 
1.8.5.2

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

[PATCH 2/5] cmsg: be not --> not be

[Shawn Landden]

Signed-off-by: Shawn Landden <shawn-01I/ocv1qBBILuwUvNxBeQ@public.gmane.org>
---
 man3/cmsg.3 | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/man3/cmsg.3 b/man3/cmsg.3
index 22057c0..9677233 100644
--- a/man3/cmsg.3
+++ b/man3/cmsg.3
@@ -147,7 +147,7 @@ is a Linux extension.
 For portability, ancillary data should be accessed using only the macros
 described here.
 .BR CMSG_ALIGN ()
-is a Linux extension and should be not used in portable programs.
+is a Linux extension and should not be used in portable programs.
 .PP
 In Linux,
 .BR CMSG_LEN (),
@@ -157,7 +157,7 @@ and
 are constant expressions (assuming their argument is constant);
 this could be used to declare the size of global
 variables.
-This may be not portable, however.
+This may not be portable, however.
 .SH EXAMPLE
 This code looks for the
 .B IP_TTL
-- 
1.8.5.2

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

Re: [PATCH 2/5] cmsg: be not --> not be

[Michael Kerrisk (man-pages)]

Thanks, Shawn. Applied.

Cheers,

Michael


On 12/21/13 13:37, Shawn Landden wrote:
> Signed-off-by: Shawn Landden <shawn-01I/ocv1qBBILuwUvNxBeQ@public.gmane.org>
> ---
>  man3/cmsg.3 | 4 ++--
>  1 file changed, 2 insertions(+), 2 deletions(-)
> 
> diff --git a/man3/cmsg.3 b/man3/cmsg.3
> index 22057c0..9677233 100644
> --- a/man3/cmsg.3
> +++ b/man3/cmsg.3
> @@ -147,7 +147,7 @@ is a Linux extension.
>  For portability, ancillary data should be accessed using only the macros
>  described here.
>  .BR CMSG_ALIGN ()
> -is a Linux extension and should be not used in portable programs.
> +is a Linux extension and should not be used in portable programs.
>  .PP
>  In Linux,
>  .BR CMSG_LEN (),
> @@ -157,7 +157,7 @@ and
>  are constant expressions (assuming their argument is constant);
>  this could be used to declare the size of global
>  variables.
> -This may be not portable, however.
> +This may not be portable, however.
>  .SH EXAMPLE
>  This code looks for the
>  .B IP_TTL
> 


-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

[PATCH 3/5] timerfd_create: add timerfd(2) alias

[Shawn Landden]

Signed-off-by: Shawn Landden <shawn-01I/ocv1qBBILuwUvNxBeQ@public.gmane.org>
---
 man2/timerfd.2 | 2 ++
 1 file changed, 2 insertions(+)
 create mode 100644 man2/timerfd.2

diff --git a/man2/timerfd.2 b/man2/timerfd.2
new file mode 100644
index 0000000..de0bf03
--- /dev/null
+++ b/man2/timerfd.2
@@ -0,0 +1,2 @@
+.so man2/timerfd_create.2
+
-- 
1.8.5.2

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

Re: [PATCH 3/5] timerfd_create: add timerfd(2) alias

[Michael Kerrisk (man-pages)]

Shawn,

What is the rationale for this patch?

Cheers,

Michael


On 12/21/13 13:37, Shawn Landden wrote:
> Signed-off-by: Shawn Landden <shawn-01I/ocv1qBBILuwUvNxBeQ@public.gmane.org>
> ---
>  man2/timerfd.2 | 2 ++
>  1 file changed, 2 insertions(+)
>  create mode 100644 man2/timerfd.2
> 
> diff --git a/man2/timerfd.2 b/man2/timerfd.2
> new file mode 100644
> index 0000000..de0bf03
> --- /dev/null
> +++ b/man2/timerfd.2
> @@ -0,0 +1,2 @@
> +.so man2/timerfd_create.2
> +
> 


-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

[PATCH 4/5] printf: %m is supported by uclibc and musl, no %n in bionic

[Shawn Landden]

Signed-off-by: Shawn Landden <shawn-01I/ocv1qBBILuwUvNxBeQ@public.gmane.org>
---
 man3/printf.3 | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/man3/printf.3 b/man3/printf.3
index 20a3b5d..a861126 100644
--- a/man3/printf.3
+++ b/man3/printf.3
@@ -791,10 +791,10 @@ The number of characters written so far is stored into the integer
 indicated by the
 .I "int\ *"
 (or variant) pointer argument.
-No argument is converted.
+No argument is converted. (absent in bionic)
 .TP
 .B m
-(Glibc extension.)
+(Glibc extension. Supported by uClibc and musl)
 Print output of
 .IR strerror(errno) .
 No argument is required.
-- 
1.8.5.2

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

Re: [PATCH 4/5] printf: %m is supported by uclibc and musl, no %n in bionic

[Michael Kerrisk (man-pages)]

On 12/21/2013 01:37 AM, Shawn Landden wrote:
> Signed-off-by: Shawn Landden <shawn-01I/ocv1qBBILuwUvNxBeQ@public.gmane.org>
> ---
>  man3/printf.3 | 4 ++--
>  1 file changed, 2 insertions(+), 2 deletions(-)
> 
> diff --git a/man3/printf.3 b/man3/printf.3
> index 20a3b5d..a861126 100644
> --- a/man3/printf.3
> +++ b/man3/printf.3
> @@ -791,10 +791,10 @@ The number of characters written so far is stored into the integer
>  indicated by the
>  .I "int\ *"
>  (or variant) pointer argument.
> -No argument is converted.
> +No argument is converted. (absent in bionic)
>  .TP
>  .B m
> -(Glibc extension.)
> +(Glibc extension. Supported by uClibc and musl)
>  Print output of
>  .IR strerror(errno) .
>  No argument is required.

Hi Shawn,

I applied a slightly different patch.

Cheers,

Michael

--- a/man3/printf.3
+++ b/man3/printf.3
@@ -817,11 +817,12 @@ That argument shall be an
 or variant whose size matches the (optionally)
 supplied integer length modifier.
 No argument is converted.
+(This specifier is not supported by the bionic C library.)
 The behavior is undefined if the conversion specification includes
 any flags, a field width, or a precision.
 .TP
 .B m
-(Glibc extension.)
+(Glibc extension; supported by uClibc and musl.)
 Print output of
 .IR strerror(errno) .
 No argument is required.
 


-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

[PATCH 5/5] FreeBSD and bionic have memmem

[Shawn Landden]

Signed-off-by: Shawn Landden <shawn-01I/ocv1qBBILuwUvNxBeQ@public.gmane.org>
---
 man3/memmem.3 | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/man3/memmem.3 b/man3/memmem.3
index 7b97d2d..667ff62 100644
--- a/man3/memmem.3
+++ b/man3/memmem.3
@@ -57,7 +57,7 @@ The
 function returns a pointer to the beginning of the
 substring, or NULL if the substring is not found.
 .SH CONFORMING TO
-This function is a GNU extension.
+This function is a GNU extension. Present in FreeBSD 6.0 and bionic.
 .SH BUGS
 This function was broken in Linux libraries up to and including libc 5.0.9;
 there the
-- 
1.8.5.2

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

Re: [PATCH 5/5] FreeBSD and bionic have memmem

[Michael Kerrisk (man-pages)]

Hi Shawn,

On 21 December 2013 at 01:37, Shawn Landden <shawn-01I/ocv1qBBILuwUvNxBeQ@public.gmane.org> wrote:
> Signed-off-by: Shawn Landden <shawn-01I/ocv1qBBILuwUvNxBeQ@public.gmane.org>
> ---
>  man3/memmem.3 | 2 +-
>  1 file changed, 1 insertion(+), 1 deletion(-)
>
> diff --git a/man3/memmem.3 b/man3/memmem.3
> index 7b97d2d..667ff62 100644
> --- a/man3/memmem.3
> +++ b/man3/memmem.3
> @@ -57,7 +57,7 @@ The
>  function returns a pointer to the beginning of the
>  substring, or NULL if the substring is not found.
>  .SH CONFORMING TO
> -This function is a GNU extension.
> +This function is a GNU extension. Present in FreeBSD 6.0 and bionic.

It seems to pbe present on some other systems as well, so I reworded as:

       This  function is not specified in POSIX.1, but is present on a
       number of other systems.

Thanks for the report.

Cheers,

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

Re: [PATCH 1/5] kcmp.2: note about SECURITY_YAMA

[Michael Kerrisk (man-pages)]

Shawn,

Can you supply more background on this patch. 

Looking at security/yama/yama_lsm.c:

[[
#define YAMA_SCOPE_DISABLED     0
#define YAMA_SCOPE_RELATIONAL   1
#define YAMA_SCOPE_CAPABILITY   2
#define YAMA_SCOPE_NO_ATTACH    3

static int ptrace_scope = YAMA_SCOPE_RELATIONAL;
]]

This suggests that your statement that the default value is 2 is incorrect,
but I may be missing something.

Cheers,

Michael


On 12/21/13 13:37, Shawn Landden wrote:
> Signed-off-by: Shawn Landden <shawn-01I/ocv1qBBILuwUvNxBeQ@public.gmane.org>
> ---
>  man2/kcmp.2 | 7 ++++++-
>  1 file changed, 6 insertions(+), 1 deletion(-)
> 
> diff --git a/man2/kcmp.2 b/man2/kcmp.2
> index 59dd4d1..c910ac2 100644
> --- a/man2/kcmp.2
> +++ b/man2/kcmp.2
> @@ -187,7 +187,12 @@ is invalid.
>  Insufficient permission to inspect process resources.
>  The
>  .B CAP_SYS_PTRACE
> -capability is required to inspect processes that you do not own.
> +capability is required to inspect processes that you do not own. Other
> +limitations on ptrace apply, such as
> +.BR CONFIG_SECURITY_YAMA ,
> +which when /proc/sys/kernel/yama/ptrace_scope is 2 (the default) limits
> +.BR kcmp()
> +to child processes.
>  .TP
>  .B ESRCH
>  Process
> 


-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html