Permalink
Switch branches/tags
man-pages-4.02 man-pages-4.01 man-pages-4.00 man-pages-3.83 man-pages-3.82 man-pages-3.81 man-pages-3.80 man-pages-3.79 man-pages-3.78 man-pages-3.77 man-pages-3.75 man-pages-3.74 man-pages-3.73 man-pages-3.72 man-pages-3.71 man-pages-3.70 man-pages-3.69 man-pages-3.68 man-pages-3.67 man-pages-3.66 man-pages-3.65 man-pages-3.64 man-pages-3.63 man-pages-3.62 man-pages-3.61 man-pages-3.60 man-pages-3.59 man-pages-3.58 man-pages-3.57 man-pages-3.56 man-pages-3.55 man-pages-3.54 man-pages-3.53 man-pages-3.52 man-pages-3.51 man-pages-3.50 man-pages-3.49 man-pages-3.48 man-pages-3.47 man-pages-3.46 man-pages-3.45 man-pages-3.44 man-pages-3.43 man-pages-3.42 man-pages-3.41 man-pages-3.40 man-pages-3.39 man-pages-3.38 man-pages-3.37 man-pages-3.36 man-pages-3.35 man-pages-3.34 man-pages-3.33 man-pages-3.32 man-pages-3.31 man-pages-3.30 man-pages-3.29 man-pages-3.28 man-pages-3.27 man-pages-3.26 man-pages-3.25 man-pages-3.24 man-pages-3.23 man-pages-3.22 man-pages-3.21 man-pages-3.20 man-pages-3.19 man-pages-3.18 man-pages-3.17 man-pages-3.16 man-pages-3.15 man-pages-3.14 man-pages-3.13 man-pages-3.12 man-pages-3.11 man-pages-3.10 man-pages-3.09 man-pages-3.08 man-pages-3.07 man-pages-3.06 man-pages-3.05 man-pages-3.04 man-pages-3.03 man-pages-3.02 man-pages-3.01 man-pages-3.00 man-pages-2.80 man-pages-2.79 man-pages-2.78 man-pages-2.77 man-pages-2.76 man-pages-2.75 man-pages-2.74 man-pages-2.73 man-pages-2.72 man-pages-2.71 man-pages-2.70 man-pages-2.69 man-pages-2.68 man-pages-2.67
Nothing to show
Commits on Dec 18, 2015
  1. man2: document the FIDEDUPERANGE ioctl

    Darrick J. Wong committed Dec 17, 2015
    Document the FIDEDUPERANGE ioctl, formerly known as BTRFS_IOC_EXTENT_SAME.
    
    Signed-off-by: Darrick J. Wong <darrick.wong@oracle.com>
  2. man2: document FICLONE and FICLONERANGE

    Darrick J. Wong committed Dec 17, 2015
    Document the FICLONE and FICLONERANGE ioctls, formerly known as the
    BTRFS_IOC_CLONE and BTRFS_IOC_CLONE_RANGE ioctls.
    
    Signed-off-by: Darrick J. Wong <darrick.wong@oracle.com>
Commits on Dec 17, 2015
  1. random_r.3: Clarify need to use initstate_r()

    mkerrisk committed Dec 17, 2015
    As noted by Archie Cobbs:
    
    I was trying to use srandom_() and initstate_r() and fell into
    the exact same trap this this fellow did:
    http://stackoverflow.com/questions/18569523/segfault-at-srandom-r,
    resulting in a segfault.
    
    The man page is really unclear here. It leads one to believe
    (falsely) that invoking setrandom_r() is sufficient to initialize
    a struct random_data, but this is not the case. In fact
    srandom_r() is not like srandom() at all in this respect.
    
    Reported-by: Archie Cobbs <archie.cobbs@gmail.com>
    Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
  2. random.4: Rework example scripts to assume 'poolsize' unit is bits, n…

    mkerrisk committed Dec 17, 2015
    …ot bytes
    
    Reported-by: Tom Gundersen <teg@jklm.no>
    Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
  3. getrandom.2: tfix

    mkerrisk committed Dec 17, 2015
    Reported-by: Colin Rice <colin@daedrum.net>
    Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
  4. getrlimit.2: The init of measurement for RLIMIT_RSS is bytes, not pages

    mkerrisk committed Dec 17, 2015
    Reported-by: Lennart Poettering <lennart@poettering.net>
    Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
  5. time.2: Rename 't' argument to 'tloc'

    mkerrisk committed Dec 17, 2015
    'tloc' is visually easier to spot, and also is used
    in POSIX and in man pages on other systems.
    
    Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
  6. time.2: Describe EOVERFLOW details

    mkerrisk committed Dec 17, 2015
    Heavily based on text proposed by Paul Eggert.
    
    Cowritten-by: Paul Eggert <eggert@cs.ucla.edu>
    Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
  7. futex.2: Fixes after comments from Darren Hart

    mkerrisk committed Dec 16, 2015
    Reported-by: Darren Hart <dvhart@infradead.org>
    Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
  8. futex.2: Clarify "total ordering" a little

    mkerrisk committed Dec 16, 2015
    Comments from Davidlohr:
    
        So there are two things here regarding ordering. One is the
        most obvious which is ordered due to the taking/dropping the
        hb spinlock. Secondly, its the cases which Peter brought up
        a while ago that involves atomic futex ops futex_atomic_*(),
        which do not have clearly defined semantics, and you get
        inconsistencies with certain archs (tile being the worst
        iirc).
    
        But anyway, the important thing users need to know about is
        that the atomic futex operation must be totally ordered wrt
        any other user tasks that are trying to access that address.
        This is not necessarily the case for kernel ops. Peter
        illustrates this nicely with lock stealing example; (see
        https://lkml.org/lkml/2015/8/26/596).
    
        Internally, I believe we decided that making it fully ordered
        (as opposed to making use of implicit barriers for
        ACQUIRE/RELEASE), so you'd end up having an MB ll/sc MB kind of
        setup.
    
    Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
    Reported-by: Davidlohr Bueso <dave@stgolabs.net>
Commits on Dec 16, 2015
  1. sendfile.2: Document more ERRORS

    lgeorget committed with mkerrisk Dec 11, 2015
    sendfile(2) can return more error codes than are
    documented in sendfile(2). This patch adds some details:
    
        - EINVAL can be returned if count is negative; from function
          rw_verify_area in fs/read_write.c, called from do_sendfile,
          called from sys_sendfile.
        - EOVERFLOW can be returned if count is too large; from
          rw_verify_area, called from do_sendfile, called from
          sys_sendfile, or directly from do_sendfile in one case
          (pos + count > max size of either in_fd or out_fd).
        - ESPIPE can be returned if offset is not a NULL pointer but
          the input file does not support FMODE_PREAD;
          from do_sendfile, called from sys_sendfile.
    
    Signed-off-by: Laurent Georget <laurent.georget@supelec.fr>
    Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
  2. time.2: Explain why the glibc time() wrapper never sets 'errno'

    zackw committed with mkerrisk Dec 16, 2015
    Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
  3. time.2: Where time() is provided by vDSO, an invalid address may give…

    mkerrisk committed Dec 16, 2015
    … SIGSEGV
    
    Reported-by: H.J. Lu <hjl.tools@gmail.com>
    Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
  4. tzset.3: Clarify "daylight" and remove erroneous note

    codonell committed with mkerrisk Dec 10, 2015
    When tzset is run the value of daylight is computed
    by looking at all available rules for the application
    of daylight savings. This includes reading the tzdata
    files to determine if there is a transition or not for
    the current timezone. It also includes parsing TZ env
    to see if it specifies custom rules which are used in
    precedence to any tzdata rules. Therefore daylight is
    going to be set if there is a daylight saving rule past,
    present, or future that indicates a transition. We clarify
    that in the man page.
    
    Lastly, the note about tz_dsttime is not correct and is
    removed. The earlier paragraph about daylight makes it
    clear that it doesn't mean "daylight saving rule applies
    now", and the interaction with tz_dsttime is not correct
    for glibc on Linux (as outlined in my gettimeofday.3 patch
    sent here: http://marc.info/?l=linux-man&m=144977768703615&w=2).
    
    Signed-off-by: Carlos O'Donell <carlos@redhat.com>
    Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
  5. gettimeofday.2: Minor tweaks

    mkerrisk committed Dec 16, 2015
    Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
  6. gettimeofday.2: Expand on the historic historical meaning of tz_dsttime

    codonell committed with mkerrisk Dec 10, 2015
    Given that the NOTES in question are willing to discuss
    history, I have clarified the use of tz_dsttime for non-Linux
    and Linux to allow the reader to contrast that with the older
    system usage.
    
    On a non-Linux glibc the meaning of tz_dsttime is exactly
    that of daylight for the current zone. It has been this way
    since the beginning of glibc:
    
    ^28f540f (Roland McGrath 1995-02-18 01:27:10 +0000 52)
           tz->tz_dsttime = __daylight;
    
    On a Linux glibc the field has never been used.
    
    Clarify the meaning of tz_dsttime for gettimeofday,
    and for settimeofday distinctly for non-Linux and Linux
    glibc cases (for historical completeness).
    
    Signed-off-by: Carlos O'Donell <carlos@redhat.com>
    Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
  7. ld.so.8: tfix

    mkerrisk committed Dec 16, 2015
    Reported-by: Phil Blundell <pb@pbcl.net>
    Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
  8. ld.so.8: Clarify setting of LD_TRACE_PRELINKING

    mkerrisk committed Dec 16, 2015
    Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
  9. ld.so.8: Clarify some details for LD_SHOW_AUXV

    mkerrisk committed Dec 16, 2015
    Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
  10. ld.so.8: Clarify setting of LD_DYNAMIC_WEAK

    mkerrisk committed Dec 16, 2015
    Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
  11. ld.so.8: Clarify setting of LD_BIND_NOT

    mkerrisk committed Dec 16, 2015
    Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
  12. ld.so.8: Tweaks to H.J. Lu's patch

    mkerrisk committed Dec 16, 2015
    Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
  13. ld.so.8: Document LD_PREFER_MAP_32BIT_EXEC

    hjl-tools committed with mkerrisk Dec 16, 2015
    Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
  14. sigreturn.2: SEE ALSO: add vdso(7)

    mkerrisk committed Dec 16, 2015
    Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
  15. gettimeofday.2: SEE ALSO: add vdso(7)

    mkerrisk committed Dec 16, 2015
    Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
  16. clock_getres.2: SEE ALSO: add vdso(7)

    mkerrisk committed Dec 16, 2015
    Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
  17. time.2: SEE ALSO: add vdso(7)

    mkerrisk committed Dec 16, 2015
    Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
  18. getcpu.2: SEE ALSO: add vdso(7)

    mkerrisk committed Dec 16, 2015
    Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
  19. iconv.3: NOTES: describe correct usage for flushing partially buffere…

    Andries E. Brouwer committed with mkerrisk Dec 16, 2015
    …d input
    
    The following came up yesterday on the wget list.
    The iconv.3 man page says
    
    "... 2. The input byte sequence has been entirely converted,
     i.e. *inbytesleft has gone down to 0."
    
    and
    
    "A  different  case is when inbuf is NULL or *inbuf is NULL,
     but outbuf is not NULL and *outbuf is not NULL. In this case,
     the iconv function attempts to set cd's conversion state to the
     initial state and store  a  corresponding shift sequence at
     *outbuf."
    
    The POSIX page says
    
    "For state-dependent encodings, the conversion descriptor cd is
     placed into its initial shift state by a call for which inbuf
     is a null pointer, or for which inbuf points to a null pointer.
     When iconv() is called in this way, and if outbuf is not a null
     pointer or a pointer to a null pointer, and outbytesleft points
     to a positive value, iconv() shall place, into the output buffer,
     the byte sequence to change the output buffer to its initial
    shift state."
    
    These texts are slightly misleading, in the sense that, in the
    present implementation, iconv() may implement conversion
    from an encoding that is not state-dependent in a way that
    uses an artificial shift state to store lookahead bytes.
    That means that after conversion, when *inbytesleft has gone
    down to 0, it may be that contrary to what iconv.3 suggests not
    all output has been stored, and a final flushing call is needed.
    
    Maybe this violates POSIX.
    
    A minimal warning is added by this patch.
    
    --- man-pages-4.03/man3/iconv.3 2015-12-05 10:45:25.000000000 +0100
    +++ ./iconv.3   2015-12-16 01:41:38.253049938 +0100
    @@ -161,6 +161,11 @@
     .SH CONFORMING TO
     POSIX.1-2001, POSIX.1-2008.
     .SH NOTES
    +In each series of calls to
    +.BR iconv (),
    +the last should be one with \fIinbuf\fP or \fI*inbuf\fP equal to NULL,
    +in order to flush out any partially converted input.
    +
     Although
     .I inbuf
     and
    
    Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
  20. membarrier.2: wfix

    compudj committed with mkerrisk Dec 15, 2015
    Signed-off-by: Mathieu Desnoyers <mathieu.desnoyers@efficios.com>
    CC: Michael Kerrisk <mtk.manpages@gmail.com>
    Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Commits on Dec 15, 2015
  1. vdso.7: Add note on strace(1) and vDSO

    mkerrisk committed Dec 15, 2015
    Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
  2. membarrier.2: Rework discussion of 'cmd'

    mkerrisk committed Dec 15, 2015
    Simplify and eliminate some redundancy.
    
    Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
  3. membarrier.2: Remove redundant mention of return value of MEMBARRIER_…

    mkerrisk committed Dec 15, 2015
    …CMD_SHARED
    
    This detail is already covered in RETURN VALUE.
    
    Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
  4. membarrier.2: Clarify details of return value

    mkerrisk committed Dec 15, 2015
    Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
  5. membarrier.2: Clarify return value for MEMBARRIER_CMD_QUERY

    mkerrisk committed Dec 15, 2015
    Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>