Bug#992377: manpages-dev

2021-08-18 Thread Michael Kerrisk (man-pages)
tags 992377 fixed-upstream thanks Upstream maintainer here. The keyutils pages in Section 2 are an unusual case. The wrapper functions are provided in the libkeyutils library (instead of, as is conventional, the C library), as noted in the add_key(2) page. The package that provides that library

Bug#981171: [PATCH 6/6] Use subsection for environment

2021-01-30 Thread Michael Kerrisk (man-pages)
+291,13 @@ gives the name of a file containing aliases > to be used with > .BR gethostbyname (3). > .IP * > -.BR TZ " and " TZDIR > -give timezone information used by > -.BR tzset (3) > -and through that by functions like > -.BR ctime (3), > -.BR localtime (3), &g

Bug#981171: [PATCH 5/6] Create a section ENVIRONMENT

2021-01-30 Thread Michael Kerrisk (man-pages)
arated by white space, may precede > -.IR command . > -.PP > -Arguments may also be placed in the > -environment at the point of an > -.BR exec (3). > -A C program can manipulate its environment using the functions > -.BR getenv (3), > -.BR putenv (3), > -.BR setenv (3), > -and > -.BR unsetenv (3). > -.PP > Note that the behavior of many programs and library routines is > influenced by the presence or value of certain environment variables. > Examples include the following: > -- Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Linux/UNIX System Programming Training: http://man7.org/training/

Bug#981171: [PATCH 4/6] Better documentation of the environment mechanism

2021-01-30 Thread Michael Kerrisk (man-pages)
; +.PP > This array of strings is made available to the process by the > .BR execve (2) > call when a new program is started. Thanks, Michael [1] https://www.quickanddirtytips.com/education/grammar/a-versus-an -- Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Linux/UNIX System Programming Training: http://man7.org/training/

Bug#981171: [PATCH 3/6] Improve pager section by pointing to more

2021-01-30 Thread Michael Kerrisk (man-pages)
ommand-string operand to the .I sh\ \-c command shall be valid. +If +.B PAGER +is null or is not set, +then applications that launch a pager will default to a program such as +.BR less (1) +or +.BR more (1). .TP .BR EDITOR / VISUAL The user's preferred utility to edit text files. -- Michael

Bug#981171: [PATCH 1/6] Document that means at login time for HOME, LOGNAME, SHELL, USER

2021-01-30 Thread Michael Kerrisk (man-pages)
ere. > Many a system command has been > @@ -305,6 +330,7 @@ should consider renaming their option to > .BR login (1), > .BR printenv (1), > .BR sh (1), > +.BR su (1), > .BR tcsh (1), > .BR execve (2), > .BR clearenv (3), Thanks, Michael -- Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Linux/UNIX System Programming Training: http://man7.org/training/

Bug#981171: [PATCH 2/6] Document PATH resolution

2021-01-30 Thread Michael Kerrisk (man-pages)
r, use of this feature is deprecated, +and POSIX notes that a conforming application shall use +an explicit pathname (e.g., +.IR . ) +to specify the current working directory. +.IP (Similarly one has .B CDPATH used by some shells to find the target -- Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Linux/UNIX System Programming Training: http://man7.org/training/

Bug#981171: [PATCH 0/6][V2] environement (7)

2021-01-30 Thread Michael Kerrisk (man-pages)
le and formatting issues that could be improved. I find myself repeating some of the same points that I made when reviewing the last round of patches. This is rather demotivating for me, when I consider reviewing your patches. Thanks, Michael -- Michael Kerrisk Linux man-pages maintainer; http://www.

Bug#981171: [PATCH 01/13] Do not document mktemp (3)

2021-01-29 Thread Michael Kerrisk (man-pages)
Hello Bastien, On Fri, 29 Jan 2021 at 10:18, Bastien ROUCARIES wrote: > > Hi, > Le mer. 27 janv. 2021 à 22:28, Michael Kerrisk (man-pages) > a écrit : > > > > Salut Bastien, > > > > On 1/27/21 4:48 PM, roucaries.bast...@gmail.com wrote: > > > Fr

Bug#981171: [PATCH 03/13] Document that means at login time for HOME, LOGNAME, SHELL, USER

2021-01-29 Thread Michael Kerrisk (man-pages)
> Something like Note that behavior of su could lead to a mixed environment. Yes, that would be fine. -- Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Linux/UNIX System Programming Training: http://man7.org/training/

Bug#981171: [PATCH 06/13] Improve pager section by pointing to more

2021-01-29 Thread Michael Kerrisk (man-pages)
On Fri, 29 Jan 2021 at 12:00, Bastien Roucariès wrote: > > Le jeudi 28 janvier 2021, 09:31:00 UTC Michael Kerrisk (man-pages) a écrit : > > On 1/27/21 4:48 PM, roucaries.bast...@gmail.com wrote: > > > From: Bastien Roucariès > > > > > > More is the d

Bug#981171: Environment 7 improvments

2021-01-28 Thread Michael Kerrisk (man-pages)
in environ > [PATCH 10/13] Introduce ENVIRONMENT section > [PATCH 11/13] Reorganize the different environment section > [PATCH 12/13] Introduce the user custumization section > [PATCH 13/13] Document LINES and COLUMNS > -- Michael Kerrisk Linux man-pages maintainer; http://www.kern

Bug#981171: [PATCH 09/13] Document convention of string in environ

2021-01-28 Thread Michael Kerrisk (man-pages)
parent's environment. > .PP > -By convention the strings in > -.I environ > -have the form "\fIname\fP\fB=\fP\fIvalue\fP". > Common examples are: > .TP > .B USER Thanks, Michael -- Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Linux/UNIX System Programming Training: http://man7.org/training/

Bug#981171: [PATCH 08/13] Better documentation of the environment mechanism

2021-01-28 Thread Michael Kerrisk (man-pages)
environment or simply the environment. > +.PP > This array of strings is made available to the process by the > .BR exec (3) > call that started the process. > -- Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Linux/UNIX System Programming Training: http://man7.org/training/

Bug#981171: [PATCH 12/13] Introduce the user custumization section

2021-01-28 Thread Michael Kerrisk (man-pages)
> Examples include the following: > .IP * 3 > -.B TMPDIR > -influences the path prefix of names created by > -.BR mktemp (1), > -.BR mkstemp (3), > -.BR mkdtemp (3), > -.BR tmpfile (3), > -and other routines, and the temporary directory used by > -.BR sort (1) > -and other programs. > -.IP * > .BR LD_LIBRARY_PATH ", " LD_PRELOAD , > and other > .BR LD_* Thanks, Michael -- Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Linux/UNIX System Programming Training: http://man7.org/training/

Bug#981171: [PATCH 10/13] Introduce ENVIRONMENT section

2021-01-28 Thread Michael Kerrisk (man-pages)
process that executes > -.IR command . > -Multiple variable definitions, separated by white space, may precede > -.IR command . > -.PP > -Arguments may also be placed in the > -environment at the point of an > -.BR exec (3). > -A C program can manipulate its environment using t

Bug#981171: [PATCH 05/13] Add see also ld.so (8) for LD_ variables

2021-01-28 Thread Michael Kerrisk (man-pages)
ave been .BR ld.so (8). Thanks, Michael > .IP * > .B POSIXLY_CORRECT > makes certain programs and library routines follow -- Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Linux/UNIX System Programming Training: http://man7.org/training/

Bug#981171: [PATCH 06/13] Improve pager section by pointing to more

2021-01-28 Thread Michael Kerrisk (man-pages)
fall back > +.B more (1) > +or any suitable paging utility as the system default. > .TP > .BR EDITOR / VISUAL > The user's preferred utility to edit text files. > @@ -362,6 +367,7 @@ should use instead an explicit \(aq\fB.\fP\(aq. > .BR env (1), > .BR login (1), > .

Bug#981171: [PATCH 04/13] Document PATH resolution

2021-01-28 Thread Michael Kerrisk (man-pages)
> +should use instead an explicit \(aq\fB.\fP\(aq. > .SH SEE ALSO > .BR bash (1), > .BR csh (1), > @@ -343,6 +368,7 @@ should consider renaming their option to > .BR execve (2), > .BR clearenv (3), > .BR exec (3), > +.BR execlp (3), I think this line isn't needed.

Bug#981171: [PATCH 07/13] Better documentation of _GNU_SOURCE for environment

2021-01-28 Thread Michael Kerrisk (man-pages)
instead an explicit \(aq\fB.\fP\(aq. > .BR putenv (3), > .BR setenv (3), > .BR unsetenv (3), > +.NR feature_test_macros(7), > .BR locale (7), > .BR ld.so (8), > .BR pam_env (8) > -- Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Linux/UNIX System Programming Training: http://man7.org/training/

Bug#981171: [PATCH 13/13] Document LINES and COLUMNS

2021-01-28 Thread Michael Kerrisk (man-pages)
able as a command_string operand to the > @@ -307,9 +349,6 @@ See also > gives information on how to address a given terminal > (or gives the name of a file containing such information). > .IP * > -.BR COLUMNS " and " LINES > -tell applications about the window size,

Bug#981171: [PATCH 02/13] Add a note about portability of environment variable

2021-01-28 Thread Michael Kerrisk (man-pages)
eds to be more consistently done, and also in the commit message I would want much more precise details about where the info about each variable was foind. Thanks, Michael > .SH NOTES > The > .BR prctl (2) > -- Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Linux/UNIX System Programming Training: http://man7.org/training/

Bug#981171: [PATCH 03/13] Document that means at login time for HOME, LOGNAME, SHELL, USER

2021-01-28 Thread Michael Kerrisk (man-pages)
su -p > +preserves all the variables from the existing shell, and > +.I su - > +or > +.I su -l > +is the recommended way of getting a full root environment. > .SH BUGS > Clearly there is a security risk here. > Many a system command has been > @@ -306,6 +338,7 @@ shoul

Bug#981171: [PATCH 01/13] Do not document mktemp (3)

2021-01-27 Thread Michael Kerrisk (man-pages)
.BR env (1), > .BR login (1), > +.BR mktemp (1), > .BR printenv (1), > .BR sh (1), > .BR tcsh (1), > -- Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Linux/UNIX System Programming Training: http://man7.org/training/

Bug#656657: manpages: environ(7): Please clarify the usage of $PAGER and $EDITOR with regards to whitespace

2021-01-20 Thread Michael Kerrisk (man-pages)
https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=866060 seems to be related, and maybe the changes in the patch for that bug are sufficient to address the concerns in this bug? (That patch as just been taken upstream.) Thanks, Michael -- Michael Kerrisk Linux man-pages maintainer; http

Bug#942207: getauxval(3): Clarify that AT_EXECFN and AT_BASE_PLATFORM return pointers.

2021-01-20 Thread Michael Kerrisk (man-pages)
gt; LSM: AppArmor: enabled > > Versions of packages manpages-dev depends on: > ii manpages 5.02-1 > > manpages-dev recommends no packages. > > Versions of packages manpages-dev suggests: > ii man-db [man-browser] 2.8.7-3 > > -- no debconf information -- Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Linux/UNIX System Programming Training: http://man7.org/training/

Bug#866060: environ(7): please document the valid values of pathnames for SHELL, PAGER and EDITOR/VISUAL

2021-01-20 Thread Michael Kerrisk (man-pages)
d patch > > Please apply -- Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Linux/UNIX System Programming Training: http://man7.org/training/

Bug#976312: modf.3: wrong Feature Test Macro Requirements

2020-12-03 Thread Michael Kerrisk (man-pages)
d be >modff(), modfl(): > > instead. (modf is c89, but not modff) Thanks. I've fixed the upstream page. Cheers, Michael -- Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Linux/UNIX System Programming Training: http://man7.org/training/

Bug#933000: resolv.conf(5): refers to MAXNS in , but it's in res_state.h now

2020-11-06 Thread Michael Kerrisk (man-pages)
tags 933000 wontfix thanks Upstream maintainer here. As I previously explained, this is not a valid bug report, and should be closed.

Bug#909789: manpages-dev: stat(2) manpage on ENOENT for dangling symbolic links (broken links)

2020-11-06 Thread Michael Kerrisk (man-pages)
tags 909789 fixed-upstream thanks -- Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Linux/UNIX System Programming Training: http://man7.org/training/

Bug#959680: Unclear error handling of hsearch_r in manpage

2020-05-20 Thread Michael Kerrisk (man-pages)
her > system, that didn't mention errno. > > You are right the current version in Debian does clearly states how > the errors are communicate. > > Please close this bug. > > Sorry for the confusion, and thanks for a quick response. > > On Wed, 6 May 2020 at 10:27, Michael K

Bug#959680: Unclear error handling of hsearch_r in manpage

2020-05-06 Thread Michael Kerrisk (man-pages)
ent of an error, these two functions set errno to indicate the cause of the error. This seems clear to me, or, otherwise, I really am missing your point, I'm sorry. -- Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Linux/UNIX System Programming Training:

Bug#959680: Unclear error handling of hsearch_r in manpage

2020-05-04 Thread Michael Kerrisk (man-pages)
On Sun, 3 May 2020 at 20:45, Witold Baryluk wrote: > > Package: manpages-dev > Version: 5.06-1 > Severity: normal > > Reading manual: > > """ > int hsearch_r(ENTRY item, ACTION action, ENTRY **retval, > struct hsearch_data *htab); > > Return Value: > > hsearch_r() returns nonzero on

Bug#947091: manpages-dev: timerfd_settime can fail with ECANCELED

2020-04-02 Thread Michael Kerrisk (man-pages)
tags 947091 fixed-upstream thanks

Bug#947091: manpages-dev: timerfd_settime can fail with ECANCELED

2020-04-02 Thread Michael Kerrisk (man-pages)
tags 947091 fixed-upstream thanks

Bug#947091: manpages-dev: timerfd_settime can fail with ECANCELED

2020-04-02 Thread Michael Kerrisk (man-pages)
tags fixed-upstrream thanks I applied the following patch upstream. diff --git a/man2/timerfd_create.2 b/man2/timerfd_create.2 index ec137fbfe..98225dcad 100644 --- a/man2/timerfd_create.2 +++ b/man2/timerfd_create.2 @@ -477,6 +477,9 @@ is not a valid timerfd file descriptor. .BR

Bug#947091: manpages-dev: timerfd_settime can fail with ECANCELED

2020-04-02 Thread Michael Kerrisk (man-pages)
Here's a pointer to the upstream discussion: https://lore.kernel.org/linux-man/4c557b44-4e4e-a689-a17b-f95e6c5ee...@gmail.com/T/#t

Bug#947091: manpages-dev: timerfd_settime can fail with ECANCELED

2020-04-01 Thread Michael Kerrisk (man-pages)
> that is my past experiencw with it, so I suggest adding "additional" here: > >The file descriptor returned by timerfd_create() supports the >following additional operations: Yes, that makes sense. Done. (But not yet pushed to Git.) -- Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Linux/UNIX System Programming Training: http://man7.org/training/

Bug#942207: getauxval(3): Clarify that AT_EXECFN and AT_BASE_PLATFORM return pointers.

2019-10-12 Thread Michael Kerrisk (man-pages)
tags 942207 fixed-upstream thanks On Sat, 12 Oct 2019 at 12:51, Witold Baryluk wrote: > > Package: manpages-dev > Version: 5.02-1 > Severity: normal > > Example: > >AT_PLATFORM > A pointer to a string that identifies the hardware platform > that the program is run‐ >

Bug#931325: manpages-dev: io_cancel can fail with EINTR

2019-08-26 Thread Michael Kerrisk (man-pages)
ht do so--although I can't think of specific cases--but I want to be able to check this.) Thanks, Michael -- Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Linux/UNIX System Programming Training: http://man7.org/training/

Bug#931325: manpages-dev: io_cancel can fail with EINTR

2019-08-20 Thread Michael Kerrisk (man-pages)
Hello Marc, On 7/1/19 10:34 PM, Marc Lehmann wrote: Package: manpages-dev Version: 4.16-2 Severity: minor Dear Maintainer, I found that, at least with debians 4.19 kernel, io_cancel can fail with EINTR on signal delivery, which should be documented as per similar calls. Can you provide some

Bug#933000: resolv.conf(5): refers to MAXNS in , but it's in res_state.h now

2019-07-29 Thread Michael Kerrisk (man-pages)
3 /* max # name servers we'll track */ Upstream maintainer here... This report is invalid. includes bits/types/res_state.h I suggest closing this bug. Thanks, Michael -- Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Linux/UNIX System Programming Training: http://man7.org/training/

Bug#932382: manpages-dev: getutline(3): missing #include in example program

2019-07-20 Thread Michael Kerrisk (man-pages)
be a good example ☻ Upstream maintainer here. Fixed for the upcoming 5.02 release. Thanks for the report! Cheers, Michael -- Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Linux/UNIX System Programming Training: http://man7.org/training/

Bug#926292: manpages-dev: memfd_create needs sys/mman.h, not sys/memfd.h

2019-04-15 Thread Michael Kerrisk (man-pages)
tags 926292 fixed-upstream thanks On Sun, 14 Apr 2019 at 19:16, Michael Kerrisk (man-pages) wrote: > > tags 926292 fixed-upstream > thanks > > On Wed, 3 Apr 2019 at 04:42, Marc Lehmann wrote: > > > > Package: manpages-dev > > Version: 4.16-1 > >

Bug#926292: manpages-dev: memfd_create needs sys/mman.h, not sys/memfd.h

2019-04-14 Thread Michael Kerrisk (man-pages)
t; ii manpages 4.16-1 > > manpages-dev recommends no packages. > > Versions of packages manpages-dev suggests: > ii konqueror [man-browser] 4:16.08.3-1 > ii man-db [man-browser] 2.7.6.1-2 > > -- no debconf information > -- Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Linux/UNIX System Programming Training: http://man7.org/training/

Bug#926292: manpages-dev: memfd_create needs sys/mman.h, not sys/memfd.h

2019-04-12 Thread Michael Kerrisk (man-pages)
emd (via /run/systemd/system) > > Versions of packages manpages-dev depends on: > ii manpages 4.16-1 > > manpages-dev recommends no packages. > > Versions of packages manpages-dev suggests: > ii konqueror [man-browser] 4:16.08.3-1 > ii man-db [man-browser] 2.7.6.1-2

Bug#915874: rename(1): incorrect note since glibc 2.28

2018-12-08 Thread Michael Kerrisk (man-pages)
flags and a non-existing destination (and therefore has a race condition >that can clobber the destination inadvertently). > > So please correct the man page accordingly, as glibc 2.28 is now in > unstable. > > Thanks! > > cheers, josch > > -- Michael Kerris

Bug#909789: manpages-dev: stat(2) manpage on ENOENT for dangling symbolic links (broken links)

2018-09-28 Thread Michael Kerrisk (man-opages)
tags fixed-upstream thanks On 09/28/2018 01:38 PM, Alessandro Vesely wrote: Package: manpages-dev Version: 4.10-2 Severity: minor Dear Maintainer, Hello Ale, Upstream maintainer here... it seems to be a gotcha having stat(x, y) unexpectedly return -1 when x is a broken link. The stat(1)

Bug#882222: Document security problems with system.3 and popen.3 (argument injection)

2017-11-23 Thread Michael Kerrisk (man-pages)
Hello Bastien On 22 November 2017 at 14:53, Bastien ROUCARIES <roucaries.bast...@gmail.com> wrote: > On Wed, Nov 22, 2017 at 2:45 PM, Michael Kerrisk (man-pages) > <mtk.manpa...@gmail.com> wrote: >>> Could you also warn about popen ? >> >> I alrea

Bug#882222: Document security problems with system.3 and popen.3 (argument injection)

2017-11-22 Thread Michael Kerrisk (man-pages)
rogram. ? > BTW escaping char is hard with shell, better to use execvp Agreed. I would not attempt escaping. Safer to allow only a whitelist of permited characters from user input. Cheers, Michael -- Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Linux/UNIX

Bug#882222: Document security problems with system.3 and popen.3 (argument injection)

2017-11-22 Thread Michael Kerrisk (man-pages)
user-supplied input.) Cheers, Michael [1] https://wiki.sei.cmu.edu/confluence/pages/viewpage.action?pageId=87152177 [2] For example, https://wiki.sei.cmu.edu/confluence/display/c/SIG34-C.+Do+not+call+signal%28%29+from+within+interruptible+signal+handlers seems simply confused. -- Michael Kerrisk Linux man-pa

Bug#764449: core.5: please mention security implications of /proc/sys/kernel/core_pattern

2017-09-29 Thread Michael Kerrisk (man-pages)
After, looking at this for quite a while, I am not convinced there's an issue here. %e is returned as just the basename of the executable path, and %t and %E seem even less problematic. If you think there's an issue, it would be good to show a worked example of how an "innocent" core_pattern pipe

Bug#860559: timex.offset unit ambiguity

2017-04-19 Thread Michael Kerrisk (man-pages)
uite a long time back (2014). Take a look at http://man7.org/linux-man-pages/man2/adjtimex.2.html ; does that version match what you expect? Cheers, Michael -- Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Linux/UNIX System Programming Training: http://man7.org/training/

Bug#859514: file conflict with keyutils

2017-04-05 Thread Michael Kerrisk (man-pages)
These manual pages recently (about 3 meeks ago) migrated from the upstream keyutils project to the upstream man-pages project. See http://linux-man-pages.blogspot.de/2017/03/man-pages-410-is-released.html . They have been removed in the upstream keyutils project in its latest release 9which

Bug#859511: libbsd-dev: trying to overwrite '/usr/share/man/man3/explicit_bzero.3.gz', which is also in package manpages-dev 4.10-1

2017-04-05 Thread Michael Kerrisk (man-pages)
xplicit_bzero() first appeared in glibc 2.25. > > So, IMHO, manpages-dev does the right thing by providing this > man page. I think so. Cheers, Michael -- Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Linux/UNIX System Programming Training: http://man7.org/training/

Bug#847998: [Pkg-sysvinit-devel] Bug#847998: manpages: file conflicts with initscripts

2016-12-16 Thread Michael Kerrisk (man-pages)
Hello Thorsten, On 12/16/2016 03:36 PM, Thorsten Glaser wrote: > On Fri, 16 Dec 2016, Michael Kerrisk (man-pages) wrote: > >> On 12/16/2016 02:53 PM, Thorsten Glaser wrote: >>> On Fri, 16 Dec 2016, Michael Kerrisk (man-pages) wrote: >>> >>>> That doesn'

Bug#847998: [Pkg-sysvinit-devel] Bug#847998: manpages: file conflicts with initscripts

2016-12-16 Thread Michael Kerrisk (man-pages)
On 12/16/2016 02:53 PM, Thorsten Glaser wrote: > On Fri, 16 Dec 2016, Michael Kerrisk (man-pages) wrote: > >> That doesn't document (upstream) reality though. Once upon a time, >> there were one or two Section 9 pages in the man-pages >> project. No one updated them or add

Bug#847998: [Pkg-sysvinit-devel] Bug#847998: manpages: file conflicts with initscripts

2016-12-16 Thread Michael Kerrisk (man-pages)
On 12/16/2016 02:37 PM, Axel Beckert wrote: > Hi, > > Thorsten Glaser wrote: >> On Tue, 13 Dec 2016, Michael Kerrisk (man-pages) wrote: >>> Upstream man-pages maintainer here; I just added tmpfs(5), unaware >>> that it would create a conflict for Debian;

Bug#847998: [Pkg-sysvinit-devel] Bug#847998: manpages: file conflicts with initscripts

2016-12-16 Thread Michael Kerrisk (man-pages)
comes from the package man-db. > > Hmm. So we could conceivably move the manpage about the > tmpfs filesystem to section 9 as a Debian-local patch > (since upstream appears to prefer to not have such a > section), and then all will be good™. Is there already something in Section 9 on

Bug#848231: bugs in scandir example program

2016-12-15 Thread Michael Kerrisk (man-pages)
On 15 December 2016 at 14:56, Ian Jackson <ijack...@chiark.greenend.org.uk> wrote: > Michael Kerrisk (man-pages) writes ("Re: Bug#848231: bugs in scandir example > program"): >> tags 848231 fixed-upstream >> thanks > ...> >> On 15 Decemb

Bug#848231: bugs in scandir example program

2016-12-15 Thread Michael Kerrisk (man-pages)
> + return 0; > } > Thanks, Ian. Fixed pretty much as you suggest. The program doesn't even compile as it was given! Looks like I injected the error after a user report 4 years ago (changed "0" to "NULL"). Cheers, Michael -- Michael Kerrisk Linux m

Bug#848121: [Pkg-sysvinit-devel] File conflict between manpages and initscripts

2016-12-14 Thread Michael Kerrisk (man-pages)
On 14 December 2016 at 16:45, Ian Jackson wrote: > Axel Beckert writes ("Bug#848121: [Pkg-sysvinit-devel] File conflict between > manpages and initscripts"): >> I must admit that I never was aware that filesystems are in the same >> manual section as file formats

Bug#848121: [Pkg-sysvinit-devel] Bug#848121: File conflict between manpages and initscripts

2016-12-14 Thread Michael Kerrisk (man-pages)
: | Debian Developer, ftp.ch.debian.org Admin > `. `' | 4096R: 2517 B724 C5F6 CA99 5329 6E61 2FF9 CD59 6126 16B5 > `-| 1024D: F067 EA27 26B9 C3FC 1486 202E C09E 1D89 9593 0EDE > -- Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Linux/UNIX System Programming Training: http://man7.org/training/

Bug#847998: manpages: file conflicts with initscripts

2016-12-13 Thread Michael Kerrisk (man-pages)
On 13 December 2016 at 10:56, Thorsten Glaser <t.gla...@tarent.de> wrote: > On Tue, 13 Dec 2016, Michael Kerrisk (man-pages) wrote: > >> I can't move "them" as they come from diverse projects (nfs-utils, > > OK. > >> e2fsprogs, btrfs-progs). O

Bug#847998: manpages: file conflicts with initscripts

2016-12-13 Thread Michael Kerrisk (man-pages)
nd > proc(5), for example. Actually, other operating systems also seemed to come to the same conclusion. For FreeBSD, I see the following in Section 5: $ ls -1 *fs.5 autofs.5 devfs.5 ext2fs.5 fdescfs.5 fs.5 linprocfs.5 linsysfs.5 mqueuefs.5 msdosfs.5 nandfs.5 nullfs.5 procfs.5 tmpfs.5 Note th

Bug#847998: manpages: file conflicts with initscripts

2016-12-13 Thread Michael Kerrisk (man-pages)
Hello Thorsten, On 13 December 2016 at 10:43, Thorsten Glaser <t.gla...@tarent.de> wrote: > On Tue, 13 Dec 2016, Michael Kerrisk (man-pages) wrote: > >> Upstream man-pages maintainer here; I just added tmpfs(5), unaware >> that it would create a conflict for Debian;

Bug#847998: manpages: file conflicts with initscripts

2016-12-13 Thread Michael Kerrisk (man-pages)
covers a kernel concept (here: a filesystem). Not sure where this idea originates. There is no Section 9 on Linux. And there's certainly precedent for section 5 pages on filesystems. For example, among others, we have ext4(5), btrfs(5), and nfs(5). I'm not sure what the best path forward here is.

Bug#574041: [daniel.bal...@gmail.com: man 2 write - clarification]

2016-12-10 Thread Michael Kerrisk (man-pages)
March 2014 at 08:34, Michael Kerrisk (man-pages) <mtk.manpa...@gmail.com> wrote: > On Sun, Mar 14, 2010 at 9:24 PM, Joey Schulze <j...@infodrom.org> wrote: >> Package: manpages-dev >> Version: 3.24-1 >> >> Forwarded mail from Daniel. >> >> ---

Bug#845172: manpages-dev: no function protypes in example from mbstowcs(3)

2016-11-21 Thread Michael Kerrisk (man-pages)
Upstream maintainer here. I added the missing include. But I am unsure what to do about the other point (regarding gcc -Wconversion). There is an analogous situation with islower() and similar functions, where the solution is described by an update I recently added for the upcoming upstream

Bug#839705: manpages-dev: "initial state" in mbstowcs(3) and wcstombs(3)

2016-10-12 Thread Michael Kerrisk (man-pages)
se > > including the terminating null wide character ('\0') > > should be changed to > > including the terminating null byte ('\0') I fixed this. Thanks. Cheers, Michael -- Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Linux/UNIX System Programming Training: http://man7.org/training/

Bug#839705: manpages-dev: "initial state" in mbstowcs(3) and wcstombs(3)

2016-10-12 Thread Michael Kerrisk (man-pages)
nitial shift state. The number of bytes written to .IR dest , excluding the terminating null byte (\(aq\\0\(aq), is returned. -- Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Linux/UNIX System Programming Training: http://man7.org/training/

Bug#840499: manpages-dev: Inconsistent symbolic error name for EILSEQ in errno(3)

2016-10-12 Thread Michael Kerrisk (man-pages)
linked to /bin/dash > Init: systemd (via /run/systemd/system) > > Versions of packages manpages-dev depends on: > ii manpages 4.07-1 > > manpages-dev recommends no packages. > > Versions of packages manpages-dev suggests: > ii man-db [man-browser] 2.7.5-1 > > --

Bug#840499: manpages-dev: Inconsistent symbolic error name for EILSEQ in errno(3)

2016-10-12 Thread Michael Kerrisk (man-pages)
linked to /bin/dash > Init: systemd (via /run/systemd/system) > > Versions of packages manpages-dev depends on: > ii manpages 4.07-1 > > manpages-dev recommends no packages. > > Versions of packages manpages-dev suggests: > ii man-db [man-browser] 2.7.5-1 > > --

Bug#838956: manpages-dev: Inconsistent documentation in NOTES section of "man wcstombs"

2016-10-02 Thread Michael Kerrisk (man-pages)
The function .BR wcsrtombs (3) -provides a thread safe interface to -the same functionality. +provides a better interface to the same functionality. .SH SEE ALSO .BR mblen (3), .BR mbstowcs (3), -- Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Linux/UNIX

Bug#838958: Fwd: Bug#838958: linux: mount(2) _silently_ ignores other mountflags when MS_BIND is set

2016-09-27 Thread Michael Kerrisk (man-pages)
of the bind mount can be changed in this manner. Cheers, Michael -- Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Linux/UNIX System Programming Training: http://man7.org/training/ -- Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Linux

Bug#741360: statm "share" badly described

2016-09-10 Thread Michael Kerrisk (man-pages)
s\fP) -shared (3) shared pages (i.e., backed by a file) +shared (3) number of resident shared pages (i.e., backed by a file) + (same as RssFile+RssShmem in \fI/proc/[pid]/status\fP) text (4) text (code) .\" (not including libs; broken, includes data segment) lib(

Bug#825548: quotactl(2) man page is incorrect

2016-06-01 Thread Michael Kerrisk (man-pages)
of allocated inodes */ uint64_t dqb_isoftlimit; /* preferred inode limit */ -- Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Linux/UNIX System Programming Training: http://man7.org/training/

Bug#825022: man pages for *xattr syscalls are missing from manpages-dev

2016-05-24 Thread Michael Kerrisk (man-pages)
Note that around May 2015, by mutual agreement between the man-pages and libattr projects (which hitherto had both carried versions of the *xattr(2) pages), man-pages became the canonical home for these pages, and the versions in the libattr project were dropped. Maybe Debian has not caught up

Bug#717629: please document LANG and LC_ALL in locale(1)

2016-03-13 Thread Michael Kerrisk (man-pages)
tags 717629 fixed-upstream thanks Hello Vincent, On 03/14/2016 07:24 AM, Vincent Lefevre wrote: > On 2016-03-14 06:56:56 +1300, Michael Kerrisk (man-pages) wrote: >> The goal of the upstream locale(1) page is to document the syntax of >> the command. > > It did more t

Bug#717629: please document LANG and LC_ALL in locale(1)

2016-03-13 Thread Michael Kerrisk (man-pages)
at control the locale (see locale(7)). And all of the relevant locale environment variables, including LC_ALL and LANG, are documented in locale(7). Cheers, Michael -- Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Linux/UNIX System Programming Training: http://man7.org/training/

Bug#743525: symlink permissions misdescribed

2016-03-12 Thread Michael Kerrisk (man-pages)
tags 715261 fixed-upstream thanks Yes, there are odd exceptions. Under /proc/PID, there are some "magic" symlinks that have other permissions. I"ve added some text to the man page to note this. Thanks for the report. On Linux, the permissions of a symbolic link are not used in

Bug#715261: manpages-dev: readdir_r should be strongly discouraged due to security reasons

2016-03-12 Thread Michael Kerrisk (man-pages)
tags 715261 fixed-upstream thanks glibc 2.24 marks readdir_r() deprecated, and for the upcoming man-pages-4.05 release, I've significantly reworked the man page to note the problems and indicate that the function is deprecated. Thanks, Michael

Bug#679323: clearenv(3): implies that it's a security tool

2016-02-19 Thread Michael Kerrisk (man-pages)
On 18 February 2016 at 21:34, Matt Zimmerman wrote: > Thanks for following up. My recommendation is to say something like: > > This function DOES NOT securely erase the contents of the environment. > Security-conscious applications which need to do this should use >

Bug#756599: printf(3) manpage: stray asterisk in "NAN*"

2016-02-17 Thread Michael Kerrisk (man-pages)
mmit 4a66305922b197) Thanks for the report, Jakub. And thanks for reminding me of this bug, Stéphane. Cheers, Michael -- Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Linux/UNIX System Programming Training: http://man7.org/training/

Bug#799674: Properly document l/ll length modifier for double/long double argument

2015-12-29 Thread Michael Kerrisk (man-pages)
On 12/28/2015 08:39 AM, Mathieu Malaterre wrote: > On Sat, Dec 26, 2015 at 4:54 PM, Michael Kerrisk (man-pages) > <mtk.manpa...@gmail.com> wrote: >> (Upstream mainatiner here.) >> >> On 09/21/2015 03:08 PM, Mathieu Malaterre wrote: >>> Package: manpag

Bug#804210: Invalid documentation for return value of sscanf

2015-12-27 Thread Michael Kerrisk (man-pages)
g failure occurs. EOF is also returned if a read error occurs, in which case the error indicator for the stream (see ferror(3)) is set, and errno is set to indicate the error. ? Thanks, Michael -- Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Linux/UNIX System Programming Training: http://man7.org/training/

Bug#799674: Properly document l/ll length modifier for double/long double argument

2015-12-26 Thread Michael Kerrisk (man-pages)
nt. > > Accordingly 'll' and 'L' may need to be updated. So, I looked at this report, and I can't understand what the problem is that is being reported. What precisely do you think needs fixing? Cheers, Michael -- Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Linux/UNIX System Programming Training: http://man7.org/training/

Bug#803459: drand48(3): errors on interval bounds

2015-12-17 Thread Michael Kerrisk (man-pages)
ormly distributed between \-2^31 and 2^31. +integers uniformly distributed over the interval [\-2^31,\ 2^31). .PP The .BR srand48 (), -- Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Linux/UNIX System Programming Training: http://man7.org/training/

Bug#794876: manpages-dev: Should guide users away from deprecated sys_errlist more

2015-08-08 Thread Michael Kerrisk (man-pages)
actual text. Hello Dale, Your submission would be much better to understand as a diff (preferably against latest upstream), with an explanation of how your proposed changes address the problem you encountered. Thanks, Michael -- Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc

Bug#794217: socketpair: unclear where the SOCK_NONBLOCK and SOCK_CLOEXEC flags go

2015-08-07 Thread Michael Kerrisk (man-pages)
to /bin/dash Init: sysvinit (via /sbin/init) Versions of packages manpages-dev depends on: ii manpages 3.61-1 manpages-dev recommends no packages. Versions of packages manpages-dev suggests: ii man-db [man-browser] 2.6.7.1-1 -- no debconf information -- Michael Kerrisk Linux

Bug#794559: ld.so(8) LD_LIBRARY_PATH also treats ';' as a seperator

2015-08-05 Thread Michael Kerrisk (man-pages)
libraries at execution-time. +The items in the list are separated by either colons or semicolons. Similar to the .B PATH environment variable. -- Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Linux/UNIX System Programming Training: http://man7.org/training

Bug#788870: Processed: Bug#788870: [base-files] 'LANG=C man 8 resolv+': (fwd)

2015-06-16 Thread Michael Kerrisk (man-pages)
. Please contact me if you need assistance. -- 788870: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=788870 Debian Bug Tracking System Contact ow...@bugs.debian.org with problems -- Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Linux/UNIX System

Bug#787625: /usr/share/man/man7/epoll.7.gz: epoll(7): wrong string provided to perror in example code

2015-06-05 Thread Michael Kerrisk (man-pages)
tags 787625 fixed-upstream thanks Fixed with upstream commit be6b243ae2d6b3ba158684c945076a1fd65a6f2f On 4 June 2015 at 16:49, Michael Kerrisk (man-pages) mtk.manpa...@gmail.com wrote: On 06/03/2015 03:17 PM, Uwe Kleine-König wrote: Package: manpages Version: 3.74-1 Severity: minor File

Bug#787625: /usr/share/man/man7/epoll.7.gz: epoll(7): wrong string provided to perror in example code

2015-06-04 Thread Michael Kerrisk (man-pages)
recommends no packages. Versions of packages manpages suggests: ii man-db [man-browser] 2.7.0.2-5 -- no debconf information -- Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Linux/UNIX System Programming Training: http://man7.org/training

Bug#630029: Processed: retitle 630029 to read/write/readv/writev/sendfile.2: undocumented cap on number of bytes read/written

2015-05-11 Thread Michael Kerrisk (man-pages)
tags 630029 fixed-upstream thanks And here's the documentation fix. Thanks, Michael diff --git a/man2/pread.2 b/man2/pread.2 index de1e951..c7a7fdd 100644 --- a/man2/pread.2 +++ b/man2/pread.2 @@ -85,6 +85,12 @@ and .BR pwrite () returns the number of bytes written. +Note that is not an

Bug#621057: printf.3: ATTRIBUTES: Note functions those are thread-safe

2015-04-04 Thread Michael Kerrisk (man-pages)
(), +.BR vfprintf (), +.br +.BR vsprintf (), +.BR vsnprintf () +T} Thread safety MT-Safe locale +.TE + .SH CONFORMING TO The .BR fprintf (), -- Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Linux/UNIX System Programming Training: http://man7.org

Bug#773443: host.conf.5: spoof deprecated ?

2015-03-10 Thread Michael Kerrisk (man-pages)
Hello Stéphane, On 10 March 2015 at 00:26, Stéphane Aulery saul...@free.fr wrote: Hello Michael, Le lundi 09 mars 2015 à 10:03:09, Michael Kerrisk (man-pages) a écrit : On 03/09/2015 08:59 AM, Stéphane Aulery wrote: Le lundi 09 mars 2015 à 08:22:01, Michael Kerrisk (man-pages) a écrit

Bug#773443: [PATCH] host.conf.5: keywords and env. var. nospoof, spoofalert, spoof and RESOLV_SPOOF_CHECK were added to glibc 2.0.7 but never implemented

2015-03-10 Thread Michael Kerrisk (man-pages)
to setting it to +.IR nowarn . +.TP +.B RESOLV_SPOOF_CHECK +Overrides the +.IR nospoof , spoofalert and spoof +commands in the same way as the +.I spoof +command is parsed. +Valid values are +.IR off , nowarn and warn . .SH SEE ALSO .BR gethostbyname (3), .BR hosts (5), -- Michael

Bug#773443: host.conf.5: spoof deprecated ?

2015-03-09 Thread Michael Kerrisk (man-pages)
On 03/09/2015 08:59 AM, Stéphane Aulery wrote: Le lundi 09 mars 2015 à 08:22:01, Michael Kerrisk (man-pages) a écrit : Hello Stéphane On 03/08/2015 02:05 PM, Stéphane Aulery wrote: ** COPY OF GLIBC BUGZILLA #18091 FOR INFORMATION ** https://sourceware.org/bugzilla/show_bug.cgi?id=18091

Bug#773443: host.conf.5: spoof deprecated ?

2015-03-09 Thread Michael Kerrisk (man-pages)
(e.g., reference to source file and function). [1] https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=773443 -- Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Linux/UNIX System Programming Training: http://man7.org/training/ -- To UNSUBSCRIBE, email

  1   2   3   4   5   6   7   8   >