Commit Graph

7206 Commits

Author SHA1 Message Date
Michael Kerrisk b203e4d582 rt_tgsigqueueinfo.2: New link to new rt_sigqueueinfo.2 page
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-18 06:58:46 +02:00
Michael Kerrisk 23f438b540 rt_sigqueueinfo.2: New page for rt_sigqueueinfo(2) and rt_tgsigqueueinfo(2)
This replaces the previous '.so' man page link file for
rt_sigqueueinfo.2, which linked to ths sigqueue() man page.

Reported-by: Stephan Mueller <stephan.mueller@atsec.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-18 06:58:33 +02:00
Michael Kerrisk 70225000d6 wprintf.3: Add _ISOC95_SOURCE to feature test macro requirements
Since glibc 2.12, _ISOC95_SOURCE can also be used to expose
prototype of these functions.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-17 08:51:38 +02:00
Michael Kerrisk 38d9233365 fwide.3: Add _ISOC95_SOURCE to feature test macro requirements
Since glibc 2.12, _ISOC95_SOURCE can also be used to expose
prototype of this function.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-17 08:51:10 +02:00
Michael Kerrisk 370b4dff1e feature_test_macros.7: Document _ISOC95_SOURCE
_ISOC95_SOURCE was added in glibc 2.12 as a means
to expose C90 Amendment 1 definitions.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-17 08:38:51 +02:00
Michael Kerrisk 187b24f0ce Changes.old: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-17 07:33:42 +02:00
Michael Kerrisk d0e1cbceeb syscalls.2: Minor: remove duplicated open_by_handle() entry
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-17 07:11:02 +02:00
Michael Kerrisk c0604aba2f Changes.old: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-17 07:00:31 +02:00
Michael Kerrisk 377c74db1c Changes.old: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-17 06:59:44 +02:00
Paul Pluzhnikov cadcf1b16b prctl.2: PR_SET_DUMPABLE makes process non-ptrace-attachable
We've recently discovered that GDB will fail to attach to any
process that sets itself non-dumpable. Tested on kernel 2.6.32,
with:

int main(int argc, char *argv[])
{
    if (prctl(PR_SET_DUMPABLE, 0, 0, 0) != 0) {
        perror("prctl");
    }
    printf("Run gdb %s %d\n", argv[0], getpid());
    sleep(20);
    abort();
}

./a.out
Run gdb ./a.out 30476

gdb -q  ./a.out 30476
Reading symbols from /tmp/a.out...done.
Attaching to program: /tmp/a.out, process 30476
ptrace: Operation not permitted.
/tmp/30476: No such file or directory.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-17 06:10:54 +02:00
Paul Pluzhnikov 2e781e2082 prctl.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-17 06:08:35 +02:00
Michael Kerrisk f498fac3c3 Start of man-pages-3.34: updating Changes and Changes.old 2011-09-17 06:05:09 +02:00
Michael Kerrisk c993f95c21 Start of man-pages-3.34: updating .Announce and .lsm files 2011-09-17 06:05:08 +02:00
Michael Kerrisk d501ba274e Start of man-pages-3.34: renaming .Announce and .lsm files 2011-09-17 06:05:08 +02:00
Michael Kerrisk f62a99935c Ready for 3.33 2011-09-17 05:46:04 +02:00
Michael Kerrisk 1ad008e71e Removed trailing white space at end of lines 2011-09-17 05:45:55 +02:00
Michael Kerrisk 893e82ad06 Expanded tabs 2011-09-17 05:45:55 +02:00
Michael Kerrisk 1293f354e2 sendfile.2: wfix
Reported-by: Stefan Puiu <stefan.puiu@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-17 05:16:43 +02:00
Michael Kerrisk 5fb27aeb05 Changes: Updates for 3.33 release
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-16 07:02:20 +02:00
Michael Kerrisk f81c6cc693 fcntl.2, recv.2, crypt.3, err.3, strtoul.3, proc.5: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-16 07:02:06 +02:00
Michael Kerrisk 677e98a1b4 conj.3: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-16 07:00:49 +02:00
Michael Kerrisk 753983126f clog.3: SEE ALSO: Add reference to clog(2)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-16 07:00:49 +02:00
Michael Kerrisk bd2c87dbd1 cexp.3: SEE ALSO: add cexp(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-16 07:00:49 +02:00
Michael Kerrisk 5be56312b0 cacosh.3, casinh.3, catan.3, catanh.3: SEE ALSO: Add reference to inverse function
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-16 07:00:49 +02:00
Michael Kerrisk 587977c40b casin.3: SEE ALSO: s/csin/ccos/
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-16 07:00:49 +02:00
Michael Kerrisk f54fb0fa66 ccos.3, ccosh.3, csin.3, csinh.3, ctan.3, ctanh.3: SEE ALSO Add reference to "arc" inverse function
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-16 07:00:49 +02:00
Michael Kerrisk a1699a78e6 complex.7: Updated SEE ALSO list to include all complex math functions
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-16 07:00:49 +02:00
Michael Kerrisk 09a15e3d9e carg.3: Add "complex" to NAME line
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-16 07:00:49 +02:00
Michael Kerrisk 8fa05874cc cacos.3: Add example program
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-16 07:00:49 +02:00
Michael Kerrisk 849ef4a8ed catanh.3: Add example program
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-16 07:00:49 +02:00
Michael Kerrisk c05ed63add catan.3: Add example program
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-16 07:00:49 +02:00
Michael Kerrisk 8b57a223ab cacosh.3: Add example program
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-16 07:00:49 +02:00
Michael Kerrisk 4c3fa19d23 cacos.3, cacosh.3, catan.3, catanh.3: Fix formula describing function
The man pages for cacos(), cacosh(), catan(), catanh()
contain incorrect formulae describing the functions.

As reported by Richard B. Kreckel:

cacos, cacosf, cacosl:
    The formula given in the man page
      cacos(z) = -i clog(z + csqrt(z * z - 1))
    gives wrong results in second and fourth quadrant of
    complex plain.
    The formula
      cacos(z) = -i clog(z + I*csqrt(1 - z * z))
    gives correct results.

catan, catanf, catanl:
    The formula given in the man page
      catan(z) = 1 / 2i clog((1 + iz) / (1 - iz))
    gives wrong results on the negative imaginary axis beginning
    at -I (along one of the two branch cuts). Besides, the formula
    is written in an ambiguous way.
    The formula
      catan(z) = (clog(1 + iz) - clog(1 - iz)) / 2i
    gives correct results.

cacosh, cacoshf, cacoshl:
    The formula given in the man page
      cacosh(z) = (0.5) * clog((1 + z) / (1 - z))
    gives wrong results everywhere in the complex plain.
    (The formula seems to be copied from the one for catanh,
    where it is sometimes correct.)
    The formula
      cacosh(z) = 2 * clog(csqrt((z + 1)/2) + csqrt((z - 1)/2))
    gives correct results.

catanh, catanhf, catanhl:
    The formula given in the man page
      catanh(z) = 0.5 * clog((1 + z) / (1 - z))
    gives wrong results on the positive real axis beginning at 1
    (along one of the two branch cuts).
    The formula
      catanh(z) = 0.5 * (clog(1 + z) - clog(1 - z))
    gives correct results.

I've also checked casin, casinf, casinl, casinh, casinhf, and
casinhl and the formulae given there
      casin(z) = -i clog(iz + csqrt(1 - z * z))
      casinh(z) = clog(z + csqrt(z * z + 1))
are actually correct.

Reported-by: Richard B. Kreckel <kreckel@ginac.de>
Reviewed-by: Andries Brouwer <Andries.Brouwer@cwi.nl>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-16 07:00:49 +02:00
Hendrik Jan Thomassen 3d5be2aa85 unlink.2: Improve EBUSY description
The current version of the page says (under ERRORS):

> EBUSY (not on Linux)
>  The  file pathname cannot be unlinked because it is being
>  used by the system or another process and the
>  implementation considers this an error.

But if you look in the kernel source file fs/namei.c
at routine may_delete() you'll see two occasions where
an EBUSY is generated. So the above "not on Linux" is wrong.

I suggest that this '(not on Linux)' be removed. It may
also improve the page if the commentary is reworded to give a
better description of the two situations. Something along
the lines of:
> The file pathname cannot be unlinked because it is being used
> by the system, e.g. if some (relative) rootdir is mounted upon it,
> or because the NFS client software created it to represent an
> active but otherwise nameless inode ("NFS silly renamed").

Just FYI: the NFS silly rename (you'll find this term mentioned
in the kernel source code) is described at:
       http://nfs.sourceforge.net/#section_d
under section D2. The reason I found this manpage bug is because
I stumbled upon one of these silly renamed files, and an strace
of the rm-command revealed the EBUSY return errno.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-16 07:00:48 +02:00
Petr Pisar 31483837fc console_codes.4: Add ESC [ 3 J
Linux 3.0 (commit f8df13e0a901fe55631fed66562369b4dba40f8b)
implements \E[3J to allow scrambling content of console
including scroll-back buffer
(http://thread.gmane.org/gmane.linux.kernel/1125792).

This is useful at terminal lock to disallow attacker to scroll
visible window back and to see sensitive data. Other \E[J sequences
do not blank history.

\E[3J is superset of \E[2J. In other words, it clears visible screen too.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-16 07:00:48 +02:00
Michael Kerrisk c751683c17 unix.7: Add pointer to cmsg(3) for an example of use of SCM_RIGHTS
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-16 07:00:48 +02:00
Michael Kerrisk 3c5faf1171 crypt.3: Fix header file and feature test macro requirements for crypt_r()
Reported-by: Jan Engelhardt <jengelh@medozas.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-16 07:00:48 +02:00
Michael Kerrisk 12e263f178 open.2: wfix
Reported-by: Graham Gower <graham.gower@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-16 07:00:48 +02:00
Regid Ichira 20479b6639 fflush.3: Fix wording error
See http://bugs.debian.org/cgi-bin/bugreport.cgi?614021

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-16 07:00:48 +02:00
Michael Kerrisk 4c4d76cd30 memcmp.3: Clarify that comparison interprets bytes as "unsigned char"
Reported-by: Sebastian Unger <sebunger@gmx.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-16 07:00:48 +02:00
Tomislav Jonjic 612144c541 timerfd_create.2: Fix small error in description of timerfd_settime()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-16 07:00:48 +02:00
Michael Kerrisk 963da6c54d mlock.2: Clarify EINVAL error
See http://bugs.debian.org/cgi-bin/bugreport.cgi?625747

Reported-by: Brian M. Carlson <sandals@crustytoothpaste.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-16 07:00:48 +02:00
Simon Paillard 3cbd3fee32 get_mempolicy.2: spfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-16 07:00:48 +02:00
Michael Kerrisk 1e8a0addef execve.2: Note that the first argv[] value should contain name of executable
Reported-by: Sebastian Geiger <sbastig@gmx.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-16 07:00:48 +02:00
Tolga Dalman 866ed7369f sendfile.2: Add an explicit reference to splice(2)
Unlike sendfile(), splice() can transfer data
between a pair of sockets.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-16 07:00:48 +02:00
Michael Kerrisk 009cdc2239 timerfd_create.2: Note behavior when timerdfd_settime() old_value is NULL
See http://bugs.debian.org/cgi-bin/bugreport.cgi?641513
timerfd_settime(2) states that "The old_value argument returns a
structure containing the setting of the timer that was current at
the time of the call"; however, it does not mention that the
caller can pass NULL to ignore that value.  Only the example
shows that the caller can pass NULL.

Reported-by: Josh Triplett <josh@joshtriplett.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-16 07:00:48 +02:00
Michael Kerrisk bb0fed2e8a sendfile.2: Shift text on falling back to read()/write() to NOTES
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-16 07:00:48 +02:00
Michael Kerrisk c8a58c6aa0 sendfile.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-16 07:00:48 +02:00
Akira Fujita fe0ed23f6f sendfile.2: Since 2.6.33, 'out_fd' can refer to any file type
Linux kernel commit cc56f7de7f00d188c7c4da1e9861581853b9e92f
meant sendfile(2) can work with any output file.
Therefore the 'out_fd' of sendfile(2) can refer to any file
(since Linux 2.6.33).

Signed-off-by: Akira Fujita <a-fujita@rs.jp.nec.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-16 07:00:48 +02:00
Michael Kerrisk c39f51b0f2 syscalls.2: Update to mention 3.x kernel series
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-16 07:00:48 +02:00