LDP
/
man-pages
mirror of https://github.com/mkerrisk/man-pages
0
1
Fork 0
Code Releases Activity
13,542 Commits 1 Branch 197 Tags 93 MiB
Commit Graph

13542 Commits

Author SHA1 Message Date
Zeng Linggang 6d4209dec5 wcsnrtombs.3: ATTRIBUTES: Note function that isn't thread-safe 
The marking matches glibc marking.

wcsnrtombs: MT-Unsafe race:wcsnrtombs/!ps

Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-04-11 08:46:27 +02:00
Zeng Linggang bec786289f scanf.3: ATTRIBUTES: Note functions that are thread-safe 
The markings match glibc markings.

scanf:   MT-Safe locale
fscanf:  MT-Safe locale
sscanf:  MT-Safe locale
vscanf:  MT-Safe locale
vsscanf: MT-Safe locale
vfscanf: MT-Safe locale

Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-04-11 08:46:27 +02:00
Zeng Linggang 9ec9e8274e scandir.3: ATTRIBUTES: Note functions that are thread-safe 
The markings match glibc markings.

scandir:     MT-Safe
scandirat:   MT-Safe

alphasort:   MT-Safe locale
versionsort: MT-Safe locale

Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-04-11 08:46:27 +02:00
Zeng Linggang 1567901b96 printf.3: ATTRIBUTES: Note functions that are thread-safe 
The markings match glibc markings.

printf:    MT-Safe locale
fprintf:   MT-Safe locale
sprintf:   MT-Safe locale
snprintf:  MT-Safe locale
vprintf:   MT-Safe locale
vfprintf:  MT-Safe locale
vsprintf:  MT-Safe locale
vsnprintf: MT-Safe locale

Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-04-11 08:46:27 +02:00
Zeng Linggang 80563762a2 perror.3: ATTRIBUTES: Note function that is thread-safe 
The marking matches glibc marking.

perror: MT-Safe race:stderr

Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-04-11 08:46:27 +02:00
Zeng Linggang 03c07cb1e5 mbsrtowcs.3: ATTRIBUTES: Note function that isn't thread-safe 
The marking matches glibc marking.

mbsrtowcs: MT-Unsafe race:mbsrtowcs/!ps

Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-04-11 08:46:27 +02:00
Zeng Linggang adad095fc6 mbsnrtowcs.3: ATTRIBUTES: Note function that isn't thread-safe 
The marking matches glibc marking.

mbsnrtowcs: MT-Unsafe race:mbsnrtowcs/!ps

Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-04-11 08:46:27 +02:00
Zeng Linggang a5047c38da getutent.3: ATTRIBUTES: Note functions that aren't thread-safe 
The markings match glibc markings.

getutent:  MT-Unsafe init race:utent race:utentbuf sig:ALRM timer

getutid:   MT-Unsafe init race:utent sig:ALRM timer
getutline: MT-Unsafe init race:utent sig:ALRM timer

pututline: MT-Unsafe race:utent sig:ALRM timer

setutent:  MT-Unsafe race:utent
endutent:  MT-Unsafe race:utent
utmpname:  MT-Unsafe race:utent

Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-04-11 08:46:27 +02:00
Zeng Linggang 08da409ade get_nprocs_conf.3: ATTRIBUTES: Note functions that are thread-safe 
The markings match glibc markings.

get_nprocs:      MT-Safe
get_nprocs_conf: MT-Safe

Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-04-11 08:46:27 +02:00
Zeng Linggang d476c6315a getnetent.3: ATTRIBUTES: Note functions that aren't thread-safe 
The markings match glibc markings.

getnetent:    MT-Unsafe race:netent race:netentbuf env locale

getnetbyname: MT-Unsafe race:netbyname env locale

getnetbyaddr: MT-Unsafe race:netbyaddr locale

setnetent:    MT-Unsafe race:netent env locale
endnetent:    MT-Unsafe race:netent env locale

Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-04-11 08:46:27 +02:00
Zeng Linggang c7bd50f134 gethostbyname.3: ATTRIBUTES: Note functions that aren't thread-safe 
The markings match glibc markings.

gethostbyname:    MT-Unsafe race:hostbyname env locale

gethostbyaddr:    MT-Unsafe race:hostbyaddr env locale

sethostent:       MT-Unsafe race:hostent env locale
endhostent:       MT-Unsafe race:hostent env locale
gethostent_r:     MT-Unsafe race:hostent env locale

herror:           MT‐Safe
hstrerror:        MT‐Safe

gethostent:       MT-Unsafe race:hostent race:hostentbuf env locale

gethostbyname2:   MT-Unsafe race:hostbyname2 env locale

gethostbyaddr_r:  MT-Safe env locale
gethostbyname_r:  MT-Safe env locale
gethostbyname2_r: MT-Safe env locale

Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-04-11 08:46:27 +02:00
Zeng Linggang c8b6813699 ctime.3: ATTRIBUTES: Note functions that aren't thread-safe 
The markings match glibc markings.

asctime:     MT-Unsafe race:asctime locale

asctime_r:   MT-Safe locale

ctime:       MT-Unsafe race:tmbuf race:asctime env locale

ctime_r:     MT-Safe env locale
gmtime_r:    MT-Safe env locale
localtime_r: MT-Safe env locale
mktime:      MT-Safe env locale

gmtime:      MT-Unsafe race:tmbuf env locale
localtime:   MT-Unsafe race:tmbuf env locale

Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-04-11 08:46:27 +02:00
Zeng Linggang 0f6cf80d74 asprintf.3: ATTRIBUTES: Note functions that are thread-safe 
The markings match glibc markings.

asprintf:  MT-Safe locale
vasprintf: MT-Safe locale

Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-04-11 08:46:27 +02:00
Ma Shimiao 8716ac0756 ctanh.3: ATTRIBUTES: Note functions that are thread-safe 
The markings match glibc markings.

Signed-off-by: Ma Shimiao <mashimiao.fnst@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-04-11 08:46:27 +02:00
Ma Shimiao 96fb9f0b27 ctan.3: ATTRIBUTES: Note functions that are thread-safe 
The markings match glibc markings.

Signed-off-by: Ma Shimiao <mashimiao.fnst@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-04-11 08:46:27 +02:00
Ma Shimiao 551dcfd58c csqrt.3: ATTRIBUTES: Note functions that are thread-safe 
The markings match glibc markings.

Signed-off-by: Ma Shimiao <mashimiao.fnst@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-04-11 08:46:27 +02:00
Ma Shimiao 31652f0b15 csinh.3: ATTRIBUTES: Note functions that are thread-safe 
The markings match glibc markings.

Signed-off-by: Ma Shimiao <mashimiao.fnst@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-04-11 08:46:27 +02:00
Ma Shimiao 212127d17f csin.3: ATTRIBUTES: Note functions that are thread-safe 
Signed-off-by: Ma Shimiao <mashimiao.fnst@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-04-11 08:46:27 +02:00
Ma Shimiao 71557c6da5 cexp.3: ATTRIBUTES: Note functions that are thread-safe 
The markings match glibc markings.

Signed-off-by: Ma Shimiao <mashimiao.fnst@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-04-11 08:46:27 +02:00
Ma Shimiao a597364f3e ccos.3: ATTRIBUTES: Note functions that are thread-safe 
The markings match glibc markings.

Signed-off-by: Ma Shimiao <mashimiao.fnst@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-04-11 08:46:27 +02:00
Michael Kerrisk 9497142004 stat.2: Add some details on various "stat" versions 
Three versions of "stat" appeared on 32-bit systems,
dealing with structures of different (increasing) sizes.
Explain some of the details, and also note that the
situation is simpler on modern 64-bit architectures.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-04-11 08:46:27 +02:00
Michael Kerrisk b981bf291e lseek64.3: Clarify details with respect to 32-bit and 64-bit systems 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-04-11 08:46:27 +02:00
Michael Kerrisk 2d5b086a03 lseek64.3: ffix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-04-11 08:46:27 +02:00
Michael Kerrisk a54afa1e7b llseek.2: llseek() exists on 32-bit platforms to support seeking to large offsets 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-04-11 08:46:27 +02:00
Michael Kerrisk 6cfd51e74c llseek.2: Advise reader to use lseek(2) instead 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-04-11 08:46:27 +02:00
Michael Kerrisk d3c49afa7e syscalls.2: Add some details about the "multiple versions of system calls" 
The multiple-system-call-version phenomenon is particular a
feature of older 32-bit platforms. Hint at that fact in the text.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-04-11 08:46:26 +02:00
Michael Kerrisk a39f2f4dc8 stat.2: Add a little more detail on history of three versions of *stat() 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-04-11 08:46:26 +02:00
Michael Kerrisk 470e30318d syscalls.2: Minor fix: use truncate64() rather than ftrucante64() 
In the discussion of the new *64() system calls added in
Linux 2.4, use truncate64() father than ftruncate64(),
since the text goes on to say "and their analogs that work with
file descriptors or symbolic links".

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-04-11 08:46:26 +02:00
Michael Kerrisk a7fa598074 newfstatat.2: New link to fstatat64.2 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-04-11 08:46:26 +02:00
Michael Kerrisk cad6df3299 stat.2: Add mention of newfstatat() 
The underlying system call for fstatat() is newfstatat()
on some architectures.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-04-11 08:46:26 +02:00
Michael Kerrisk 609203f3f7 pread.2: Add "C library/kernel ABI differences" subsection 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-04-11 08:46:26 +02:00
Michael Kerrisk 33a8247aab prlimit64.2: New link to getrlimit.2 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-04-11 08:46:26 +02:00
Michael Kerrisk 7d1a441bc6 syscalls.2: Remove prlimit() 
There really is only the prlimit64() system call.
See also commit 7b08c45b7d.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-04-11 08:46:26 +02:00
Michael Kerrisk 2863377036 getrlimit.2: Note that the underlying system call for prlimit() is prlimit64() 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-04-11 08:46:26 +02:00
Michael Kerrisk abb3258def getrlimit.2: Remove "_FILE_OFFSET_BITS == 64" from prlimit() FTM requirements 
"_FILE_OFFSET_BITS == 64" is not needed to get the prlimit()
declaration.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-04-11 08:46:26 +02:00
Michael Kerrisk a97b707895 posix_fadvise.2: Add "C library/kernel ABI differences" subsection 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-04-11 08:46:26 +02:00
Michael Kerrisk 7824ab2333 lseek64.3: wfix 
Reported-by: Jonny Grant <jg@jguk.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-04-11 08:46:26 +02:00
William Woodruff 83685d1e91 getcwd.3: ffix - make EINVAL and ENAMETOOLONG bold 
Neither EINVAL nor ENAMETOOLONG were bolded in the ERRORS section.

Signed-off-by: William Woodruff <william@tuffbizz.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-04-11 08:46:26 +02:00
Michael Kerrisk 0582770c52 seccomp.2: ffix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-04-11 08:46:26 +02:00
Michael Kerrisk 2b1f1a35b5 getcwd.3: Add kernel version/commit details to Jann Horn's patch 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-04-06 16:13:55 +02:00
Michael Kerrisk de0dd42776 getcwd.3: srcfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-04-06 16:13:55 +02:00
Jann Horn a2ac97c78b getcwd.3: Note behavior for unreachable current working directory 
For the code that does this, see fs/dcache.c, search for
"prepend_unreachable".

Test case to demonstrate:

$ cat getcwd.c

int main(void) {
  unshare(CLONE_NEWUSER | CLONE_NEWNS);
  chdir("/usr");
  chroot("bin");

  printf("current directory: \"%s\"\n", get_current_dir_name());

  char *real = realpath(".", NULL);
  printf("realpath of .: \"%s\"\n", real ? real : "{none}");
  real = realpath("../home/jann/.ssh", NULL);
  printf("realpath of path: \"%s\"\n", real ? real : "{none}");

  return 0;
}
$ cat getcwd_test.c

int main(void) {
  unshare(CLONE_NEWUSER | CLONE_NEWNS);
  chdir("/usr");
  chroot("bin");
  printf("current directory: \"%s\"\n", get_current_dir_name());
  return 0;
}
$ gcc -o getcwd_test getcwd_test.c -Wall
$ ./getcwd_test
current directory: "(unreachable)/usr"

realpath.3 doesn't currently seem to handle this
case in a sane way, so I'm not going to document
its behavior yet. I'll report that as a bug instead.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-04-06 16:13:55 +02:00
Michael Kerrisk a405066e3d proc.5: Update description /proc/sys/unix 'Type' field 
The existing text was very crufty. UNIX domain sockets
support more than SOCK_STREAM for a _very_ long time now.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-04-06 16:13:54 +02:00
Michael Kerrisk 8f8a46fbcb proc.5: Note that abstract sockets are included in /proc/net/unix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-04-06 16:13:54 +02:00
Michael Kerrisk 756f55f601 proc.5: Reformat /proc/net/unix information as a list 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-04-06 16:13:54 +02:00
Michael Kerrisk dbe6f88bf8 proc.5: Add some detail to /proc/PID/timers 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-04-06 16:13:54 +02:00
Michael Kerrisk c5aee02706 mq_notify.3: Add "C library/kernel ABI differences" subsection 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-04-06 16:13:54 +02:00
Michael Kerrisk 4c33c15ad3 timer_create.2: Add some details to C library/kernel ABI differences 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-04-06 16:13:54 +02:00
Michael Kerrisk 318f2dce07 timer_create.2: ffix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-04-06 16:13:54 +02:00
Michael Kerrisk c99652b724 nptl.7: Add reference to timer_create(2) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-04-06 16:13:54 +02:00