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

229 Commits

Author SHA1 Message Date
James Hunt 674f11ecbc ptrace.2: Explain behaviour should ptrace tracer call execve(2) 
This behaviour was verified by reading the kernel source and
confirming the behaviour using a test program.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-02-21 08:32:11 +01:00
Michael Kerrisk 8392a3b33f _exit.2, dup.2, execve.2, execveat.2, fallocate.2, fcntl.2, get_robust_list.2, getrlimit.2, mbind.2, memfd_create.2, mmap.2, open.2, ptrace.2, readv.2, select.2, sigaction.2, syscall.2, syscalls.2, truncate.2, utimensat.2, write.2, errno.3, exec.3, fclose.3, fexecve.3, fmemopen.3, fopencookie.3, getgrent_r.3, getline.3, getmntent.3, getpw.3, getpwent_r.3, getspnam.3, malloc_info.3, posix_fallocate.3, putgrent.3, shm_open.3, locale.5, proc.5: tstamp 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-01-22 23:29:25 +01:00
Michael Kerrisk 81c5080b1b ptrace.2: srcfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-01-18 12:14:48 +01:00
Kees Cook 3b4a59c4b5 ptrace.2, sigaction.2, seccomp.2: Ptrace and siginfo details 
While writing some additional seccomp tests, I realized
PTRACE_EVENT_SECCOMP wasn't documented yet. Fixed this, and added
additional notes related to ptrace events SIGTRAP details.

Signed-off-by: Kees Cook <keescook@chromium.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2015-01-18 12:04:32 +01:00
Michael Kerrisk e890609356 capget.2, ptrace.2, vhangup.2, wait.2, ttyslot.3, console.4, proc.5, utmp.5, boot.7: tfix: page xrefs for init 2014-10-03 08:47:03 +02:00
Michael Kerrisk bea08fec7e adjtimex.2, bind.2, cacheflush.2, clone.2, fallocate.2, fanotify_init.2, fanotify_mark.2, flock.2, futex.2, getdents.2, getpriority.2, getrlimit.2, gettid.2, gettimeofday.2, ioprio_set.2, kexec_load.2, migrate_pages.2, modify_ldt.2, mount.2, move_pages.2, mprotect.2, msgop.2, nfsservctl.2, perf_event_open.2, pread.2, ptrace.2, recvmmsg.2, rename.2, restart_syscall.2, sched_setattr.2, send.2, shmop.2, shutdown.2, sigaction.2, signalfd.2, syscalls.2, timer_create.2, timerfd_create.2, tkill.2, vmsplice.2, wait.2, aio_init.3, confstr.3, exit.3, fmemopen.3, fopen.3, getaddrinfo.3, getauxval.3, getspnam.3, isalpha.3, isatty.3, mallinfo.3, malloc.3, mallopt.3, psignal.3, pthread_attr_setinheritsched.3, qecvt.3, queue.3, rtnetlink.3, strerror.3, strftime.3, toupper.3, towlower.3, towupper.3, initrd.4, locale.5, proc.5, bootparam.7, capabilities.7, ddp.7, fanotify.7, icmp.7, inotify.7, ip.7, ipv6.7, netdevice.7, netlink.7, path_resolution.7, rtld-audit.7, rtnetlink.7, sched.7, signal.7, socket.7, svipc.7, tcp.7, unix.7, ld.so.8: srcfix: Update FIXMEs 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-08-21 16:47:44 -05:00
Michael Kerrisk 8980a50087 access.2, bdflush.2, bind.2, brk.2, chmod.2, chown.2, clone.2, epoll_wait.2, execve.2, fsync.2, getgroups.2, gethostname.2, getpagesize.2, getpriority.2, getrlimit.2, ioperm.2, kexec_load.2, link.2, mkdir.2, mmap.2, msgop.2, perf_event_open.2, process_vm_readv.2, ptrace.2, readlink.2, readv.2, recv.2, rename.2, sched_setaffinity.2, select.2, send.2, seteuid.2, signal.2, sigwaitinfo.2, stat.2, symlink.2, sync.2, sync_file_range.2, sysinfo.2, timer_create.2, uname.2, unlink.2, utime.2, wait.2, abs.3, atoi.3, catopen.3, cerf.3, cexp2.3, clearenv.3, clog2.3, ctime.3, des_crypt.3, ecvt.3, fgetgrent.3, flockfile.3, fseeko.3, ftime.3, ftok.3, ftw.3, getauxval.3, getcwd.3, getdtablesize.3, getgrent.3, getgrent_r.3, getgrnam.3, getgrouplist.3, getline.3, getpass.3, getutent.3, glob.3, insque.3, lseek64.3, memmem.3, mkstemp.3, mktemp.3, on_exit.3, openpty.3, putenv.3, qecvt.3, realpath.3, remove.3, setbuf.3, sigpause.3, strftime.3, strptime.3, strstr.3, strtod.3, tzset.3, updwtmp.3, xcrypt.3, core.5, utmp.5, capabilities.7, charsets.7, environ.7, ipv6.7, man-pages.7, packet.7, vdso.7: tstamp 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-08-19 11:55:41 -05:00
Michael Kerrisk 53a99749df ptrace.2: NOTES: add "C library/kernel ABI differences" subheading 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-08-18 17:01:47 -05:00
Michael Kerrisk 177660fae0 ptrace.2: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-05-19 10:10:03 +02:00
Michael Kerrisk 07318a59d6 ptrace.2: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-05-15 14:20:26 +02:00
Michael Kerrisk 15d33661c7 ptrace.2: grfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-03-26 07:33:17 +01:00
Michael Kerrisk 92692952b1 Removed trailing white space at end of lines 2014-02-26 18:29:50 +01:00
Michael Kerrisk 051ec121f0 ptrace.2: Make it clearer that glibc and syscall APIs differ for PTRACE_PEEK* 
Thanks to Denys Vlasenko's additions in 78686915ae
this page does note that the glibc API for PTRACE_PEEK*
differs from the raw syscall interface. But, as the report
at https://bugzilla.kernel.org/show_bug.cgi?id=70801 shows,
this information could be more obvious. This patch makes its so.

Reported-by: Andrew Hunter <ahh@google.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-02-19 11:41:33 +01:00
Michael Kerrisk 36f5dd10ba ptrace.2: srcfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-02-19 10:34:42 +01:00
Michael Kerrisk a71b27f8bb ptrace.2: ffix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-02-19 09:24:51 +01:00
Michael Kerrisk a797afac4e fcntl.2, msgget.2, ptrace.2, request_key.2, shmget.2, sigaction.2, syscalls.2, dbopen.3, euidaccess.3, getgrnam.3, getpwnam.3, strfmon.3, strtol.3, strtoul.3, cciss.4, hpsa.4, mouse.4, termcap.5, charsets.7, iso_8859-16.7, iso_8859-2.7, koi8-r.7, unicode.7, utf-8.7: Use Oxford comma 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-02-05 16:09:11 +01:00
David Prévot 8abd92fca7 ptrace.2: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-02-04 10:02:50 +01:00
Michael Kerrisk 222475b004 ptrace.2: Add details to descriptions of PTRACE_GETSIGMASK and PTRACE_SETSIGMASK 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-23 15:36:04 +01:00
Michael Kerrisk 83894d15e2 ptrace.2: Reworking of Andrey's patches 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-20 13:20:56 +01:00
Andrey Vagin 9a36b8fca0 ptrace.2: Add description for PTRACE_GETSIGMASK and PTRACE_SETSIGMASK 
These two commands allow to examine and change mask of blocked signals.

Signed-off-by: Andrey Vagin <avagin@openvz.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-20 10:43:11 +01:00
Andrey Vagin 7a535f54fb ptrace.2: Add description for PTRACE_PEEKSIGINFO 
Retrieve signals without removing them from a queue.

Signed-off-by: Andrey Vagin <avagin@openvz.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-20 10:42:13 +01:00
Mike Frysinger a9deb5e056 ptrace.2: tfix userspace->user space 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-02 11:49:16 +13:00
Simon Paillard 5c977011c1 ptrace.2, setns.2, glob.7, ld.so.8: ffix: hyphen-used-as-minus-sign 
See http://lintian.debian.org/tags/hyphen-used-as-minus-sign.html

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2013-09-05 13:09:41 +02:00
David Prévot 7290621523 ptrace.2: ffix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2013-09-04 08:18:07 +02:00
David Prévot c576d0b3f2 ptrace.2: pfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2013-09-04 08:17:56 +02:00
Andrey Vagin ff01b23214 ptrace.2: Place GETSIGINFO and SETSIGINFO near each other 
Signed-off-by: Andrey Vagin <avagin@openvz.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2013-07-18 03:13:13 +02:00
Denys Vlasenko 29f9b8fb31 ptrace.2: If SEIZE was used, initial auto-attach stop is EVENT_STOP 
For every PTRACE_O_TRACEfoo option, mention that old-style SIGSTOP
is replaced by PTRACE_EVENT_STOP if PTRACE_SEIZE attach was used.

Mention the same thing again in the description of
PTRACE_EVENT_STOP.

Acked-by: Oleg Nesterov <oleg@redhat.com>
Acked-by: Dmitry V. Levin <ldv@altlinux.org>
Signed-off-by: Denys Vlasenko <dvlasenk@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2013-07-18 02:11:34 +02:00
Michael Kerrisk ad84c54302 ptrace.2: Minor fixes to patches from Denys Vlasenko 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2013-07-18 02:11:34 +02:00
Denys Vlasenko 8da59274b4 ptrace.2: Clarify PTRACE_INTERRUPT, PTRACE_LISTEN, and group-stop behavior 
Signed-off-by: Denys Vlasenko <dvlasenk@redhat.com>
Acked-by: Oleg Nesterov <oleg@redhat.com>
Acked-by: Dmitry V. Levin <ldv@altlinux.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2013-07-18 02:11:34 +02:00
Denys Vlasenko 78686915ae ptrace.2: Mention that PTRACE_PEEK* libc API and kernel API are different 
Acked-by: Oleg Nesterov <oleg@redhat.com>
Acked-by: Dmitry V. Levin <ldv@altlinux.org>
Signed-off-by: Denys Vlasenko <dvlasenk@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2013-07-18 02:11:34 +02:00
Michael Kerrisk 33a0ccb293 intro.1, _syscall.2, access.2, arch_prctl.2, cacheflush.2, chown.2, clock_getres.2, clone.2, create_module.2, fcntl.2, flock.2, get_kernel_syms.2, get_robust_list.2, get_thread_area.2, getcpu.2, getpriority.2, getrlimit.2, getrusage.2, ioprio_set.2, kexec_load.2, madvise.2, mbind.2, migrate_pages.2, mknod.2, mmap.2, mount.2, move_pages.2, mprotect.2, open.2, pause.2, pciconfig_read.2, perf_event_open.2, prctl.2, ptrace.2, query_module.2, read.2, reboot.2, recv.2, s390_runtime_instr.2, sched_setscheduler.2, select_tut.2, send.2, set_mempolicy.2, setfsgid.2, setfsuid.2, sigaction.2, spu_create.2, spu_run.2, stime.2, swapon.2, syslog.2, timer_create.2, timer_getoverrun.2, times.2, tkill.2, umount.2, unimplemented.2, ustat.2, vm86.2, wait.2, abs.3, aio_read.3, aio_write.3, bsd_signal.3, catgets.3, clearenv.3, cmsg.3, dbopen.3, dirfd.3, dlopen.3, exec.3, fenv.3, ferror.3, fmemopen.3, fnmatch.3, fopen.3, futimes.3, getaddrinfo.3, getifaddrs.3, getipnodebyname.3, hsearch.3, if_nameindex.3, inet_pton.3, mblen.3, mbrlen.3, mbsrtowcs.3, mbtowc.3, mcheck.3, memfrob.3, mq_notify.3, netlink.3, posix_memalign.3, printf.3, pthread_attr_setscope.3, pthread_cleanup_push.3, pthread_kill_other_threads_np.3, pthread_self.3, pthread_setcancelstate.3, pthread_setconcurrency.3, raise.3, resolver.3, rpc.3, rtime.3, rtnetlink.3, scanf.3, setbuf.3, setnetgrent.3, shm_open.3, sigpause.3, sigset.3, sigwait.3, sockatmark.3, strcasecmp.3, strcmp.3, strdup.3, strftime.3, strptime.3, strsignal.3, strverscmp.3, sysv_signal.3, termios.3, wcrtomb.3, wcsnlen.3, wcsnrtombs.3, wcsrtombs.3, wctomb.3, wprintf.3, console_codes.4, cpuid.4, msr.4, rtc.4, sk98lin.4, st.4, tty.4, charmap.5, core.5, elf.5, hosts.equiv.5, proc.5, resolv.conf.5, services.5, slabinfo.5, arp.7, bootparam.7, capabilities.7, charsets.7, cpuset.7, ddp.7, epoll.7, feature_test_macros.7, futex.7, hier.7, icmp.7, inotify.7, ip.7, ipv6.7, man-pages.7, mdoc.7, mdoc.samples.7, netdevice.7, netlink.7, numa.7, packet.7, path_resolution.7, posixoptions.7, pthreads.7, raw.7, rtld-audit.7, rtnetlink.7, sem_overview.7, sigevent.7, socket.7, spufs.7, tcp.7, udp.7, unicode.7, uri.7, utf-8.7, intro.8, ldconfig.8, sync.8: Global fix: fix placement of word "only" 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2013-04-01 14:53:46 +02:00
Michael Kerrisk e3948c69dd getrusage.2, ptrace.2, stpcpy.3, stpncpy.3: srcfix: start new sentence on new source line 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2013-03-25 12:12:27 +01:00
Michael Kerrisk 1dd72f9c9c getent.1, _syscall.2, acct.2, adjtimex.2, bdflush.2, brk.2, cacheflush.2, getsid.2, getxattr.2, inotify_add_watch.2, inotify_init.2, inotify_rm_watch.2, ioperm.2, ipc.2, listxattr.2, mlock.2, modify_ldt.2, mremap.2, nanosleep.2, outb.2, perf_event_open.2, ptrace.2, removexattr.2, s390_runtime_instr.2, sched_get_priority_max.2, sched_rr_get_interval.2, sched_setaffinity.2, sched_setparam.2, sched_setscheduler.2, sched_yield.2, setsid.2, setxattr.2, socketcall.2, unimplemented.2, aio_cancel.3, aio_error.3, aio_fsync.3, aio_read.3, aio_return.3, aio_suspend.3, aio_write.3, cfree.3, crypt.3, dlopen.3, encrypt.3, errno.3, fenv.3, ftime.3, ftw.3, getgrent_r.3, getpass.3, getpwent_r.3, getutent.3, hsearch.3, lio_listio.3, lockf.3, login.3, longjmp.3, perror.3, printf.3, scandirat.3, setjmp.3, strfmon.3, strtoimax.3, termios.3, ttyname.3, ualarm.3, updwtmp.3, wcstoimax.3, wordexp.3, console_ioctl.4, dsp56k.4, fd.4, hd.4, intro.4, lp.4, mem.4, null.4, ram.4, rtc.4, sk98lin.4, tty.4, ttyS.4, vcs.4, filesystems.5, group.5, host.conf.5, hosts.5, intro.5, issue.5, motd.5, networks.5, nologin.5, nsswitch.conf.5, passwd.5, proc.5, protocols.5, securetty.5, shells.5, termcap.5, ttytype.5, utmp.5, intro.6, armscii-8.7, ascii.7, bootparam.7, cp1251.7, environ.7, glob.7, intro.7, iso_8859-1.7, iso_8859-10.7, iso_8859-11.7, iso_8859-13.7, iso_8859-14.7, iso_8859-15.7, iso_8859-16.7, iso_8859-2.7, iso_8859-3.7, iso_8859-4.7, iso_8859-5.7, iso_8859-6.7, iso_8859-7.7, iso_8859-8.7, iso_8859-9.7, koi8-r.7, koi8-u.7, posixoptions.7, standards.7, unicode.7, utf-8.7, intro.8: s/GPLv2+_doc_full/GPLv2+_DOC_FULL/ 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2013-03-10 10:57:11 +01:00
Michael Kerrisk 6a8d87459d getent.1, _syscall.2, acct.2, adjtimex.2, bdflush.2, brk.2, cacheflush.2, getsid.2, getxattr.2, inotify_add_watch.2, inotify_init.2, inotify_rm_watch.2, ioperm.2, ipc.2, listxattr.2, mlock.2, modify_ldt.2, mremap.2, nanosleep.2, outb.2, perf_event_open.2, ptrace.2, removexattr.2, s390_runtime_instr.2, sched_get_priority_max.2, sched_rr_get_interval.2, sched_setaffinity.2, sched_setparam.2, sched_setscheduler.2, sched_yield.2, setsid.2, setxattr.2, socketcall.2, unimplemented.2, aio_cancel.3, aio_error.3, aio_fsync.3, aio_read.3, aio_return.3, aio_suspend.3, aio_write.3, cfree.3, crypt.3, dlopen.3, encrypt.3, errno.3, fenv.3, ftime.3, ftw.3, getgrent_r.3, getpass.3, getpwent_r.3, getutent.3, hsearch.3, lio_listio.3, lockf.3, login.3, longjmp.3, perror.3, printf.3, scandirat.3, setjmp.3, strfmon.3, strtoimax.3, termios.3, ttyname.3, ualarm.3, updwtmp.3, wcstoimax.3, wordexp.3, console_ioctl.4, dsp56k.4, fd.4, hd.4, intro.4, lp.4, mem.4, null.4, ram.4, rtc.4, sk98lin.4, tty.4, ttyS.4, vcs.4, filesystems.5, group.5, host.conf.5, hosts.5, intro.5, issue.5, motd.5, networks.5, nologin.5, nsswitch.conf.5, passwd.5, proc.5, protocols.5, securetty.5, shells.5, termcap.5, ttytype.5, utmp.5, intro.6, armscii-8.7, ascii.7, bootparam.7, cp1251.7, environ.7, glob.7, intro.7, iso_8859-1.7, iso_8859-10.7, iso_8859-11.7, iso_8859-13.7, iso_8859-14.7, iso_8859-15.7, iso_8859-16.7, iso_8859-2.7, iso_8859-3.7, iso_8859-4.7, iso_8859-5.7, iso_8859-6.7, iso_8859-7.7, iso_8859-8.7, iso_8859-9.7, koi8-r.7, koi8-u.7, posixoptions.7, standards.7, unicode.7, utf-8.7, intro.8: Global fix: Add LICENSE_START(GPLv2+_doc_full) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2013-03-10 10:57:09 +01:00
Michael Kerrisk c715f74112 getent.1, _syscall.2, acct.2, adjtimex.2, bdflush.2, brk.2, cacheflush.2, getsid.2, getxattr.2, inotify_add_watch.2, inotify_init.2, inotify_rm_watch.2, ioperm.2, ipc.2, listxattr.2, mlock.2, modify_ldt.2, mremap.2, nanosleep.2, outb.2, ptrace.2, removexattr.2, sched_get_priority_max.2, sched_rr_get_interval.2, sched_setaffinity.2, sched_setparam.2, sched_setscheduler.2, sched_yield.2, setsid.2, setxattr.2, socketcall.2, unimplemented.2, aio_cancel.3, aio_error.3, aio_fsync.3, aio_read.3, aio_return.3, aio_suspend.3, aio_write.3, cfree.3, crypt.3, dlopen.3, errno.3, fenv.3, ftime.3, ftw.3, getgrent_r.3, getpass.3, getpwent_r.3, getutent.3, hsearch.3, lio_listio.3, login.3, longjmp.3, perror.3, printf.3, scandirat.3, setjmp.3, strfmon.3, strtoimax.3, termios.3, ttyname.3, ualarm.3, wcstoimax.3, wordexp.3, console_ioctl.4, dsp56k.4, fd.4, hd.4, intro.4, lp.4, mem.4, null.4, ram.4, rtc.4, sk98lin.4, tty.4, ttyS.4, vcs.4, charmap.5, filesystems.5, ftpusers.5, gai.conf.5, group.5, host.conf.5, hosts.5, intro.5, issue.5, locale.5, motd.5, networks.5, nologin.5, nscd.conf.5, nss.5, nsswitch.conf.5, passwd.5, proc.5, protocols.5, securetty.5, shells.5, termcap.5, ttytype.5, utmp.5, intro.6, armscii-8.7, ascii.7, bootparam.7, cp1251.7, cpuset.7, environ.7, glob.7, intro.7, iso_8859-1.7, iso_8859-10.7, iso_8859-11.7, iso_8859-13.7, iso_8859-14.7, iso_8859-15.7, iso_8859-16.7, iso_8859-2.7, iso_8859-3.7, iso_8859-4.7, iso_8859-5.7, iso_8859-6.7, iso_8859-7.7, iso_8859-8.7, iso_8859-9.7, koi8-r.7, koi8-u.7, posixoptions.7, standards.7, unicode.7, utf-8.7, intro.8, ldconfig.8, nscd.8: Global fix: Update info in source comments on where to get a copy of the GPL 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2013-03-10 10:57:09 +01:00
Michael Kerrisk dac8367047 _exit.2, access.2, acct.2, adjtimex.2, alarm.2, alloc_hugepages.2, arch_prctl.2, bdflush.2, bind.2, brk.2, chdir.2, chmod.2, chown.2, chroot.2, clock_getres.2, clone.2, close.2, connect.2, dup.2, execve.2, faccessat.2, fchmodat.2, fchownat.2, fcntl.2, flock.2, fork.2, fstatat.2, fsync.2, futimesat.2, getdomainname.2, getgid.2, getgroups.2, gethostname.2, getpid.2, getresuid.2, getrlimit.2, getrusage.2, gettid.2, gettimeofday.2, getuid.2, idle.2, ioperm.2, iopl.2, ipc.2, kexec_load.2, kill.2, link.2, linkat.2, lookup_dcookie.2, madvise.2, migrate_pages.2, mincore.2, mkdir.2, mkdirat.2, mknod.2, mknodat.2, mlock.2, mmap.2, mmap2.2, modify_ldt.2, mount.2, move_pages.2, mq_getsetattr.2, mremap.2, msync.2, nanosleep.2, nfsservctl.2, nice.2, open.2, openat.2, outb.2, pause.2, perf_event_open.2, pipe.2, poll.2, posix_fadvise.2, prctl.2, ptrace.2, read.2, readahead.2, readlinkat.2, rename.2, renameat.2, rmdir.2, sched_get_priority_max.2, sched_rr_get_interval.2, sched_setparam.2, sched_setscheduler.2, sched_yield.2, select.2, setresuid.2, setup.2, socketcall.2, splice.2, stat.2, stime.2, swapon.2, symlink.2, symlinkat.2, sync.2, sync_file_range.2, tee.2, time.2, times.2, tkill.2, umask.2, umount.2, unimplemented.2, unlink.2, unlinkat.2, uselib.2, utime.2, utimensat.2, vhangup.2, vm86.2, vmsplice.2, wait.2, wait4.2, write.2, ether_aton.3, euidaccess.3, fexecve.3, ftime.3, futimes.3, getdirentries.3, getdtablesize.3, gethostid.3, getlogin.3, getpt.3, grantpt.3, hsearch.3, inet.3, lsearch.3, mkfifo.3, mkfifoat.3, mq_close.3, mq_getattr.3, mq_notify.3, mq_open.3, mq_receive.3, mq_send.3, mq_unlink.3, posix_openpt.3, profil.3, ptsname.3, scandirat.3, sem_close.3, sem_destroy.3, sem_getvalue.3, sem_init.3, sem_open.3, sem_post.3, sem_unlink.3, sem_wait.3, shm_open.3, stpcpy.3, termios.3, toascii.3, tsearch.3, ulimit.3, undocumented.3, unlockpt.3, pts.4, charmap.5, locale.5, services.5, feature_test_macros.7, inotify.7, mq_overview.7, pipe.7, pty.7, sem_overview.7, shm_overview.7, unicode.7, utf-8.7: Global fix: remove "Hey Emacs" comment in page source 
Only certain pages have this; there is no consistency, so
remove it from all pages

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2013-03-10 10:57:08 +01:00
Michael Kerrisk 92f9c09bf4 ptrace.2: wfix 
Reported-by: David Prévot <taffit@debian.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2013-03-05 18:01:25 +01:00
David Prévot f42ce0a555 ptrace.2: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2013-03-05 18:01:25 +01:00
Michael Kerrisk f04ba477c4 ptrace.2: Minor fixes 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2013-02-25 08:32:18 +01:00
Denys Vlasenko ba8f446e0b ptrace.2: Document PTRACE_GETREGSET, PTRACE_SETREGSET, PTRACE_SEIZE, and friends 
Document PTRACE_GETREGSET, PTRACE_SETREGSET,
PTRACE_SEIZE, PTRACE_INTERRUPT, and PTRACE_LISTEN.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2013-02-25 08:32:18 +01:00
Michael Kerrisk 47297adb6e getent.1, intro.1, time.1, _exit.2, _syscall.2, accept.2, access.2, acct.2, adjtimex.2, alarm.2, alloc_hugepages.2, arch_prctl.2, bdflush.2, bind.2, brk.2, cacheflush.2, capget.2, chdir.2, chmod.2, chown.2, chroot.2, clock_getres.2, clock_nanosleep.2, clone.2, close.2, connect.2, create_module.2, delete_module.2, dup.2, epoll_create.2, epoll_ctl.2, epoll_wait.2, eventfd.2, execve.2, exit_group.2, faccessat.2, fchmodat.2, fchownat.2, fcntl.2, flock.2, fork.2, fstatat.2, fsync.2, futex.2, futimesat.2, get_kernel_syms.2, get_robust_list.2, get_thread_area.2, getcpu.2, getdents.2, getdomainname.2, getgid.2, getgroups.2, gethostname.2, getitimer.2, getpagesize.2, getpeername.2, getpid.2, getpriority.2, getresuid.2, getrlimit.2, getrusage.2, getsid.2, getsockname.2, getsockopt.2, gettid.2, gettimeofday.2, getuid.2, getunwind.2, getxattr.2, idle.2, init_module.2, inotify_add_watch.2, inotify_init.2, inotify_rm_watch.2, intro.2, io_cancel.2, io_destroy.2, io_getevents.2, io_setup.2, io_submit.2, ioctl.2, ioctl_list.2, ioperm.2, iopl.2, ioprio_set.2, ipc.2, kcmp.2, kill.2, killpg.2, link.2, linkat.2, listen.2, listxattr.2, llseek.2, lookup_dcookie.2, lseek.2, madvise.2, migrate_pages.2, mincore.2, mkdir.2, mkdirat.2, mknod.2, mknodat.2, mlock.2, mmap.2, mmap2.2, modify_ldt.2, mount.2, move_pages.2, mprotect.2, mq_getsetattr.2, mremap.2, msgctl.2, msgget.2, msgop.2, msync.2, nanosleep.2, nfsservctl.2, nice.2, open.2, openat.2, outb.2, pause.2, pciconfig_read.2, perf_event_open.2, perfmonctl.2, personality.2, pipe.2, pivot_root.2, poll.2, posix_fadvise.2, prctl.2, pread.2, process_vm_readv.2, ptrace.2, query_module.2, quotactl.2, read.2, readahead.2, readdir.2, readlink.2, readlinkat.2, readv.2, reboot.2, recv.2, remap_file_pages.2, removexattr.2, rename.2, renameat.2, rmdir.2, rt_sigqueueinfo.2, sched_get_priority_max.2, sched_rr_get_interval.2, sched_setaffinity.2, sched_setparam.2, sched_setscheduler.2, sched_yield.2, select.2, semctl.2, semget.2, semop.2, send.2, sendfile.2, set_thread_area.2, set_tid_address.2, seteuid.2, setfsgid.2, setfsuid.2, setgid.2, setpgid.2, setresuid.2, setreuid.2, setsid.2, setuid.2, setup.2, setxattr.2, shmctl.2, shmget.2, shmop.2, shutdown.2, sigaction.2, sigaltstack.2, signal.2, signalfd.2, sigpending.2, sigprocmask.2, sigreturn.2, sigsuspend.2, sigwaitinfo.2, socket.2, socketcall.2, socketpair.2, splice.2, stat.2, statfs.2, stime.2, swapon.2, symlink.2, symlinkat.2, sync.2, sync_file_range.2, sysctl.2, sysfs.2, sysinfo.2, syslog.2, tee.2, time.2, timerfd_create.2, times.2, tkill.2, truncate.2, umask.2, umount.2, uname.2, unimplemented.2, unlink.2, unlinkat.2, uselib.2, ustat.2, utime.2, utimensat.2, vfork.2, vhangup.2, vm86.2, vmsplice.2, wait.2, wait4.2, write.2, CPU_SET.3, INFINITY.3, MB_CUR_MAX.3, MB_LEN_MAX.3, __setfpucw.3, a64l.3, abort.3, abs.3, acos.3, acosh.3, addseverity.3, adjtime.3, aio_cancel.3, aio_error.3, aio_fsync.3, aio_read.3, aio_return.3, aio_suspend.3, aio_write.3, alloca.3, argz_add.3, asin.3, asinh.3, asprintf.3, assert.3, assert_perror.3, atan.3, atan2.3, atanh.3, atexit.3, atof.3, atoi.3, backtrace.3, basename.3, bcmp.3, bcopy.3, bindresvport.3, bsd_signal.3, bsearch.3, bstring.3, btowc.3, btree.3, byteorder.3, bzero.3, cabs.3, cacos.3, cacosh.3, canonicalize_file_name.3, carg.3, casin.3, casinh.3, catan.3, catanh.3, catgets.3, catopen.3, cbrt.3, ccos.3, ccosh.3, ceil.3, cerf.3, cexp.3, cexp2.3, cfree.3, cimag.3, clearenv.3, clock.3, clock_getcpuclockid.3, clog.3, clog10.3, clog2.3, closedir.3, cmsg.3, confstr.3, conj.3, copysign.3, cos.3, cosh.3, cpow.3, cproj.3, creal.3, crypt.3, csin.3, csinh.3, csqrt.3, ctan.3, ctanh.3, ctermid.3, ctime.3, daemon.3, dbopen.3, des_crypt.3, difftime.3, dirfd.3, div.3, dl_iterate_phdr.3, dlopen.3, dprintf.3, drand48.3, drand48_r.3, dysize.3, ecvt.3, ecvt_r.3, encrypt.3, end.3, endian.3, envz_add.3, erf.3, erfc.3, err.3, errno.3, error.3, ether_aton.3, euidaccess.3, exec.3, exit.3, exp.3, exp10.3, exp2.3, expm1.3, fabs.3, fclose.3, fcloseall.3, fdim.3, fenv.3, ferror.3, fexecve.3, fflush.3, ffs.3, fgetgrent.3, fgetpwent.3, fgetwc.3, fgetws.3, finite.3, flockfile.3, floor.3, fma.3, fmax.3, fmemopen.3, fmin.3, fmod.3, fmtmsg.3, fnmatch.3, fopen.3, fpathconf.3, fpclassify.3, fpurge.3, fputwc.3, fputws.3, fread.3, frexp.3, fseek.3, fseeko.3, ftime.3, ftok.3, fts.3, ftw.3, futimes.3, fwide.3, gamma.3, gcvt.3, getaddrinfo.3, getaddrinfo_a.3, getauxval.3, getcontext.3, getcwd.3, getdate.3, getdirentries.3, getdtablesize.3, getenv.3, getfsent.3, getgrent.3, getgrent_r.3, getgrnam.3, getgrouplist.3, gethostbyname.3, gethostid.3, getipnodebyname.3, getline.3, getloadavg.3, getlogin.3, getmntent.3, getnameinfo.3, getnetent.3, getnetent_r.3, getopt.3, getpass.3, getprotoent.3, getprotoent_r.3, getpt.3, getpw.3, getpwent.3, getpwent_r.3, getpwnam.3, getrpcent.3, getrpcent_r.3, getrpcport.3, gets.3, getservent.3, getservent_r.3, getspnam.3, getttyent.3, getumask.3, getusershell.3, getutent.3, getw.3, getwchar.3, glob.3, grantpt.3, gsignal.3, hash.3, hsearch.3, hypot.3, iconv.3, iconv_close.3, iconv_open.3, ilogb.3, index.3, inet.3, inet_ntop.3, inet_pton.3, infnan.3, initgroups.3, insque.3, intro.3, isalpha.3, isatty.3, isgreater.3, iswalnum.3, iswalpha.3, iswblank.3, iswcntrl.3, iswctype.3, iswdigit.3, iswgraph.3, iswlower.3, iswprint.3, iswpunct.3, iswspace.3, iswupper.3, iswxdigit.3, j0.3, key_setsecret.3, ldexp.3, lgamma.3, lio_listio.3, localeconv.3, lockf.3, log.3, log10.3, log1p.3, log2.3, logb.3, login.3, longjmp.3, lrint.3, lround.3, lsearch.3, lseek64.3, makecontext.3, makedev.3, malloc.3, malloc_hook.3, mblen.3, mbrlen.3, mbrtowc.3, mbsinit.3, mbsnrtowcs.3, mbsrtowcs.3, mbstowcs.3, mbtowc.3, memccpy.3, memchr.3, memcmp.3, memcpy.3, memfrob.3, memmem.3, memmove.3, mempcpy.3, memset.3, mkdtemp.3, mkfifo.3, mkfifoat.3, mkstemp.3, mktemp.3, modf.3, mpool.3, mq_close.3, mq_getattr.3, mq_notify.3, mq_open.3, mq_receive.3, mq_send.3, mq_unlink.3, mtrace.3, nan.3, netlink.3, nextafter.3, nl_langinfo.3, offsetof.3, on_exit.3, opendir.3, openpty.3, perror.3, popen.3, posix_fallocate.3, posix_memalign.3, posix_openpt.3, pow.3, pow10.3, printf.3, profil.3, program_invocation_name.3, psignal.3, pthread_kill_other_threads_np.3, ptsname.3, putenv.3, putgrent.3, putpwent.3, puts.3, putwchar.3, qecvt.3, qsort.3, queue.3, raise.3, rand.3, random.3, random_r.3, rcmd.3, re_comp.3, readdir.3, realpath.3, recno.3, regex.3, remainder.3, remove.3, remquo.3, resolver.3, rewinddir.3, rexec.3, rint.3, round.3, rpc.3, rpmatch.3, rtime.3, rtnetlink.3, scalb.3, scalbln.3, scandir.3, scandirat.3, scanf.3, seekdir.3, sem_close.3, sem_destroy.3, sem_getvalue.3, sem_init.3, sem_open.3, sem_post.3, sem_unlink.3, sem_wait.3, setaliasent.3, setbuf.3, setenv.3, setjmp.3, setlocale.3, setlogmask.3, setnetgrent.3, shm_open.3, siginterrupt.3, signbit.3, significand.3, sigpause.3, sigqueue.3, sigset.3, sigsetops.3, sigvec.3, sin.3, sincos.3, sinh.3, sleep.3, sockatmark.3, sqrt.3, statvfs.3, stdarg.3, stdin.3, stdio.3, stdio_ext.3, stpcpy.3, stpncpy.3, strcasecmp.3, strcat.3, strchr.3, strcmp.3, strcoll.3, strcpy.3, strdup.3, strerror.3, strfmon.3, strfry.3, strftime.3, string.3, strlen.3, strnlen.3, strpbrk.3, strptime.3, strsep.3, strsignal.3, strspn.3, strstr.3, strtod.3, strtoimax.3, strtok.3, strtol.3, strtoul.3, strverscmp.3, strxfrm.3, swab.3, sysconf.3, syslog.3, system.3, sysv_signal.3, tan.3, tanh.3, tcgetpgrp.3, tcgetsid.3, telldir.3, tempnam.3, termios.3, tgamma.3, timegm.3, timeradd.3, tmpfile.3, tmpnam.3, toascii.3, toupper.3, towctrans.3, towlower.3, towupper.3, trunc.3, tsearch.3, ttyname.3, ttyslot.3, tzset.3, ualarm.3, ulimit.3, ungetwc.3, unlocked_stdio.3, unlockpt.3, updwtmp.3, usleep.3, wcpcpy.3, wcpncpy.3, wcrtomb.3, wcscasecmp.3, wcscat.3, wcschr.3, wcscmp.3, wcscpy.3, wcscspn.3, wcsdup.3, wcslen.3, wcsncasecmp.3, wcsncat.3, wcsncmp.3, wcsncpy.3, wcsnlen.3, wcsnrtombs.3, wcspbrk.3, wcsrchr.3, wcsrtombs.3, wcsspn.3, wcsstr.3, wcstoimax.3, wcstok.3, wcstombs.3, wcswidth.3, wctob.3, wctomb.3, wctrans.3, wctype.3, wcwidth.3, wmemchr.3, wmemcmp.3, wmemcpy.3, wmemmove.3, wmemset.3, wordexp.3, wprintf.3, xcrypt.3, xdr.3, y0.3, cciss.4, console.4, console_codes.4, console_ioctl.4, dsp56k.4, fd.4, full.4, hd.4, hpsa.4, initrd.4, intro.4, lp.4, mem.4, mouse.4, null.4, pts.4, ram.4, random.4, rtc.4, sk98lin.4, st.4, tty.4, ttyS.4, tty_ioctl.4, vcs.4, wavelan.4, acct.5, charmap.5, dir_colors.5, filesystems.5, ftpusers.5, group.5, host.conf.5, hosts.5, hosts.equiv.5, intro.5, issue.5, locale.5, motd.5, networks.5, nologin.5, nscd.conf.5, passwd.5, proc.5, protocols.5, resolv.conf.5, rpc.5, securetty.5, services.5, shells.5, termcap.5, ttytype.5, utmp.5, armscii-8.7, arp.7, ascii.7, bootparam.7, capabilities.7, charsets.7, complex.7, cp1251.7, credentials.7, ddp.7, environ.7, epoll.7, fifo.7, futex.7, glob.7, hier.7, icmp.7, inotify.7, intro.7, ip.7, ipv6.7, iso_8859-1.7, iso_8859-10.7, iso_8859-11.7, iso_8859-13.7, iso_8859-14.7, iso_8859-15.7, iso_8859-16.7, iso_8859-2.7, iso_8859-3.7, iso_8859-4.7, iso_8859-5.7, iso_8859-6.7, iso_8859-7.7, iso_8859-8.7, iso_8859-9.7, koi8-r.7, koi8-u.7, locale.7, mailaddr.7, man.7, mq_overview.7, netdevice.7, netlink.7, numa.7, packet.7, path_resolution.7, pipe.7, posixoptions.7, pthreads.7, pty.7, raw.7, regex.7, rtld-audit.7, rtnetlink.7, sem_overview.7, shm_overview.7, sigevent.7, signal.7, socket.7, standards.7, suffixes.7, svipc.7, tcp.7, termio.7, time.7, udp.7, udplite.7, unicode.7, unix.7, uri.7, utf-8.7, x25.7, nscd.8, sync.8, tzselect.8, zdump.8, zic.8: Global fix: remove unneeded double quotes in .SH headings 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2013-02-24 19:01:36 +01:00
Denys Vlasenko 40d0af61c4 ptrace.2: srcfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2013-02-18 18:57:12 +01:00
David Prévot c2b54496e3 ptrace.2: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2013-02-04 05:29:50 +01:00
Michael Kerrisk 9f1b972601 Removed trailing white space at end of lines 2013-01-27 21:28:25 +01:00
Michael Kerrisk 3fc441b2b9 fallocate.2, kcmp.2, link.2, listxattr.2, mkdir.2, mknod.2, open.2, ptrace.2, query_module.2, rename.2, symlink.2, write.2, mkfifo.3, core.5: tstamp 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2013-01-27 21:27:57 +01:00
Michael Kerrisk b89e39efa9 ptrace.2: Document PTRACE_O_EXITKILL 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2013-01-25 21:45:09 +01:00
Michael Kerrisk cc7d99c843 ptrace.2: Place PTRACE_SETOPTIONS list in alphabetical order 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2013-01-25 21:45:09 +01:00
David Prévot d2ea1bd4bd ptrace.2: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2012-11-09 06:53:19 +01:00
Michael Kerrisk 34709982a5 ptrace.2: Clarify that some operations are not present on all architectures 
PTRACE_GETREGS, PTRACE_SETGREFS, PTRACE_GETFPREGS,
and PTRACE_GETSPREGS are not present on all architectures.
PTRACE_SYSEMU and PTRACE_SYSEMU_SINGLESTEP are present only
on x86.

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

Simon Paillard <spaillard@debian.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2012-10-25 14:04:23 +02:00
Michael Kerrisk 7fac88a949 eventfd.2, futex.2, mmap2.2, open.2, pciconfig_read.2, ptrace.2, reboot.2, request_key.2, sched_rr_get_interval.2, splice.2, stat.2, sync_file_range.2, syscalls.2, timer_create.2, vm86.2, pthread_attr_setscope.3, core.5, proc.5, aio.7, futex.7, netlink.7, time.7: Global fix: "userspace" ==> "user space" or "user-space" 
Existing pages variously use "userspace or "user space".
But, "userspace" is not quite an English word.
So change "userspace" to "user space" or, when used
attributively, "user-space".

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2012-10-24 14:53:33 +02:00
Michael Kerrisk 11c85ed875 Removed trailing white space at end of lines 2012-08-14 00:39:21 +02:00
David Prévot b0b1d9b517 ptrace.2: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2012-08-13 09:22:34 +02:00
Denys Vlasenko ca302d0ee3 ptrace.2: Explain WNOHANG behavior and EINTR bug 
I didn't like ithe "SIGKILL operates similarly, with exceptions"
phrase (if it's different, then it's not "similar", right?),
and now I got around to changing it. Now it says simply:
"SIGKILL does not generate signal-delivery-stop and therefore
the tracer can't suppress it."

Replaced "why WNOHANG is not reliable" example with a more
realistic one (the one which actually inspired to add this
information to man page in the first place): we got
ESRCH - process is gone! - but waitpid(WNOHANG) can still
confusingly return 0 "no processes to wait for".

Replaced "This means that unneeded trailing arguments may
be omitted" part with a much better recommendation
to never do that and to supply zero arguments instead.
(The part about "undocumentedness" of gcc behavior was bogus,
btw - deleted).

Expanded BUGS section with the explanation and an example
of visible strace behavior on the buggy syscalls which
exit with EINTR on ptrace attach. I hope this will lead
to people submitting better bug reports to lkml about
such syscalls.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2012-08-03 10:33:49 +02:00
Michael Kerrisk cb72917199 ptrace.2: srcfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2012-08-03 10:33:49 +02:00
Bjarni Ingi Gislason 0ce81ab564 ptrace.2: srcfix to avoid groff warning 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2012-05-07 15:30:19 +12:00
Michael Kerrisk 3e18f289e7 ptrace.2: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2012-05-07 15:30:18 +12:00
Michael Kerrisk 82232e78e9 gettimeofday.2, ptrace.2, sigaction.2, aio_init.3, mpool.3, scandir.3, inotify.7, netdevice.7: tstamp 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2012-04-26 09:12:59 +12:00
Michael Kerrisk 50fe8d5366 ptrace.2: Note SPARC deviation with respect to get/set regs 
SPARC reverses the use of 'addr' and 'data' for
PTRACE_GETREGS, PTRACE_GETFPREGS, PTRACE_SETREGS,
and PTRACE_SETFPREGS.

Reported-by: Mike Frysinger <vapier@gentoo.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2012-04-26 09:11:45 +12:00
Michael Kerrisk d39a9b9833 ptrace.2: Minor edits to Denys Vlasenko's patch 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2012-03-30 06:59:50 +13:00
Denys Vlasenko b16ecdae13 ptrace.2: Various fixes 
For some reason, the PTRACE_TRACEME paragraph talks about some
general aspects of ptraced process behavior. It repeats the
"tracee stops on every signal" information even though that was
already explained just a few paragraphs before. Then it describes
legacy SIGTRAP on execve().

This patch deletes the first part, and moves the second part up,
into the general ptrace description. It also adds
"If PTRACE_O_TRACEEXEC option is not in effect" to the description
of the legacy SIGTRAP on execve().

The patch also amends the part which says "For requests other
than PTRACE_KILL, the tracee must be stopped." - PTRACE_ATTACH
also doesn't require that.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2012-03-30 06:59:50 +13:00
David Prévot a5c725cfd3 ptrace.2: ffix and tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2012-03-24 13:05:14 +13:00
Michael Kerrisk 8f318249c6 ptrace.2: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2012-03-24 11:59:07 +13:00
Denys Vlasenko b16d33ef72 ptrace.2: Document PTRACE_GETEVENTMSG for PTRACE_EVENT_EXEC 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2012-03-24 11:59:07 +13:00
Michael Kerrisk a17e05c5e0 ptrace.2: Minor fixes 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2012-03-20 07:45:58 +13:00
Denys Vlasenko f098951d39 ptrace.2: Various fixes to recent updates of this page 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2012-03-20 07:45:53 +13:00
Michael Kerrisk f23cc1df32 ptrace.2: srcfix: Added FIXME 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2012-03-10 06:30:59 +13:00
Michael Kerrisk d6e37473a1 Removed trailing white space at end of lines 2012-03-06 08:54:38 +13:00
Michael Kerrisk b8d02d5633 ptrace.2: Further improvements after review by Denys Vlasenko 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2012-03-06 08:45:57 +13:00
Michael Kerrisk a42c0c5a19 ptrace.2: grfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2012-03-06 08:45:57 +13:00
Michael Kerrisk dc85ba7ce5 ptrace.2: Integrated changes after further review from Denys Vlasenko 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2012-03-06 08:45:57 +13:00
Michael Kerrisk 8898a252ad ptrace.2: Integrated changes after review from Denys Vlasenko 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2012-03-06 08:45:57 +13:00
Michael Kerrisk 181f997f23 ptrace.2: Global clean-up of page 
* Wording and formatting fixes to existing text and
  Denys Vlasenko's new text.
* Various technical amendments and improvements to
  Denys Vlasenko's new text.
* Added FIXME for various problems with the current text.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2012-03-06 08:45:57 +13:00
Michael Kerrisk 8b20acd1aa ptrace.2: srcfix: Wrap lines at sentence boundaries 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2012-03-06 08:45:57 +13:00
Denys Vlasenko 4d12a715f2 ptrace.2: add extended description of various ptrace quirks 
Changes include:

s/parent/tracer/g, s/child/tracee/g - ptrace interface now
is sufficiently cleaned up to not treat tracing process
as parent.

Deleted several outright false statements:
- pid 1 can be traced
- tracer is not shown as parent in ps output
- PTRACE_ATTACH is not "the same behavior as if tracee had done
  a PTRACE_TRACEME": PTRACE_ATTACH delivers a SIGSTOP.
- SIGSTOP _can_ be injected.
- Removed mentions of SunOS and Solaris as irrelevant.
- Added a few more known bugs.

Added a large block of text in DESCRIPTION which doesn't focus
on mechanical description of each flag and operation, but rather
tries to describe a bigger picture. The targeted audience is
a person which is reasonably knowledgeable in Unix but did not
spend years working with ptrace, and thus may be unaware of its
quirks. This text went through several iterations of review by
Oleg Nesterov and Tejun Heo.
This block of text intentionally uses as little markup as possible,
otherwise future modifications to it will be very hard to make.

Reviewed-by: Oleg Nesterov <oleg@redhat.com>
Reviewed-by: Tejun Heo <tj@kernel.org>
Signed-off-by: Denys Vlasenko <dvlasenk@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2012-03-06 08:45:57 +13:00
David Prévot 5243e7b3b8 ptrace.2: tfix 
Signed-off-by: David Prévot <taffit@debian.org>
 2011-09-19 17:32:54 +02:00
Yuri Kozlov 46fbc1041e ptrace.2: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2011-09-16 07:00:44 +02:00
Michael Kerrisk b56defd37a ptrace.2: srcfix: Added FIXME 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2011-09-11 17:02:27 +02:00
Michael Kerrisk 008f1ecc43 intro.1, time.1, accept.2, bind.2, connect.2, execve.2, flock.2, getdents.2, getpriority.2, getuid.2, intro.2, ioctl.2, mincore.2, mknod.2, personality.2, ptrace.2, read.2, recv.2, select_tut.2, send.2, sendfile.2, shmctl.2, sigaction.2, signal.2, stat.2, times.2, truncate.2, umask.2, wait.2, MB_CUR_MAX.3, MB_LEN_MAX.3, argz_add.3, btowc.3, clearenv.3, clock.3, cmsg.3, end.3, endian.3, errno.3, exit.3, fgetwc.3, fgetws.3, fopen.3, fputwc.3, fputws.3, fseek.3, fwide.3, getfsent.3, getgrnam.3, gethostid.3, getipnodebyname.3, getmntent.3, getpwnam.3, getwchar.3, grantpt.3, iconv.3, iconv_close.3, iconv_open.3, insque.3, intro.3, iswalnum.3, iswalpha.3, iswblank.3, iswcntrl.3, iswctype.3, iswdigit.3, iswgraph.3, iswlower.3, iswprint.3, iswpunct.3, iswspace.3, iswupper.3, iswxdigit.3, malloc.3, mblen.3, mbrlen.3, mbrtowc.3, mbsinit.3, mbsnrtowcs.3, mbsrtowcs.3, mbstowcs.3, mbtowc.3, mkstemp.3, mktemp.3, nl_langinfo.3, openpty.3, posix_openpt.3, printf.3, ptsname.3, putwchar.3, qecvt.3, rcmd.3, readdir.3, rexec.3, rpc.3, setnetgrent.3, shm_open.3, sigpause.3, stdin.3, stpcpy.3, strftime.3, strptime.3, syslog.3, towctrans.3, towlower.3, towupper.3, ttyslot.3, ungetwc.3, unlocked_stdio.3, wcpcpy.3, wcpncpy.3, wcrtomb.3, wcscasecmp.3, wcscat.3, wcschr.3, wcscmp.3, wcscpy.3, wcscspn.3, wcsdup.3, wcslen.3, wcsncasecmp.3, wcsncat.3, wcsncmp.3, wcsncpy.3, wcsnlen.3, wcsnrtombs.3, wcspbrk.3, wcsrchr.3, wcsrtombs.3, wcsspn.3, wcsstr.3, wcstok.3, wcstombs.3, wcswidth.3, wctob.3, wctomb.3, wctrans.3, wctype.3, wcwidth.3, wmemchr.3, wmemcmp.3, wmemcpy.3, wmemmove.3, wmemset.3, wprintf.3, console_ioctl.4, pts.4, elf.5, filesystems.5, hosts.5, proc.5, ttytype.5, boot.7, capabilities.7, credentials.7, epoll.7, glob.7, koi8-r.7, path_resolution.7, pty.7, signal.7, suffixes.7, time.7, unicode.7, unix.7, uri.7, utf-8.7: global fix: s/Unix/UNIX/ 
The man pages were rather inconsistent in the use of "Unix"
versus "UNIX". Let's go with the trademark usage.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2010-10-12 06:49:17 +02:00
Michael Kerrisk 00b08db3b4 clone.2, ptrace.2, setuid.2, statvfs.2, ulimit.3, nologin.5: Global fix: s/non-root/unprivileged/ 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2010-01-16 18:24:09 +01:00
Michael Kerrisk c7094399ad intro.1, time.1, adjtimex.2, capget.2, eventfd.2, fcntl.2, getrlimit.2, getsockopt.2, gettimeofday.2, intro.2, ioctl_list.2, ioperm.2, mlock.2, pivot_root.2, poll.2, prctl.2, ptrace.2, sched_setscheduler.2, select_tut.2, semget.2, sigaltstack.2, signalfd.2, sysctl.2, timer_settime.2, timerfd_create.2, wait.2, CPU_SET.3, argz_add.3, assert_perror.3, atexit.3, backtrace.3, bcmp.3, clearenv.3, ctime.3, dl_iterate_phdr.3, dlopen.3, ecvt.3, errno.3, error.3, ether_aton.3, exit.3, fenv.3, ferror.3, finite.3, flockfile.3, fnmatch.3, fpathconf.3, fpclassify.3, ftime.3, ftok.3, ftw.3, fwide.3, getaddrinfo.3, gethostbyname.3, getlogin.3, getnameinfo.3, getnetent.3, getopt.3, getprotoent.3, getrpcent.3, getservent.3, glob.3, hsearch.3, inet.3, isalpha.3, iswalnum.3, iswalpha.3, iswblank.3, iswcntrl.3, iswctype.3, iswdigit.3, iswgraph.3, iswlower.3, iswprint.3, iswpunct.3, iswspace.3, iswupper.3, iswxdigit.3, longjmp.3, lsearch.3, malloc.3, matherr.3, mblen.3, mbsinit.3, mbtowc.3, on_exit.3, printf.3, pthread_attr_init.3, pthread_attr_setaffinity_np.3, pthread_attr_setdetachstate.3, pthread_attr_setguardsize.3, pthread_attr_setinheritsched.3, pthread_attr_setschedparam.3, pthread_attr_setschedpolicy.3, pthread_attr_setscope.3, pthread_attr_setstack.3, pthread_attr_setstackaddr.3, pthread_attr_setstacksize.3, pthread_cancel.3, pthread_cleanup_push.3, pthread_equal.3, pthread_getattr_np.3, pthread_getcpuclockid.3, pthread_setaffinity_np.3, pthread_setcancelstate.3, pthread_setconcurrency.3, pthread_setschedparam.3, pthread_setschedprio.3, ptsname.3, putenv.3, putgrent.3, raise.3, rcmd.3, regex.3, rexec.3, rpc.3, rpmatch.3, rtnetlink.3, scandir.3, sem_init.3, setaliasent.3, setbuf.3, setenv.3, setjmp.3, signbit.3, stdio_ext.3, strtod.3, strtol.3, strtoul.3, system.3, termios.3, timeradd.3, tzset.3, ualarm.3, wctomb.3, xdr.3, st.4, tty_ioctl.4, core.5, elf.5, proc.5, bootparam.7, capabilities.7, icmp.7, ip.7, ipv6.7, math_error.7, mdoc.samples.7, mq_overview.7, pthreads.7, raw.7, regex.7, socket.7, tcp.7, tzselect.8: Global fix: s/non-zero/nonzero/ 
The tendency in English, as prescribed in style guides like
Chicago MoS, is towards removing hyphens after prefixes
like "non-" etc.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2010-01-16 17:40:55 +01:00
Michael Kerrisk 94cffcd707 ptrace.2: Note use of 'data' for PTRACE_SYS{CALL,EMU} and PTRCAE_*_SINGLESTEP 
These operations use the 'data' argument as a signal number,
like PTRACE_CONT.

Reported-by: Mike Frysinger <vapier@gentoo.org>
Reported-by: Roland McGrath <roland@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2009-03-30 13:32:37 +13:00
Mike Frysinger c71df6fba0 ptrace.2: only reference <sys/user.h> 
The kernel no longer installs linux/user.h, so update
references to sys/user.h.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2009-03-30 09:30:23 +13:00
Michael Kerrisk 67da52673e Start new sentence on new source line. 2008-09-10 03:45:09 +00:00
Michael Kerrisk 44a2c3286c Even when the CONFORMING TO section is just a list of standards, 
they should be terminated by a period.
 2008-07-15 13:39:17 +00:00
Michael Kerrisk 8660aec07e Re PTRACE_PEEKUSER: the offsets and data returned might not 
match with the defintion of struct user.
 2008-05-21 20:23:25 +00:00
Michael Kerrisk eba722884d s/nonzero/non-zero/ 2008-03-19 13:16:39 +00:00
Michael Kerrisk a1ffe9f5a2 s/current process/calling process/ 2007-12-27 16:06:35 +00:00
Michael Kerrisk c382a36592 hyphenation fixes 2007-12-25 22:02:19 +00:00
Michael Kerrisk 254255afd0 Added comment about PTRACE_{POKE,PEEK}US[E]R spelling. 2007-11-24 07:34:48 +00:00
Michael Kerrisk a5b9e01508 Update date in TH line 2007-11-15 03:21:33 +00:00
Michael Kerrisk 428d352029 s/PTRACE_POKEUSR/PTRACE_POKEUSER/ 
s/PTRACE_PEEKUSR/PTRACE_PEEKUSER/
 2007-10-17 20:49:47 +00:00
Michael Kerrisk 6beb1671d2 tfix/wfix 2007-10-16 19:18:17 +00:00
Michael Kerrisk 0daa9e92d0 Fix redundant formatting macros 2007-09-20 16:26:31 +00:00
Michael Kerrisk c11b1abf2e Change mtk's email address 2007-09-20 06:52:22 +00:00
Michael Kerrisk 5260fe08cf Use 'glibc' consistently to refer to GNU C library. 2007-07-09 22:01:31 +00:00
Michael Kerrisk 10f5f29476 s/bitmask/bit mask/ 2007-07-01 04:23:34 +00:00
Michael Kerrisk 66ee0c7e89 ffix 2007-06-23 07:19:07 +00:00
Michael Kerrisk 2f0af33ba6 ffix 2007-06-22 19:42:52 +00:00
Michael Kerrisk 988db66164 strip trailing white space 2007-06-21 22:55:04 +00:00
Michael Kerrisk 8bd58774dc Formatted signal names 2007-06-21 05:38:48 +00:00
Michael Kerrisk c84371c688 Italics for header file references 2007-06-20 21:53:34 +00:00
Michael Kerrisk 3758f6dad4 Minor wording fixes 2007-06-02 05:45:14 +00:00
Michael Kerrisk d9343c5c13 Removed version number from .TH line 2007-05-30 05:36:26 +00:00
Michael Kerrisk 2b2581ee37 Fix inconsistencies in order of .SH sections 2007-05-19 04:30:20 +00:00
Michael Kerrisk a1d5f77cc8 Reordered sections to be more consistent, in some cases renaming 
sections or shifting paragraphs between sections.
 2007-05-18 16:06:42 +00:00
Michael Kerrisk 0bfa087b03 Add section numbers to references to other pages 2007-05-11 23:07:02 +00:00
Michael Kerrisk c13182efa3 Wrapped long lines, wrapped at sentence boundaries; stripped trailing 
white space.
 2007-04-12 22:42:49 +00:00
Michael Kerrisk a832b2d85b wfix 2006-12-27 02:47:18 +00:00
Michael Kerrisk 9110c53a81 ffix 2006-12-16 20:56:09 +00:00
Michael Kerrisk cd270bc04b fix long line in source 2006-12-16 19:23:29 +00:00
Michael Kerrisk 6d3925acc3 When the parent receives an event with PTRACE_EVENT_* set, the child 
is not in the normal signal delivery path.  This means the parent 
cannot do ptrace(PTRACE_CONT) with a signal or ptrace(PTRACE_KILL).  
kill() with a SIGKILL signal can be used instead to kill the child 
process after receiving one of these messages.
 2006-12-16 19:18:56 +00:00
Michael Kerrisk 53e4da489a Since Linux 2.6.18, the PID of the new process is also available 
for PTRACE_EVENT_VFORKDONE.
 2006-11-25 01:21:51 +00:00
Michael Kerrisk 97c1eac86f Updated CONFORMING TO section 2006-08-03 13:57:17 +00:00
Michael Kerrisk cb1c9135d0 ffix 2006-08-03 03:02:31 +00:00
Michael Kerrisk 217b389ac5 Removed FIXME. 2006-03-25 21:29:31 +00:00
Michael Kerrisk e63ad01dce Wrapped long lines (no content changes). 2006-03-25 21:28:28 +00:00
Michael Kerrisk 44b35ee067 Chuck Ebbert, with assistance from Daniel Jacobowitz, 
Paolo (Blaisorblade) Giarrusso, and Charles P. Wright;
after a suggestion from Heiko Carstens.
    Document the following ptrace requests: 
        PTRACE_SETOPTIONS (2.4.6)
            plus associated flags:
                PTRACE_O_TRACESYSGOOD (2.4.6)
                PTRACE_O_TRACEFORK (2.5.46)
                PTRACE_O_TRACEVFORK (2.5.46)
                PTRACE_O_TRACECLONE (2.5.46)
                PTRACE_O_TRACEEXEC (2.5.46)
                PTRACE_O_TRACEVFORKDONE (2.5.60)
                PTRACE_O_TRACEEXIT (2.5.60)
        PTRACE_SETSIGINFO (2.3.99-pre6)
        PTRACE_GETSIGINFO (2.3.99-pre6)
        PTRACE_GETEVENTMSG (2.5.46)
        PTRACE_SYSEMU (since Linux 2.6.14)
        PTRACE_SYSEMU_SINGLESTEP (since Linux 2.6.14)
 2006-03-23 22:00:08 +00:00
Michael Kerrisk 60e94b7cef Added FIXME 2006-03-02 05:04:48 +00:00
Michael Kerrisk 31e9a9ec99 Change itacised function names and page xrefs to bold 2005-11-02 11:34:24 +00:00
Michael Kerrisk 197889d00b Formatting fixes 2005-11-02 10:53:26 +00:00
Michael Kerrisk 4d52e8f81c Formatting fixes 2005-10-19 14:54:31 +00:00
Michael Kerrisk e1d6264d9f Manual fixes for parentheses formatting 2005-10-19 07:29:28 +00:00
Michael Kerrisk e511ffb6bc Automated addition of parentheses by add_parens_for_own_funcs.sh 2005-10-19 06:54:38 +00:00
Michael Kerrisk a5e0a0e427 Formatting fixes. 2005-07-19 15:36:19 +00:00
Michael Kerrisk e360c3a9cf s/pid/PID/ 2005-07-19 06:32:54 +00:00
Michael Kerrisk b14d4aa5b8 Classical BSD versions are now always named x.yBSD (formerly 
there was a mix of x.yBSD and BSD x.y).
 2005-07-18 15:05:56 +00:00
Michael Kerrisk 880f5b4bc3 Consistent use of "set-user-ID" and "set-group-ID". 2005-07-18 14:25:42 +00:00
Michael Kerrisk 305a0578bf Global change of email address for MTK (now: mtk-manpages@gmx.net) 2004-11-03 14:43:40 +00:00
Michael Kerrisk fea681dafb Import of man-pages 1.70 2004-11-03 13:51:07 +00:00