2.05 release

Prepare for 2.05 release

Various further wording changes related to open file description, etc.

Minor wording changes

one word change

Slight rewording

Spelling fixes

Spelling/typo fixes

Typos fixes from A Costa (16 May 05, Debian "manpages").

The return value of isinf() changed in glibc 2.02
to differentiate positive and neagtive infinity.
See: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=285765

Replaced "selection(1)" by "gpm(8)" under SEE ALSO

strtold() and strtof() need _ISOC99_SOURCE of _XOPEN_SOURCE=600
As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=246668

Formatting changes

New link to uri.7

White space fix

Slight rewording

Remove confusing text describe real and effective IDs.
As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=285852

Change "chown root:mem /dev/null /dev/zero" to
"chown root:root /dev/null /dev/zero"

Change "chown root:mem /dev/mem" to "chown root:kmem /dev/mem"

Added tdestroy to .TH line

New link to tsearch.3

Added definition of Linux dirent structure.
Some formatting cleanups.

Added #define _BSD_SOURCE to prototype

whitespace cleanups

Noted that the nice value rande is -20..20 on some systems

Changed range documented in main text from -20..20 to -20..19.

Added .\" comment about behaviour change for
length == 0 in kernel 2.6.12.

Noted use of atexit() for establishing function to be invoked on shared library
unload.
Noted that atexit()-registered functions are not invoked on abnormal
termination.
Formatting fixes.

Formatting fixes

Reversed 2.04 introduction of the term "process termination function".
Minor rewording and formatting fixes.

Reversed 2.04 introduction of the term "process termination function".

The short sleep bug (up to 1 jiffy) that was newly noted in
man-pages-2.04 has just been fixed in 2.6.12.

Minor wording changes

Added FIXME

Clarified what type of lock close() affects.
Minor formatting changes.

Consistent use of terms "open file description",
"file status flags", and "file decriptor flags"
Some rewriting of discussion of file descriptor flags
Under F_DUPFD, replaced some text duplicated in dup.2 with a cross ref to dup.2
Minor wording and formatting fixes

Consistent use of terms "open file description",
"file status flags", and "file decriptor flags"
Removed mention of lock sharing -- it was not accurate.
Minor formatting fixes

Clarification of term "open file description" along with
explanation of what information it maintains.
Various minor wording changes

Formatting changes

Minor fixes

Minor wording changes (after email with AEB).

Added ERANGE error

Initial setup for 2.05 release

Initial setup for 2.05 release

For 2.04 release

Getting ready for 2.04 release

Further tcp_stdurg and SIOCATMARK work; minor formatting fixes

Minor formatting fixes

Fixed descriptotion of header file reqmts in prototype,

Clarified semantics of relationship between flock() locks
and open file entries and file descriptors.
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=291121

Minor changes

Fix description of return value.

Add log1p(3) to SEE ALSO.
http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=309578

Fix typo: "_SC_2_DEV" should be "_SC_2_C_DEV"

When specifying resolved_path as NULL, realpath()
will (still) only allocate up to PATH_MAX bytes.
Plus other minor changes.
See also http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=239424

O_DIRECT needs _GNU_SOURCE.
O_ASYNC works for pipes and FIFOs in Linux 2.6
Vaious minor fixes

http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=194842

Because RAND_MAX is equal to INT_MAX, the following expression
contained in the manpage for rand(3) is slightly incorrect.
j=1+(int) (10.0*rand()/(RAND_MAX+1.0));

The correct expression should use parentheses to group the division
before the multiplication, thus yielding:
j=1+(int) (10.0*(rand()/(RAND_MAX+1.0)));

This is not an error where 10.0 is a floating point number, however
where 10.0 is replaced with an integer, this will cause the expression
to always evaluate to 1. (The addition of two parentheses would make
this bug a lot more difficult to make.)

See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=118752

Minor formatting change

Minor changes

More tcp_stdurg and SIOCATMARK work

Since Linux 2.6, the ru_nvcsw and ru_nivcsw fields are used.

Changed (char *) to (void *) in example.
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=313607

Arg for %p is a pointer to _a pointer to_ void.
As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=263109

BUGS: In kernels < 2.6.9, EPOLL_CTL_DEL required a non-NULL
'event', even though this argument is ignored.
As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=306517.

freopen(3) can change file descriptor associations of stin/stdout/stderr

strerror_r(3) requires #define _XOPEN_SOURCE 600

Rewrote description of return value.
As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=296183

Removed erroneous description of makecontext() return value.
As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=311800

removed fixed FIXMEs

formatting

More SIOCATMARK cahnges.

global edit s/ -1/ \\-1/g

Global edit: s/nonzero/non-zero/

Various wording and foratting fixes

Various wording and formatting fixes.
Incorporated some new /proc/sys/net/ipv4/tcp_* file descriptions
from the 2.6.12 source file Documentation/networking/ip-sysctl.txt.

Added pointer to ip(7) and proc(7) for /proc/sys/net

RLIMIT_RSS only has affect "in 2.4.x", not "in 2.4 and later".

Added FIXME for mqueue files

Fixes in discussion of SIOCATMARK + general wording and formatting
clean-ups.

Various minor changes

Wording improvements

Wording improvements

Various minor changes

Small wording fix.

Salut Olivier (and Nishanth),

Regarding man page documentation of the problem of short sleeps
for setiteimer(2)...

> > -- pointers to those threads
>
> http://bugzilla.kernel.org/show_bug.cgi?id=4569
> http://lkml.org/lkml/2005/4/29/163
>
> > -- indications of which kernel versions show this bahaviour
>
> AFAIK, all versions as far as x86 is concerned.
> Dunno if it is hardware specific.
>
> > -- a (short) test program to demonstrate it, if you have one.
>
> See the bugzilla bug's attachments

Sorry for the long delay in following this up, but I've got to
it now.  I tweaked your suggestions slightly:

{{
Timers will never expire before the requested time,
-instead expiring some short, constant time afterwards, dependent
-on the system timer resolution (currently 10ms).
+but may expire some (short) time afterwards, which depends
+on the system timer resolution and on the system load.
+Upon expiration, a signal will be generated and the timer reset.
+If the timer expires while the process is active (always true for

+On certain systems (including x86), the Linux kernel has a bug which will
+produce premature timer expirations of up to one jiffy under some
+circumstances.
}}

Thanks for this bug reporet,

Nishanth: if and when your changes are accepted, and the problem
is thus fixed, could you please send me a notification of that
fact, and I can then further amend the manual pages.

Cheers,

Michael

/* itimer_short_interval_bug.c

   June 2005

   In current Linux kernels, an interval timer set using setitimer()
   can sometimes sleep *less* than the specified interval.
   This program demonstrates the behaviour by looping through all
   itimer values from 1 microsecond upwards, in one microsecond steps.
*/
/* Adapted from a program by Olivier Croquette, June 2005 */

#include <stdio.h>
#include <stdlib.h>
#include <unistd.h>
#include <sys/types.h>
#include <sys/time.h>
#include <sys/wait.h>

typedef unsigned long long int u_time_t; /* in microsecs */

static int handler_flag;

/* return time as a number of microsecs  */

static u_time_t
gettime(void )
{
    struct timeval tv;

    if ( gettimeofday(&tv, NULL) == -1) {
        perror("gettimeofday()");
        return 0;
    }
    return (tv.tv_usec + tv.tv_sec * 1000000LL);
}

static void
handler (int sig, siginfo_t *siginfo, void *context)
{
    handler_flag++;
    return ;
}

/* Sleep for 'time' microsecs. */
static int
isleep(u_time_t time)
{
    struct itimerval  newtv;
    sigset_t sigset;
    struct sigaction  sigact;

    if (time == 0)
        return 0;

    /* block SIGALRM */
    sigemptyset (&sigset);
    sigaddset (&sigset, SIGALRM);
    sigprocmask (SIG_BLOCK, &sigset, NULL);

    /* set up our handler */
    sigact.sa_sigaction  = handler;
    sigemptyset(&sigact.sa_mask);
    sigact.sa_flags = SA_SIGINFO;
    sigaction (SIGALRM, &sigact, NULL);

    newtv.it_interval.tv_sec  = 0;
    newtv.it_interval.tv_usec = 0;
    newtv.it_value.tv_sec     = time / 1000000;
    newtv.it_value.tv_usec    = time % 1000000;
    if (setitimer(ITIMER_REAL,&newtv,NULL) == -1) {
        perror("setitimer(set)");
        return 1;
    }

    sigemptyset (&sigset);
    sigsuspend (&sigset);
    return 0;
}

int
main(int argc, char *argv[]) {
    u_time_t wait;
    int loop, numLoops;
    u_time_t t1, t2;
    u_time_t actual;
    long long minDiff, maxDiff, totDiff, diff;
    int numFail = 0;

    if (argc != 2) {
fprintf(stderr, "Usage: %s num-loops\n", argv[0]);
exit(EXIT_FAILURE);
    } /* if */

    numLoops = atoi(argv[1]);
    setbuf(stdout, NULL);

    for (wait = 1; ; wait++) {
maxDiff = 0;
numFail = 0;
totDiff = 0;
minDiff = -wait;

        if (wait % 10000 == 0)
    printf("%llu\n", wait);

for (loop = 0; loop < numLoops; loop++) {
            t1 = gettime();

            handler_flag = 0;
            isleep(wait);

    if ( handler_flag != 1 )
                printf("Problem with the handler flag (%d)!\n", handler_flag);

            t2 = gettime();
            actual = t2 - t1;
            if ( actual < wait ) {
        diff = actual - wait;
if (diff < maxDiff)
    maxDiff = diff;
if (diff > minDiff)
    minDiff = diff;
totDiff += diff;
numFail++;
    } /* if */

        } /* for */
if (numFail > 0)
            printf("%llu: %3d fail (%4lld %4lld; avg=%6.1f)\n",
    wait, numFail, minDiff, maxDiff,
    (double) totDiff / numFail);
    } /* for */

    return 0;
} /* main */

Remove duplicated CLONE_VFORK text

Formatting fix

Updates

Fix discussion of alternate signals stack

New pthreads.7 page

Minor fix

Formatting fix

Initial set-up for 2.04 release

2.03 release

2.03 release

Updated copyright date

Noted that any thread in a thread group can wait for a child
that one of them creates using fork().

Fix typo

Hi Andries,

> The question came up whether execve of a suid binary while being ptraced
> would fail or ignore the suid part. The answer today seems to be the
> latter:
>
> E.g. (in 2.6.11) security/dummy.c:
>
> static void dummy_bprm_apply_creds (struct linux_binprm *bprm, int
> unsafe)
> {
>         if (bprm->e_uid != current->uid || bprm->e_gid != current->gid) {
>                 if ((unsafe & ~LSM_UNSAFE_PTRACE_CAP) &&
> !capable(CAP_SETUID)) {
>                         bprm->e_uid = current->uid;
>                         bprm->e_gid = current->gid;
>                 }
>         }
> }
>
> and fs/exec.c:
>
> void compute_creds(struct linux_binprm *bprm) {
>         int unsafe;
>
>         unsafe = unsafe_exec(current);
>         security_bprm_apply_creds(bprm, unsafe);
> }
>
> static inline int unsafe_exec(struct task_struct *p) {
>         int unsafe = 0;
>         if (p->ptrace & PT_PTRACED) {
>                 if (p->ptrace & PT_PTRACE_CAP)
>                         unsafe |= LSM_UNSAFE_PTRACE_CAP;
>                 else
>                         unsafe |= LSM_UNSAFE_PTRACE;
>         }
>         return unsafe;
> }
>
> That is: if the process that calls execve() is being traced,
> the LSM_UNSAFE_PTRACE bit is et in unsafe and security_bprm_apply_creds()
> will make sure the suid/sgid bits are ignored.
>
> ---
>
> In my man page I do not read anything like that. It says
>
>  EPERM  The process is being traced, the user is not the  superuser and
>         the file has an SUID or SGID bit set.
> and
>
>  If  the current program is being ptraced, a SIGTRAP is sent to it after
>  a successful execve().
>
>  If the set-uid bit is set on the program file pointed  to  by filename
>  the  effective user ID of the calling process is changed to that of the
>  owner of the program file.
>
> So, maybe this sentence should be amended to read
>
>  If the set-uid bit is set on the program file pointed  to  by filename
>  and the current process is not being ptraced, the  effective user ID
>  of the calling process is changed to ...

I changed your "current" to "calling" (to be consistent with the
rest of the page), but otherwise applied as you suggest.

The revision will appear in man-pages-2.03, which I can release
any time now.  Are you avialable to do an upload tomorrow?