Merge lp:~mfisch/ubuntu/saucy/manpages/update_to_3.51 into lp:ubuntu/saucy/manpages

Proposed by Matt Fischer
Status: Merged
Merge reported by: Sebastien Bacher
Merged at revision: not available
Proposed branch: lp:~mfisch/ubuntu/saucy/manpages/update_to_3.51
Merge into: lp:ubuntu/saucy/manpages
Diff against target: 66542 lines (+16335/-7024)
997 files modified
Changes (+300/-188)
Changes.old (+1591/-0)
Makefile (+1/-1)
debian/changelog (+59/-0)
debian/check-conflicts (+18/-0)
debian/control (+5/-5)
debian/copyright (+4/-4)
debian/inst (+11/-7)
debian/lintian.manpages (+7/-0)
debian/make-copyright (+3/-0)
debian/rules (+4/-0)
man-pages-3.44.Announce (+0/-62)
man-pages-3.44.lsm (+0/-14)
man-pages-3.51.Announce (+62/-0)
man-pages-3.51.lsm (+14/-0)
man1/getent.1 (+9/-8)
man1/intro.1 (+13/-11)
man1/ldd.1 (+5/-1)
man1/time.1 (+11/-9)
man2/_exit.2 (+7/-7)
man2/_syscall.2 (+10/-10)
man2/accept.2 (+8/-6)
man2/access.2 (+17/-8)
man2/acct.2 (+8/-9)
man2/add_key.2 (+6/-9)
man2/adjtimex.2 (+8/-9)
man2/alarm.2 (+9/-11)
man2/alloc_hugepages.2 (+5/-5)
man2/arch_prctl.2 (+9/-8)
man2/bdflush.2 (+8/-9)
man2/bind.2 (+8/-6)
man2/brk.2 (+9/-10)
man2/cacheflush.2 (+7/-6)
man2/capget.2 (+22/-14)
man2/chdir.2 (+6/-6)
man2/chmod.2 (+6/-6)
man2/chown.2 (+9/-9)
man2/chroot.2 (+6/-6)
man2/clock_getres.2 (+33/-10)
man2/clock_nanosleep.2 (+6/-4)
man2/clone.2 (+218/-68)
man2/close.2 (+7/-7)
man2/connect.2 (+8/-6)
man2/create_module.2 (+8/-6)
man2/delete_module.2 (+10/-10)
man2/dup.2 (+6/-6)
man2/epoll_create.2 (+9/-11)
man2/epoll_ctl.2 (+9/-10)
man2/epoll_wait.2 (+9/-10)
man2/eventfd.2 (+10/-10)
man2/execve.2 (+7/-7)
man2/exit_group.2 (+6/-4)
man2/faccessat.2 (+7/-8)
man2/fallocate.2 (+10/-2)
man2/fattach.2 (+1/-0)
man2/fchmodat.2 (+6/-7)
man2/fchownat.2 (+6/-7)
man2/fcntl.2 (+17/-17)
man2/fdetach.2 (+1/-0)
man2/finit_module.2 (+1/-0)
man2/flock.2 (+11/-9)
man2/fork.2 (+14/-7)
man2/fstatat.2 (+6/-6)
man2/fsync.2 (+6/-7)
man2/futex.2 (+48/-12)
man2/futimesat.2 (+7/-8)
man2/get_kernel_syms.2 (+8/-6)
man2/get_mempolicy.2 (+3/-1)
man2/get_robust_list.2 (+6/-4)
man2/get_thread_area.2 (+11/-9)
man2/getcontext.2 (+1/-172)
man2/getcpu.2 (+13/-7)
man2/getdents.2 (+12/-9)
man2/getdomainname.2 (+6/-6)
man2/getdtablesize.2 (+2/-102)
man2/getgid.2 (+5/-5)
man2/getgroups.2 (+6/-6)
man2/gethostname.2 (+7/-7)
man2/getitimer.2 (+9/-4)
man2/getmsg.2 (+1/-0)
man2/getpagesize.2 (+4/-2)
man2/getpeername.2 (+34/-5)
man2/getpid.2 (+7/-5)
man2/getpriority.2 (+16/-7)
man2/getresuid.2 (+7/-6)
man2/getrlimit.2 (+90/-53)
man2/getrusage.2 (+9/-8)
man2/getsid.2 (+7/-6)
man2/getsockname.2 (+6/-4)
man2/getsockopt.2 (+6/-4)
man2/gettid.2 (+23/-8)
man2/gettimeofday.2 (+9/-7)
man2/getuid.2 (+6/-6)
man2/getunwind.2 (+120/-0)
man2/getxattr.2 (+27/-29)
man2/idle.2 (+7/-7)
man2/init_module.2 (+141/-25)
man2/inotify_add_watch.2 (+8/-9)
man2/inotify_init.2 (+8/-9)
man2/inotify_rm_watch.2 (+8/-9)
man2/intro.2 (+7/-5)
man2/io_cancel.2 (+20/-14)
man2/io_destroy.2 (+17/-17)
man2/io_getevents.2 (+18/-13)
man2/io_setup.2 (+16/-12)
man2/io_submit.2 (+11/-9)
man2/ioctl.2 (+5/-3)
man2/ioctl_list.2 (+11/-8)
man2/ioperm.2 (+36/-22)
man2/iopl.2 (+13/-10)
man2/ioprio_set.2 (+16/-16)
man2/ipc.2 (+8/-9)
man2/isastream.2 (+1/-0)
man2/kcmp.2 (+229/-0)
man2/kexec_load.2 (+7/-6)
man2/keyctl.2 (+4/-4)
man2/kill.2 (+9/-9)
man2/killpg.2 (+6/-5)
man2/link.2 (+11/-8)
man2/linkat.2 (+6/-6)
man2/listen.2 (+6/-4)
man2/listxattr.2 (+24/-26)
man2/llseek.2 (+7/-5)
man2/lookup_dcookie.2 (+6/-6)
man2/lseek.2 (+17/-6)
man2/madvise.2 (+14/-14)
man2/mbind.2 (+26/-6)
man2/migrate_pages.2 (+9/-8)
man2/mincore.2 (+6/-6)
man2/mkdir.2 (+14/-9)
man2/mkdirat.2 (+6/-7)
man2/mknod.2 (+15/-10)
man2/mknodat.2 (+6/-7)
man2/mlock.2 (+14/-15)
man2/mmap.2 (+80/-14)
man2/mmap2.2 (+6/-6)
man2/modify_ldt.2 (+8/-9)
man2/mount.2 (+33/-6)
man2/move_pages.2 (+8/-8)
man2/mprotect.2 (+12/-6)
man2/mq_getsetattr.2 (+4/-4)
man2/mremap.2 (+8/-9)
man2/msgctl.2 (+8/-6)
man2/msgget.2 (+10/-8)
man2/msgop.2 (+8/-6)
man2/msync.2 (+6/-6)
man2/nanosleep.2 (+9/-10)
man2/nfsservctl.2 (+5/-5)
man2/nice.2 (+6/-6)
man2/open.2 (+43/-24)
man2/openat.2 (+6/-7)
man2/outb.2 (+41/-12)
man2/pause.2 (+7/-7)
man2/pciconfig_read.2 (+8/-5)
man2/perf_event_open.2 (+1961/-0)
man2/perfmonctl.2 (+216/-0)
man2/personality.2 (+5/-3)
man2/pipe.2 (+6/-6)
man2/pivot_root.2 (+7/-4)
man2/poll.2 (+7/-7)
man2/posix_fadvise.2 (+27/-18)
man2/prctl.2 (+103/-24)
man2/pread.2 (+12/-5)
man2/process_vm_readv.2 (+6/-4)
man2/ptrace.2 (+214/-95)
man2/putmsg.2 (+1/-0)
man2/query_module.2 (+16/-7)
man2/quotactl.2 (+10/-8)
man2/read.2 (+31/-22)
man2/readahead.2 (+12/-7)
man2/readdir.2 (+9/-5)
man2/readlink.2 (+6/-4)
man2/readlinkat.2 (+6/-7)
man2/readv.2 (+8/-6)
man2/reboot.2 (+8/-5)
man2/recv.2 (+10/-8)
man2/recvmmsg.2 (+107/-7)
man2/remap_file_pages.2 (+6/-4)
man2/removexattr.2 (+22/-22)
man2/rename.2 (+12/-9)
man2/renameat.2 (+6/-7)
man2/request_key.2 (+4/-4)
man2/rmdir.2 (+7/-7)
man2/rt_sigqueueinfo.2 (+6/-4)
man2/s390_runtime_instr.2 (+98/-0)
man2/sched_get_priority_max.2 (+8/-9)
man2/sched_rr_get_interval.2 (+20/-14)
man2/sched_setaffinity.2 (+11/-11)
man2/sched_setparam.2 (+15/-10)
man2/sched_setscheduler.2 (+47/-27)
man2/sched_yield.2 (+8/-9)
man2/select.2 (+8/-8)
man2/select_tut.2 (+8/-6)
man2/semctl.2 (+8/-6)
man2/semget.2 (+8/-6)
man2/semop.2 (+35/-28)
man2/send.2 (+11/-9)
man2/sendfile.2 (+8/-4)
man2/sendmmsg.2 (+73/-5)
man2/set_mempolicy.2 (+5/-3)
man2/set_thread_area.2 (+12/-11)
man2/set_tid_address.2 (+6/-4)
man2/setcontext.2 (+1/-1)
man2/seteuid.2 (+6/-4)
man2/setfsgid.2 (+8/-6)
man2/setfsuid.2 (+8/-6)
man2/setgid.2 (+7/-5)
man2/setns.2 (+93/-10)
man2/setpgid.2 (+6/-4)
man2/setresuid.2 (+6/-6)
man2/setreuid.2 (+6/-4)
man2/setsid.2 (+11/-9)
man2/setuid.2 (+6/-4)
man2/setup.2 (+5/-5)
man2/setxattr.2 (+32/-33)
man2/sgetmask.2 (+3/-1)
man2/shmctl.2 (+15/-8)
man2/shmget.2 (+9/-7)
man2/shmop.2 (+12/-7)
man2/shutdown.2 (+6/-4)
man2/sigaction.2 (+22/-17)
man2/sigaltstack.2 (+6/-4)
man2/signal.2 (+25/-10)
man2/signalfd.2 (+10/-7)
man2/sigpending.2 (+6/-4)
man2/sigprocmask.2 (+6/-4)
man2/sigreturn.2 (+6/-4)
man2/sigsuspend.2 (+6/-4)
man2/sigwaitinfo.2 (+6/-4)
man2/socket.2 (+6/-4)
man2/socketcall.2 (+7/-8)
man2/socketpair.2 (+6/-4)
man2/splice.2 (+4/-4)
man2/spu_create.2 (+7/-6)
man2/spu_run.2 (+8/-7)
man2/stat.2 (+20/-14)
man2/statfs.2 (+6/-4)
man2/stime.2 (+7/-7)
man2/subpage_prot.2 (+8/-6)
man2/swapon.2 (+7/-7)
man2/symlink.2 (+13/-8)
man2/symlinkat.2 (+6/-7)
man2/sync.2 (+5/-5)
man2/sync_file_range.2 (+11/-7)
man2/syscall.2 (+120/-2)
man2/syscalls.2 (+211/-183)
man2/sysctl.2 (+16/-6)
man2/sysfs.2 (+5/-3)
man2/sysinfo.2 (+6/-6)
man2/syslog.2 (+139/-98)
man2/tee.2 (+4/-4)
man2/time.2 (+6/-6)
man2/timer_create.2 (+5/-3)
man2/timer_delete.2 (+4/-1)
man2/timer_getoverrun.2 (+5/-2)
man2/timer_settime.2 (+4/-1)
man2/timerfd_create.2 (+14/-13)
man2/times.2 (+9/-9)
man2/tkill.2 (+32/-9)
man2/truncate.2 (+12/-5)
man2/umask.2 (+7/-7)
man2/umount.2 (+7/-7)
man2/uname.2 (+6/-4)
man2/unimplemented.2 (+14/-14)
man2/unlink.2 (+7/-7)
man2/unlinkat.2 (+7/-8)
man2/unshare.2 (+54/-30)
man2/uselib.2 (+6/-6)
man2/ustat.2 (+8/-6)
man2/utime.2 (+6/-6)
man2/utimensat.2 (+6/-6)
man2/vfork.2 (+9/-8)
man2/vhangup.2 (+9/-8)
man2/vm86.2 (+6/-6)
man2/vmsplice.2 (+4/-4)
man2/wait.2 (+30/-16)
man2/wait4.2 (+6/-7)
man2/write.2 (+14/-8)
man3/CPU_SET.3 (+6/-4)
man3/INFINITY.3 (+5/-3)
man3/MB_CUR_MAX.3 (+6/-4)
man3/MB_LEN_MAX.3 (+6/-4)
man3/__after_morecore_hook.3 (+1/-0)
man3/__free_hook.3 (+1/-0)
man3/__malloc_initialize_hook.3 (+1/-0)
man3/__memalign_hook.3 (+1/-0)
man3/__realloc_hook.3 (+1/-0)
man3/__setfpucw.3 (+18/-14)
man3/a64l.3 (+6/-3)
man3/abort.3 (+6/-4)
man3/abs.3 (+7/-5)
man3/acos.3 (+6/-4)
man3/acosh.3 (+6/-4)
man3/addseverity.3 (+8/-5)
man3/adjtime.3 (+5/-3)
man3/aio_cancel.3 (+8/-7)
man3/aio_error.3 (+8/-7)
man3/aio_fsync.3 (+8/-7)
man3/aio_init.3 (+3/-1)
man3/aio_read.3 (+9/-8)
man3/aio_return.3 (+8/-7)
man3/aio_suspend.3 (+8/-7)
man3/aio_write.3 (+9/-8)
man3/alloca.3 (+7/-5)
man3/argz_add.3 (+7/-3)
man3/asin.3 (+6/-4)
man3/asinh.3 (+6/-4)
man3/asprintf.3 (+5/-3)
man3/assert.3 (+7/-5)
man3/assert_perror.3 (+6/-4)
man3/atan.3 (+6/-4)
man3/atan2.3 (+6/-4)
man3/atanh.3 (+6/-4)
man3/atexit.3 (+7/-5)
man3/atof.3 (+6/-4)
man3/atoi.3 (+6/-4)
man3/backtrace.3 (+4/-2)
man3/basename.3 (+7/-5)
man3/bcmp.3 (+6/-4)
man3/bcopy.3 (+6/-4)
man3/bindresvport.3 (+5/-2)
man3/bsd_signal.3 (+7/-5)
man3/bsearch.3 (+6/-4)
man3/bstring.3 (+4/-2)
man3/btowc.3 (+6/-4)
man3/btree.3 (+4/-2)
man3/byteorder.3 (+5/-3)
man3/bzero.3 (+6/-4)
man3/cabs.3 (+6/-3)
man3/cacos.3 (+6/-3)
man3/cacosh.3 (+6/-3)
man3/canonicalize_file_name.3 (+67/-12)
man3/carg.3 (+7/-4)
man3/casin.3 (+6/-3)
man3/casinh.3 (+6/-3)
man3/catan.3 (+6/-3)
man3/catanh.3 (+6/-3)
man3/catgets.3 (+9/-7)
man3/catopen.3 (+7/-5)
man3/cbrt.3 (+5/-3)
man3/ccos.3 (+6/-3)
man3/ccosh.3 (+6/-3)
man3/ceil.3 (+6/-4)
man3/cerf.3 (+6/-3)
man3/cexp.3 (+6/-3)
man3/cexp2.3 (+8/-5)
man3/cfree.3 (+9/-8)
man3/cimag.3 (+6/-3)
man3/clearenv.3 (+7/-5)
man3/clock.3 (+7/-5)
man3/clock_getcpuclockid.3 (+4/-2)
man3/clog.3 (+6/-3)
man3/clog10.3 (+6/-3)
man3/clog2.3 (+6/-3)
man3/closedir.3 (+6/-4)
man3/cmsg.3 (+10/-6)
man3/confstr.3 (+8/-6)
man3/conj.3 (+6/-3)
man3/copysign.3 (+5/-3)
man3/cos.3 (+5/-3)
man3/cosh.3 (+6/-4)
man3/cpow.3 (+6/-3)
man3/cproj.3 (+6/-3)
man3/creal.3 (+6/-3)
man3/crypt.3 (+9/-8)
man3/csin.3 (+6/-3)
man3/csinh.3 (+6/-3)
man3/csqrt.3 (+6/-3)
man3/ctan.3 (+6/-3)
man3/ctanh.3 (+6/-3)
man3/ctermid.3 (+7/-5)
man3/ctime.3 (+6/-4)
man3/daemon.3 (+5/-3)
man3/dbopen.3 (+6/-4)
man3/des_crypt.3 (+7/-3)
man3/difftime.3 (+6/-8)
man3/dirfd.3 (+7/-5)
man3/div.3 (+6/-4)
man3/dl_iterate_phdr.3 (+5/-4)
man3/dlopen.3 (+14/-14)
man3/dprintf.3 (+6/-5)
man3/drand48.3 (+5/-3)
man3/drand48_r.3 (+6/-4)
man3/dysize.3 (+5/-3)
man3/ecvt.3 (+6/-4)
man3/ecvt_r.3 (+6/-4)
man3/encrypt.3 (+10/-4)
man3/end.3 (+4/-3)
man3/endian.3 (+5/-3)
man3/envz_add.3 (+8/-4)
man3/erf.3 (+5/-3)
man3/erfc.3 (+5/-3)
man3/err.3 (+4/-2)
man3/errno.3 (+6/-5)
man3/error.3 (+4/-2)
man3/ether_aton.3 (+5/-5)
man3/euidaccess.3 (+6/-7)
man3/exec.3 (+8/-6)
man3/exit.3 (+18/-6)
man3/exp.3 (+5/-3)
man3/exp10.3 (+5/-3)
man3/exp2.3 (+5/-3)
man3/expm1.3 (+5/-3)
man3/fabs.3 (+5/-3)
man3/fclose.3 (+8/-5)
man3/fcloseall.3 (+6/-5)
man3/fdim.3 (+7/-4)
man3/fenv.3 (+12/-11)
man3/ferror.3 (+7/-6)
man3/fexecve.3 (+6/-6)
man3/fflush.3 (+7/-5)
man3/ffs.3 (+6/-4)
man3/fgetgrent.3 (+6/-4)
man3/fgetpwent.3 (+6/-4)
man3/fgetwc.3 (+6/-4)
man3/fgetws.3 (+6/-4)
man3/finite.3 (+4/-2)
man3/flockfile.3 (+6/-4)
man3/floor.3 (+6/-4)
man3/fma.3 (+8/-4)
man3/fmax.3 (+6/-3)
man3/fmemopen.3 (+10/-6)
man3/fmin.3 (+6/-3)
man3/fmod.3 (+6/-4)
man3/fmtmsg.3 (+12/-8)
man3/fnmatch.3 (+8/-6)
man3/fopen.3 (+9/-7)
man3/fopencookie.3 (+6/-4)
man3/fpathconf.3 (+22/-5)
man3/fpclassify.3 (+8/-4)
man3/fpurge.3 (+6/-4)
man3/fputwc.3 (+6/-4)
man3/fputws.3 (+6/-4)
man3/fread.3 (+6/-4)
man3/frexp.3 (+6/-4)
man3/fseek.3 (+10/-6)
man3/fseeko.3 (+5/-3)
man3/ftime.3 (+8/-9)
man3/ftok.3 (+6/-4)
man3/fts.3 (+4/-2)
man3/ftw.3 (+8/-7)
man3/futimes.3 (+14/-8)
man3/fwide.3 (+6/-4)
man3/gamma.3 (+8/-5)
man3/gcvt.3 (+6/-4)
man3/get_nprocs_conf.3 (+8/-6)
man3/getaddrinfo.3 (+17/-14)
man3/getaddrinfo_a.3 (+9/-9)
man3/getauxval.3 (+6/-4)
man3/getcontext.3 (+174/-0)
man3/getcwd.3 (+7/-5)
man3/getdate.3 (+6/-4)
man3/getdirentries.3 (+6/-6)
man3/getdtablesize.3 (+102/-0)
man3/getenv.3 (+10/-8)
man3/getfsent.3 (+6/-4)
man3/getgrent.3 (+6/-4)
man3/getgrent_r.3 (+8/-7)
man3/getgrnam.3 (+6/-4)
man3/getgrouplist.3 (+10/-8)
man3/gethostbyname.3 (+8/-6)
man3/gethostid.3 (+9/-9)
man3/getifaddrs.3 (+12/-5)
man3/getipnodebyname.3 (+7/-5)
man3/getline.3 (+8/-6)
man3/getloadavg.3 (+4/-2)
man3/getlogin.3 (+9/-9)
man3/getmntent.3 (+6/-4)
man3/getnameinfo.3 (+10/-7)
man3/getnetent.3 (+6/-4)
man3/getnetent_r.3 (+6/-4)
man3/getopt.3 (+7/-5)
man3/getpass.3 (+14/-8)
man3/getprotoent.3 (+6/-4)
man3/getprotoent_r.3 (+6/-4)
man3/getpt.3 (+6/-4)
man3/getpw.3 (+6/-4)
man3/getpwent.3 (+6/-4)
man3/getpwent_r.3 (+8/-7)
man3/getpwnam.3 (+7/-5)
man3/getrpcent.3 (+14/-6)
man3/getrpcent_r.3 (+6/-4)
man3/getrpcport.3 (+6/-2)
man3/gets.3 (+7/-5)
man3/getservent.3 (+6/-4)
man3/getservent_r.3 (+6/-4)
man3/getspnam.3 (+17/-10)
man3/getsubopt.3 (+3/-1)
man3/getttyent.3 (+8/-5)
man3/getumask.3 (+5/-3)
man3/getusershell.3 (+6/-4)
man3/getutent.3 (+9/-8)
man3/getutmp.3 (+3/-1)
man3/getw.3 (+7/-5)
man3/getwchar.3 (+6/-4)
man3/glob.3 (+7/-5)
man3/gnu_get_libc_version.3 (+3/-1)
man3/grantpt.3 (+6/-5)
man3/gsignal.3 (+5/-3)
man3/hash.3 (+4/-2)
man3/hsearch.3 (+9/-9)
man3/hypot.3 (+5/-3)
man3/iconv.3 (+6/-4)
man3/iconv_close.3 (+6/-4)
man3/iconv_open.3 (+6/-4)
man3/if_freenameindex.3 (+1/-0)
man3/if_indextoname.3 (+1/-0)
man3/if_nameindex.3 (+160/-0)
man3/if_nametoindex.3 (+100/-0)
man3/ilogb.3 (+5/-3)
man3/index.3 (+6/-4)
man3/inet.3 (+7/-7)
man3/inet_ntop.3 (+6/-4)
man3/inet_pton.3 (+7/-5)
man3/infnan.3 (+5/-3)
man3/initgroups.3 (+6/-4)
man3/insque.3 (+5/-3)
man3/intro.3 (+6/-4)
man3/isalpha.3 (+6/-5)
man3/isatty.3 (+5/-3)
man3/isgreater.3 (+7/-3)
man3/iswalnum.3 (+6/-4)
man3/iswalpha.3 (+6/-4)
man3/iswblank.3 (+6/-4)
man3/iswcntrl.3 (+6/-4)
man3/iswctype.3 (+6/-4)
man3/iswdigit.3 (+6/-4)
man3/iswgraph.3 (+6/-4)
man3/iswlower.3 (+6/-4)
man3/iswprint.3 (+6/-4)
man3/iswpunct.3 (+6/-4)
man3/iswspace.3 (+6/-4)
man3/iswupper.3 (+6/-4)
man3/iswxdigit.3 (+6/-4)
man3/j0.3 (+4/-2)
man3/key_setsecret.3 (+8/-4)
man3/ldexp.3 (+5/-3)
man3/lgamma.3 (+9/-5)
man3/lio_listio.3 (+7/-6)
man3/localeconv.3 (+6/-4)
man3/lockf.3 (+10/-4)
man3/log.3 (+5/-3)
man3/log10.3 (+5/-3)
man3/log1p.3 (+5/-3)
man3/log2.3 (+5/-3)
man3/logb.3 (+5/-3)
man3/login.3 (+14/-13)
man3/longjmp.3 (+8/-7)
man3/lrint.3 (+6/-4)
man3/lround.3 (+6/-4)
man3/lsearch.3 (+6/-5)
man3/lseek64.3 (+4/-2)
man3/makecontext.3 (+15/-12)
man3/makedev.3 (+5/-4)
man3/mallinfo.3 (+3/-2)
man3/malloc.3 (+7/-5)
man3/malloc_get_state.3 (+3/-1)
man3/malloc_hook.3 (+8/-4)
man3/malloc_info.3 (+4/-2)
man3/malloc_stats.3 (+3/-1)
man3/malloc_trim.3 (+5/-3)
man3/malloc_usable_size.3 (+3/-1)
man3/mallopt.3 (+4/-2)
man3/matherr.3 (+3/-1)
man3/mblen.3 (+8/-7)
man3/mbrlen.3 (+7/-5)
man3/mbrtowc.3 (+9/-5)
man3/mbsinit.3 (+6/-4)
man3/mbsnrtowcs.3 (+9/-5)
man3/mbsrtowcs.3 (+7/-5)
man3/mbstowcs.3 (+6/-4)
man3/mbtowc.3 (+8/-5)
man3/mcheck.3 (+4/-4)
man3/memccpy.3 (+6/-4)
man3/memchr.3 (+6/-4)
man3/memcmp.3 (+15/-8)
man3/memcpy.3 (+6/-4)
man3/memfrob.3 (+7/-5)
man3/memmem.3 (+6/-4)
man3/memmove.3 (+6/-4)
man3/mempcpy.3 (+9/-5)
man3/memset.3 (+6/-4)
man3/mkdtemp.3 (+6/-4)
man3/mkfifo.3 (+11/-7)
man3/mkfifoat.3 (+6/-6)
man3/mkstemp.3 (+11/-8)
man3/mktemp.3 (+6/-4)
man3/modf.3 (+6/-4)
man3/mpool.3 (+5/-3)
man3/mq_close.3 (+4/-4)
man3/mq_getattr.3 (+4/-4)
man3/mq_notify.3 (+6/-6)
man3/mq_open.3 (+4/-4)
man3/mq_receive.3 (+5/-5)
man3/mq_send.3 (+4/-4)
man3/mq_unlink.3 (+4/-4)
man3/mtrace.3 (+6/-4)
man3/nan.3 (+8/-3)
man3/netlink.3 (+10/-4)
man3/nextafter.3 (+8/-3)
man3/nl_langinfo.3 (+7/-5)
man3/offsetof.3 (+5/-3)
man3/on_exit.3 (+6/-4)
man3/opendir.3 (+6/-4)
man3/openpty.3 (+10/-8)
man3/perror.3 (+7/-7)
man3/popen.3 (+6/-4)
man3/posix_fallocate.3 (+9/-6)
man3/posix_memalign.3 (+11/-11)
man3/posix_openpt.3 (+6/-6)
man3/pow.3 (+5/-3)
man3/pow10.3 (+5/-3)
man3/printf.3 (+39/-33)
man3/profil.3 (+6/-6)
man3/program_invocation_name.3 (+5/-2)
man3/psignal.3 (+6/-4)
man3/pthread_attr_init.3 (+3/-1)
man3/pthread_attr_setaffinity_np.3 (+3/-1)
man3/pthread_attr_setdetachstate.3 (+3/-1)
man3/pthread_attr_setguardsize.3 (+3/-1)
man3/pthread_attr_setinheritsched.3 (+3/-1)
man3/pthread_attr_setschedparam.3 (+3/-1)
man3/pthread_attr_setschedpolicy.3 (+3/-1)
man3/pthread_attr_setscope.3 (+4/-2)
man3/pthread_attr_setstack.3 (+3/-1)
man3/pthread_attr_setstackaddr.3 (+3/-1)
man3/pthread_attr_setstacksize.3 (+3/-1)
man3/pthread_cancel.3 (+3/-1)
man3/pthread_cleanup_push.3 (+5/-3)
man3/pthread_cleanup_push_defer_np.3 (+3/-1)
man3/pthread_create.3 (+3/-1)
man3/pthread_detach.3 (+3/-1)
man3/pthread_equal.3 (+3/-1)
man3/pthread_exit.3 (+3/-1)
man3/pthread_getattr_np.3 (+3/-1)
man3/pthread_getcpuclockid.3 (+3/-1)
man3/pthread_getname_np.3 (+1/-0)
man3/pthread_join.3 (+3/-1)
man3/pthread_kill.3 (+3/-1)
man3/pthread_kill_other_threads_np.3 (+5/-3)
man3/pthread_self.3 (+4/-2)
man3/pthread_setaffinity_np.3 (+3/-1)
man3/pthread_setcancelstate.3 (+4/-2)
man3/pthread_setconcurrency.3 (+5/-3)
man3/pthread_setname_np.3 (+211/-0)
man3/pthread_setschedparam.3 (+3/-1)
man3/pthread_setschedprio.3 (+3/-1)
man3/pthread_sigmask.3 (+3/-1)
man3/pthread_sigqueue.3 (+3/-1)
man3/pthread_testcancel.3 (+4/-2)
man3/pthread_tryjoin_np.3 (+3/-1)
man3/pthread_yield.3 (+5/-2)
man3/ptsname.3 (+6/-5)
man3/putenv.3 (+6/-4)
man3/putgrent.3 (+7/-4)
man3/putpwent.3 (+6/-4)
man3/puts.3 (+8/-6)
man3/putwchar.3 (+6/-4)
man3/qecvt.3 (+5/-3)
man3/qsort.3 (+6/-4)
man3/queue.3 (+9/-7)
man3/raise.3 (+8/-6)
man3/rand.3 (+6/-4)
man3/random.3 (+6/-4)
man3/random_r.3 (+6/-4)
man3/rcmd.3 (+4/-2)
man3/re_comp.3 (+6/-4)
man3/readdir.3 (+21/-6)
man3/realpath.3 (+21/-8)
man3/recno.3 (+4/-2)
man3/regex.3 (+27/-13)
man3/remainder.3 (+6/-4)
man3/remove.3 (+11/-11)
man3/remquo.3 (+8/-3)
man3/resolver.3 (+13/-6)
man3/rewinddir.3 (+6/-4)
man3/rexec.3 (+4/-2)
man3/rint.3 (+6/-4)
man3/round.3 (+6/-4)
man3/rpc.3 (+12/-8)
man3/rpmatch.3 (+5/-3)
man3/rtime.3 (+11/-7)
man3/rtnetlink.3 (+8/-4)
man3/scalb.3 (+8/-6)
man3/scalbln.3 (+5/-3)
man3/scandir.3 (+6/-4)
man3/scandirat.3 (+8/-9)
man3/scanf.3 (+55/-56)
man3/sched_getcpu.3 (+24/-4)
man3/seekdir.3 (+17/-11)
man3/sem_close.3 (+4/-4)
man3/sem_destroy.3 (+4/-4)
man3/sem_getvalue.3 (+4/-4)
man3/sem_init.3 (+4/-4)
man3/sem_open.3 (+4/-4)
man3/sem_post.3 (+4/-4)
man3/sem_unlink.3 (+4/-4)
man3/sem_wait.3 (+4/-4)
man3/setaliasent.3 (+7/-4)
man3/setbuf.3 (+7/-5)
man3/setcontext.3 (+1/-0)
man3/setenv.3 (+8/-6)
man3/setjmp.3 (+8/-7)
man3/setlocale.3 (+7/-5)
man3/setlogmask.3 (+6/-4)
man3/setnetgrent.3 (+10/-5)
man3/shm_open.3 (+9/-9)
man3/siginterrupt.3 (+6/-4)
man3/signbit.3 (+8/-3)
man3/significand.3 (+7/-2)
man3/sigpause.3 (+7/-5)
man3/sigqueue.3 (+6/-4)
man3/sigset.3 (+6/-4)
man3/sigsetops.3 (+7/-5)
man3/sigvec.3 (+5/-3)
man3/sigwait.3 (+4/-2)
man3/sin.3 (+5/-3)
man3/sincos.3 (+7/-4)
man3/sinh.3 (+6/-4)
man3/sleep.3 (+7/-5)
man3/sockatmark.3 (+7/-5)
man3/sqrt.3 (+6/-4)
man3/statvfs.3 (+6/-4)
man3/stdarg.3 (+22/-3)
man3/stdin.3 (+8/-4)
man3/stdio.3 (+7/-5)
man3/stdio_ext.3 (+4/-2)
man3/stpcpy.3 (+8/-7)
man3/stpncpy.3 (+8/-5)
man3/strcasecmp.3 (+8/-6)
man3/strcat.3 (+6/-4)
man3/strchr.3 (+6/-4)
man3/strcmp.3 (+9/-7)
man3/strcoll.3 (+6/-4)
man3/strcpy.3 (+6/-4)
man3/strdup.3 (+8/-6)
man3/strerror.3 (+7/-5)
man3/strfmon.3 (+8/-7)
man3/strfry.3 (+6/-4)
man3/strftime.3 (+10/-8)
man3/string.3 (+4/-2)
man3/strlen.3 (+6/-4)
man3/strnlen.3 (+6/-4)
man3/strpbrk.3 (+6/-4)
man3/strptime.3 (+8/-6)
man3/strsep.3 (+6/-4)
man3/strsignal.3 (+7/-6)
man3/strspn.3 (+6/-4)
man3/strstr.3 (+6/-4)
man3/strtod.3 (+6/-4)
man3/strtoimax.3 (+8/-7)
man3/strtok.3 (+6/-4)
man3/strtol.3 (+11/-8)
man3/strtoul.3 (+6/-4)
man3/strverscmp.3 (+7/-5)
man3/strxfrm.3 (+6/-4)
man3/swab.3 (+6/-4)
man3/sysconf.3 (+14/-12)
man3/syslog.3 (+5/-3)
man3/system.3 (+7/-5)
man3/sysv_signal.3 (+7/-5)
man3/tan.3 (+5/-3)
man3/tanh.3 (+6/-4)
man3/tcgetpgrp.3 (+6/-4)
man3/tcgetsid.3 (+6/-4)
man3/telldir.3 (+23/-5)
man3/tempnam.3 (+6/-4)
man3/termios.3 (+17/-17)
man3/tgamma.3 (+8/-3)
man3/timegm.3 (+5/-3)
man3/timeradd.3 (+4/-2)
man3/tmpfile.3 (+6/-4)
man3/tmpnam.3 (+6/-4)
man3/toascii.3 (+6/-6)
man3/toupper.3 (+7/-5)
man3/towctrans.3 (+6/-4)
man3/towlower.3 (+6/-4)
man3/towupper.3 (+6/-4)
man3/trunc.3 (+6/-4)
man3/tsearch.3 (+6/-5)
man3/ttyname.3 (+10/-9)
man3/ttyslot.3 (+9/-7)
man3/tzset.3 (+5/-3)
man3/ualarm.3 (+16/-8)
man3/ulimit.3 (+6/-6)
man3/undocumented.3 (+5/-9)
man3/ungetwc.3 (+6/-4)
man3/unlocked_stdio.3 (+5/-3)
man3/unlockpt.3 (+6/-5)
man3/updwtmp.3 (+9/-3)
man3/usleep.3 (+6/-4)
man3/wcpcpy.3 (+6/-4)
man3/wcpncpy.3 (+6/-4)
man3/wcrtomb.3 (+7/-5)
man3/wcscasecmp.3 (+6/-4)
man3/wcscat.3 (+6/-4)
man3/wcschr.3 (+6/-4)
man3/wcscmp.3 (+6/-4)
man3/wcscpy.3 (+6/-4)
man3/wcscspn.3 (+6/-4)
man3/wcsdup.3 (+6/-4)
man3/wcslen.3 (+6/-4)
man3/wcsncasecmp.3 (+6/-4)
man3/wcsncat.3 (+6/-4)
man3/wcsncmp.3 (+6/-4)
man3/wcsncpy.3 (+6/-4)
man3/wcsnlen.3 (+7/-5)
man3/wcsnrtombs.3 (+9/-5)
man3/wcspbrk.3 (+6/-4)
man3/wcsrchr.3 (+6/-4)
man3/wcsrtombs.3 (+9/-5)
man3/wcsspn.3 (+6/-4)
man3/wcsstr.3 (+6/-4)
man3/wcstoimax.3 (+7/-6)
man3/wcstok.3 (+6/-4)
man3/wcstombs.3 (+6/-4)
man3/wcswidth.3 (+6/-4)
man3/wctob.3 (+6/-4)
man3/wctomb.3 (+10/-6)
man3/wctrans.3 (+6/-4)
man3/wctype.3 (+6/-4)
man3/wcwidth.3 (+6/-4)
man3/wmemchr.3 (+6/-4)
man3/wmemcmp.3 (+6/-4)
man3/wmemcpy.3 (+6/-4)
man3/wmemmove.3 (+6/-4)
man3/wmemset.3 (+6/-4)
man3/wordexp.3 (+12/-11)
man3/wprintf.3 (+7/-5)
man3/xcrypt.3 (+7/-3)
man3/xdr.3 (+7/-4)
man3/y0.3 (+4/-2)
man4/cciss.4 (+10/-11)
man4/console.4 (+4/-2)
man4/console_codes.4 (+10/-8)
man4/console_ioctl.4 (+8/-7)
man4/cpuid.4 (+4/-2)
man4/dsp56k.4 (+6/-5)
man4/fd.4 (+6/-6)
man4/full.4 (+4/-4)
man4/hd.4 (+6/-5)
man4/hpsa.4 (+10/-9)
man4/initrd.4 (+6/-5)
man4/intro.4 (+7/-6)
man4/lp.4 (+6/-5)
man4/mem.4 (+6/-5)
man4/mouse.4 (+10/-9)
man4/msr.4 (+4/-2)
man4/null.4 (+6/-5)
man4/pts.4 (+5/-3)
man4/ram.4 (+6/-5)
man4/random.4 (+71/-5)
man4/rtc.4 (+10/-9)
man4/sd.4 (+3/-1)
man4/sk98lin.4 (+19/-17)
man4/st.4 (+11/-9)
man4/tty.4 (+7/-6)
man4/ttyS.4 (+6/-5)
man4/tty_ioctl.4 (+24/-21)
man4/vcs.4 (+6/-5)
man4/wavelan.4 (+11/-7)
man5/acct.5 (+5/-4)
man5/charmap.5 (+11/-11)
man5/core.5 (+19/-4)
man5/dir_colors.5 (+7/-6)
man5/elf.5 (+10/-8)
man5/filesystems.5 (+6/-5)
man5/ftpusers.5 (+7/-5)
man5/gai.conf.5 (+103/-0)
man5/group.5 (+6/-5)
man5/host.conf.5 (+7/-7)
man5/hosts.5 (+7/-7)
man5/hosts.equiv.5 (+8/-5)
man5/intro.5 (+7/-6)
man5/issue.5 (+6/-5)
man5/locale.5 (+8/-10)
man5/mailname.5 (+4/-3)
man5/motd.5 (+18/-14)
man5/motd.tail.5 (+0/-66)
man5/networks.5 (+7/-6)
man5/nologin.5 (+6/-5)
man5/nscd.conf.5 (+94/-48)
man5/nss.5 (+119/-0)
man5/nsswitch.conf.5 (+19/-5)
man5/passwd.5 (+6/-5)
man5/proc.5 (+459/-147)
man5/protocols.5 (+6/-5)
man5/resolv.conf.5 (+20/-7)
man5/rpc.5 (+6/-2)
man5/securetty.5 (+8/-7)
man5/services.5 (+6/-6)
man5/shells.5 (+12/-8)
man5/slabinfo.5 (+4/-2)
man5/termcap.5 (+9/-8)
man5/ttytype.5 (+10/-7)
man5/tzfile.5 (+6/-2)
man5/utmp.5 (+10/-8)
man6/intro.6 (+6/-5)
man7/LDP.7 (+18/-18)
man7/aio.7 (+17/-15)
man7/armscii-8.7 (+7/-6)
man7/arp.7 (+8/-5)
man7/ascii.7 (+6/-5)
man7/boot.7 (+15/-13)
man7/bootparam.7 (+37/-28)
man7/capabilities.7 (+76/-18)
man7/charsets.7 (+8/-6)
man7/complex.7 (+5/-2)
man7/cp1251.7 (+7/-5)
man7/cpuset.7 (+77/-76)
man7/credentials.7 (+8/-6)
man7/ddp.7 (+11/-6)
man7/environ.7 (+6/-5)
man7/epoll.7 (+13/-13)
man7/feature_test_macros.7 (+4/-4)
man7/fifo.7 (+7/-4)
man7/futex.7 (+12/-9)
man7/glob.7 (+9/-8)
man7/hier.7 (+7/-5)
man7/hostname.7 (+3/-1)
man7/icmp.7 (+8/-3)
man7/inotify.7 (+16/-13)
man7/intro.7 (+7/-6)
man7/ip.7 (+180/-33)
man7/ipv6.7 (+95/-19)
man7/iso_8859-1.7 (+8/-7)
man7/iso_8859-10.7 (+9/-7)
man7/iso_8859-11.7 (+8/-7)
man7/iso_8859-13.7 (+9/-7)
man7/iso_8859-14.7 (+9/-7)
man7/iso_8859-15.7 (+9/-7)
man7/iso_8859-16.7 (+8/-7)
man7/iso_8859-2.7 (+8/-7)
man7/iso_8859-3.7 (+9/-7)
man7/iso_8859-4.7 (+9/-7)
man7/iso_8859-5.7 (+14/-8)
man7/iso_8859-6.7 (+9/-7)
man7/iso_8859-7.7 (+18/-9)
man7/iso_8859-8.7 (+8/-7)
man7/iso_8859-9.7 (+9/-7)
man7/koi8-r.7 (+18/-9)
man7/koi8-u.7 (+17/-8)
man7/libc.7 (+3/-1)
man7/locale.7 (+5/-3)
man7/mailaddr.7 (+13/-12)
man7/man-pages.7 (+22/-11)
man7/man.7 (+12/-10)
man7/math_error.7 (+6/-4)
man7/mdoc.7 (+4/-2)
man7/mdoc.samples.7 (+4/-2)
man7/missing.7 (+14/-12)
man7/mq_overview.7 (+8/-8)
man7/netdevice.7 (+8/-6)
man7/netlink.7 (+17/-11)
man7/numa.7 (+11/-9)
man7/operator.7 (+3/-1)
man7/packet.7 (+13/-8)
man7/path_resolution.7 (+16/-14)
man7/pipe.7 (+8/-8)
man7/posixoptions.7 (+59/-58)
man7/pthreads.7 (+14/-12)
man7/pty.7 (+8/-8)
man7/raw.7 (+12/-8)
man7/regex.7 (+4/-2)
man7/rtld-audit.7 (+17/-15)
man7/rtnetlink.7 (+21/-8)
man7/sem_overview.7 (+6/-6)
man7/shm_overview.7 (+5/-5)
man7/sigevent.7 (+5/-3)
man7/signal.7 (+18/-16)
man7/socket.7 (+112/-20)
man7/spufs.7 (+9/-8)
man7/standards.7 (+6/-5)
man7/suffixes.7 (+6/-4)
man7/svipc.7 (+25/-7)
man7/symlink.7 (+3/-2)
man7/tcp.7 (+58/-27)
man7/termio.7 (+9/-3)
man7/time.7 (+13/-11)
man7/udp.7 (+11/-7)
man7/udplite.7 (+14/-12)
man7/undocumented.7 (+15/-16)
man7/unicode.7 (+12/-13)
man7/units.7 (+4/-2)
man7/unix.7 (+9/-6)
man7/uri.7 (+10/-9)
man7/utf-8.7 (+8/-9)
man7/x25.7 (+9/-4)
man8/intro.8 (+7/-6)
man8/ld.so.8 (+9/-10)
man8/ldconfig.8 (+7/-7)
man8/nscd.8 (+6/-6)
man8/sln.8 (+71/-0)
man8/sync.8 (+9/-5)
man8/tzselect.8 (+5/-3)
man8/zdump.8 (+23/-6)
man8/zic.8 (+4/-2)
To merge this branch: bzr merge lp:~mfisch/ubuntu/saucy/manpages/update_to_3.51
Reviewer Review Type Date Requested Status
Sebastien Bacher Approve
Review via email: mp+176037@code.launchpad.net

Description of the change

Merge to 3.51.

Ubuntu is holding 2 changes. I spoke with Kees Cook and it is safe to drop one of the two. The other one we should look at upstreaming. I will try to do that in the next few months.

Here is the debian/ only diff: http://paste.ubuntu.com/5896118/

To post a comment you must log in.
Revision history for this message
Martin Pitt (pitti) wrote :

Please note that there is another merge proposal for this: https://code.launchpad.net/~noskcaj/ubuntu/saucy/manpages/merge3.51-1/+merge/174521

Revision history for this message
Jackson Doak (noskcaj) wrote :

I have deleted my proposal since you actually know what you're doing.

Revision history for this message
Sebastien Bacher (seb128) wrote :

thanks

review: Approve

Preview Diff

[H/L] Next/Prev Comment, [J/K] Next/Prev File, [N/P] Next/Prev Hunk
=== modified file 'Changes'
--- Changes 2012-11-16 10:33:14 +0000
+++ Changes 2013-07-21 03:51:25 +0000
@@ -1,6 +1,6 @@
1==================== Changes in man-pages-3.44 ====================1==================== Changes in man-pages-3.51 ====================
22
3Released: 2012-11-07, Barcelona3Released: 2013-04-17, Munich
44
55
6Contributors6Contributors
@@ -10,52 +10,53 @@
10in the changelog below) reports, notes, and ideas that have been10in the changelog below) reports, notes, and ideas that have been
11incorporated in changes in this release:11incorporated in changes in this release:
1212
13Bert Hubert <bert.hubert@netherlabs.nl>13Andreas Jaeger <aj@suse.de>
14Andrew Clayton <andrew@digital-domain.net>
15Brian M. Carlson <sandals@crustytoothpaste.net>
16Changhee Han <ch0.han@lge.com>
17Cyril Hrubis <chrubis@suse.cz>
18Damien Grassart <damien@grassart.com>
14David Prévot <taffit@debian.org>19David Prévot <taffit@debian.org>
15James Youngman <jay@gnu.org>20Denis Barbier <bouzim@gmail.com>
16Kees Cook <keescook@chromium.org>21Jeff Moyer <jmoyer@redhat.com>
17Lars Wirzenius <liw@iki.fi>22Krzysztof Konopko <krzysztof.konopko@gmail.com>
18Lucas De Marchi <lucas.de.marchi@gmail.com>23Kyle McMartin <kyle@mcmartin.ca>
24Mark H Weaver <mhw@netris.org>
19Michael Kerrisk <mtk.manpages@gmail.com>25Michael Kerrisk <mtk.manpages@gmail.com>
20Rusty Russell <rusty@rustcorp.com.au>26Mike Frysinger <vapier@gentoo.org>
27Nicolas Hillegeer <nicolas@hillegeer.com>
28Pavel Emelyanov <xemul@parallels.com>
29Peter Schiffer <pschiffe@redhat.com>
30Radek Pazdera <rpazdera@redhat.com>
31Ralph Loader <suckfish@ihug.co.nz>
21Simon Paillard <spaillard@debian.org>32Simon Paillard <spaillard@debian.org>
22Thomas Habets <thomas@habets.se>33The Wanderer <wanderer@fastmail.fm>
2334
24Apologies if I missed anyone!35Apologies if I missed anyone!
2536
2637
27New and rewritten pages38Newly documented interfaces in existing pages
28-----------------------39---------------------------------------------
2940
30delete_module.241sched_rr_get_interval.2
31 Michael Kerrisk42 Michael Kerrisk
32 Rewrite to Linux 2.6+ reality43 Document /proc/sys/kernel/sched_rr_timeslice_ms
33 Michael Kerrisk44
34 Change license and copyright45proc.5
35 There is now nothing left of the original FSF-copyrighted46 Pavel Emelyanov
36 page. So, change the copyright and license.47 Document /proc/[pid]/map_files directory
37 Michael Kerrisk [Lucas De Marchi, Rusty Russell]48 This directory was added in Linux v3.3 and provides info about
38 Substantial reorganization after comments from Rusty Russell49 files being mmap-ed in a way very similar to how /proc/[pid]/fd
39 Rusty notes that O_NONBLOCK is almost always used in50 works.
40 practice. Therefore, it would be better to reorganize51
41 the page to consider that "the default".52 v2: Added examples of how links look like and noted dependency
4253 on kernel config option CONFIG_CHECKPOINT_RESTORE.
43init_module.254 Michael Kerrisk
44 Michael Kerrisk55 Document /proc/sys/kernel/shm_rmid_forced
45 Rewrite to Linux 2.6+ reality56
46 Michael Kerrisk57capabilities.7
47 Change copyright and license58 Michael Kerrisk
48 Little of the original page now remains. Change59 Document /proc/sys/kernel/cap_last_cap
49 copyright and license
50 Michael Kerrisk [Rusty Russell]
51 Changes after review comments from Rusty Russell
52 Kees Cook
53 Add various pieces describing Linux 2.6+ behavior
54 Pieces take from, or inspired by, a patch sent by Kees.
55
56getauxval.3
57 Michael Kerrisk
58 Document getauxval() function added in glibc 2.16
5960
6061
61Global changes62Global changes
@@ -63,158 +64,269 @@
6364
64Various pages65Various pages
65 Michael Kerrisk66 Michael Kerrisk
66 Global fix: Use consistent capitalization in NAME section67 Global fix: fix placement of word "only"
67 The line(s) in the NAME section should only use capitals68
68 where English usage dictates that. Otherwise, use69Various pages
69 lowercase throughout.70 Simon Paillard
7071 License headers: consistent format
71Various pages72
72 Michael Kerrisk73Various pages
73 Global fix: "userspace" ==> "user space" or "user-space"74 Michael Kerrisk
74 Existing pages variously use "userspace or "user space".75 Global fix: s/since kernel/since Linux/
75 But, "userspace" is not quite an English word.76
76 So change "userspace" to "user space" or, when used77Various System V IPC pages in Section 2
77 attributively, "user-space".78 Michael Kerrisk
79 Add "System V" to .TH line and text
80 Make it clear that these pages relate to System V IPC,
81 not POSIX IPC.
7882
7983
80Changes to individual pages84Changes to individual pages
81---------------------------85---------------------------
8286
83clock_getres.287access.2
84clock_nanosleep.288 Michael Kerrisk [The Wanderer]
85 Michael Kerrisk89 Clarify RETURN VALUE for F_OK
86 Linking with -lrt is no longer needed from glibc 2.17 onward90 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=705293
8791
88create_module.292alarm.2
89 Michael Kerrisk93 Michael Kerrisk
90 Note that this system call is present only in kernels before 2.694 Correct the description of behavior when 'seconds' is 0
91 Michael Kerrisk95
92 Note that ENOSYS probably indicates kernel 2.6+96clone.2
9397 Michael Kerrisk [Peter Schiffer]
94execve.298 Add prototype for syscall to SYNOPSIS
95 Michael Kerrisk99 And further clarify the distinction between the system call
96 Document treatment of PR_SET_PDEATHSIG on execve()100 and the wrapper function in the introductory text.
97 Michael Kerrisk101 Michael Kerrisk
98 Document treatment of SECBIT_KEEP_CAPS securebits flag on execve()102 Update feature test macro requirements
99103 The requirements quietly changed changed in glibc 2.14
100fork.2104
101 Michael Kerrisk105 See also http://www.sourceware.org/bugzilla/show_bug.cgi?id=4749
102 Note treatment of default timer slack value on fork()106 Michael Kerrisk [Mike Frysinger]
103107 Clarify differences between clone2() syscall and wrapper function
104getdomainname.2108 Michael Kerrisk [Mike Frysinger]
105 Simon Paillard [Lars Wirzenius]109 Note those architectures where the sys_clone argument order differs
106 Point out that these calls relate to NIS, not DNS110 Michael Kerrisk [Mike Frysinger]
107 See http://bugs.debian.org/295635111 Add short subsection noting that blackfin, m68k, and sparc are different
108112 Michael Kerrisk
109get_kernel_syms.2113 Move clone2() text to subsection in description
110 Michael Kerrisk114 The description of ia64 clone2() should follow the discussion
111 Note that this system call is present only in kernels before 2.6115 of the raw system call interface.
112116 Michael Kerrisk
113ipc.2117 Change subhead for ia64 discussion
114 Michael Kerrisk118
115 Update note on architectures that don't have ipc()119getcpu.2
116 Replace mention of ia64 with x86-64 and ARM.120 Michael Kerrisk
117121 Recommend that 'tcache' should be specified as NULL nowadays
118link.2122
119 Michael Kerrisk123io_cancel.2
120 Add EPERM error triggered by /proc/sys/fs/protected_hardlink124 Jeff Moyer, Michael Kerrisk [Cyril Hrubis]
121125 Improve description
122prctl.2126
123 Michael Kerrisk127io_destroy.2
124 Mention Documentation/prctl/no_new_privs.txt for PR_SET_NO_NEW_PRIVS128 Jeff Moyer
125 Kees Cook129 Improve description
126 update seccomp sections for mode 2 (BPF)130 The description was rather vague, citing a "list of I/O contexts"
127 This adds a short summary of the arguments used131 and stating that it "can" cancel outstanding requests. This
128 for "mode 2" (BPF) seccomp.132 update makes things more concrete so that the reader knows exactly
129 Michael Kerrisk133 what's going on.
130 Small improvements to PR_SET_SECCOMP discussion134
131 Note type of 'arg3' for SECCOMP_MODE_FILTER.135io_getevents.2
132 Add pointer to Documentation/prctl/seccomp_filter.txt.136 Jeff Moyer
133 Michael Kerrisk137 The 'timeout' argument is not updated
134 Note 'seccomp' semantics with respect to fork(), execve(), and prctl()138 I looked back through the kernel code, and the timeout was
135 Michael Kerrisk139 never updated in any case. I've submitted a patch upstream
136 Document PR_SET_TIMERSLACK and PR_GET_TIMERSLACK140 to change the comment above io_getevents.
137 Michael Kerrisk141
138 Reword PR_SET_NAME and PR_GET_NAME in terms of threads142io_setup.2
139 Plus tfix143 Jeff Moyer
140 Kees Cook144 Clarify nr_events
141 document PR_SET_NO_NEW_PRIVS, PR_GET_NO_NEW_PRIVS145 nr_events is technically the number of completion events that can
142 This adds a short description of the no_new_privs bit,146 be stored in the completion ring. The wording of the man page:
143 as described in Documentation/prctl/no_new_privs.txt.147 "capable of receiving at least nr_events" seems dubious to me,
144148 only because I worry that folks might interpret that to mean
145ptrace.2149 'nr_events' total, instead of 'nr_events' concurrently.
146 Michael Kerrisk150
147 Clarify that some operations are not present on all architectures151 Further, I've added information on where to find the per-user
148 PTRACE_GETREGS, PTRACE_SETGREFS, PTRACE_GETFPREGS,152 limit on 'nr_events', /proc/sys/fs/aio-max-nr. Let me know if
149 and PTRACE_GETSPREGS are not present on all architectures.153 you think that is not relevant.
150 PTRACE_SYSEMU and PTRACE_SYSEMU_SINGLESTEP are present only154
151 on x86.155listxattr.2
152156 Michael Kerrisk
153 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=122383157 Explain use of 'size' argument
154158
155query_module.2159lseek.2
156 Michael Kerrisk160 Michael Kerrisk [Andreas Jaeger]
157 Add a few words clarifying reference to /sys/module161 _GNU_SOURCE must be defined to get SEEK_DATE and SEEK_HOLE definitions
158 Michael Kerrisk162 See http://sourceware.org/bugzilla/show_bug.cgi?id=15312
159 Note that this system call is present only in kernels before 2.6163
160 Michael Kerrisk164mmap.2
161 Note that ENOSYS probably indicates kernel 2.6+165 Michael Kerrisk
162 Michael Kerrisk166 Add pointers to relevant /proc files described in proc(5)
163 SEE ALSO: Add modinfo(8) and lsinfo(8)167
164 Michael Kerrisk168posix_fadvise.2
165 Move some information in NOTES to VERSIONS169pread.2
166170readahead.2
167socketcall.2171sync_file_range.2
168 Michael Kerrisk172truncate.2
169 Update note on architectures that don't have socketcall()173 Michael Kerrisk
170 Replace mention of ia64 with x86-64 and ARM.174 Refer to syscall(2) for ABI semantics on certain 32-bit architectures
171175 Also: in sync_file_range.2 and posix_fadvise.2 remove description
172times.2176 of conventional calling signature as flawed, and in
173 Thomas Habets177 posix_fadvise.2, de-emphasize focus on ARM, and rather phrase
174 Recommend clock_gettime(2) as alternative to times(2)178 as a more general discussion of certain architectures.
175179
176clock_getcpuclockid.3180readdir.2
177 Michael Kerrisk181 Michael Kerrisk
178 Linking with -lrt is no longer needed from glibc 2.17 onward182 readdir(2) doesn't exist on x86-64
179183
180fts.3184semop.2
181 Simon Paillard [James Youngman]185 Michael Kerrisk
182 Improve description of physical vs. logical tree walking186 Clarify the discussion of 'semadj'
183 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=633505187
184188shmctl.2
185getenv.3189 Michael Kerrisk
186 Michael Kerrisk190 Refer to proc(5) for description of /proc/sys/kernel/shm_rmid_forced
187 SEE ALSO: add getauxval(3)191
192syscall.2
193 Changhee Han
194 Add notes that caution users when passing arguments to syscall()
195 For example, passing 'long long' on ARM-32 requires special
196 treatment.
197 Mike Frysinger [Michael Kerrisk]
198 Document the exact calling convention for architecture system calls
199 Mike Frysinger [Kyle McMartin]
200 Add PA-RISC details under calling conventions
201 Michael Kerrisk [Mike Frysinger]
202 Refine discussion of ARM and other ABIs
203
204syscalls.2
205 Michael Kerrisk
206 Update kernel version number at start of list
207
208umask.2
209 Michael Kerrisk
210 SEE ALSO: add acl(5)
211
212unshare.2
213 Michael Kerrisk
214 Update feature test macro requirements
215 The requirements quietly changed changed in glibc 2.14
216
217 See also http://www.sourceware.org/bugzilla/show_bug.cgi?id=4749
218
219fopencookie.3
220 Michael Kerrisk [Ralph Loader]
221 Correct definition of cookie_io_functions_t
222
223pthread_setname_np.3
224 Andrew Clayton
225 The thread argument is passed in by value
226
227readir.3
228seekdir.3
229telldir.3
230 Michael Kerrisk
231 Eliminate the implication that these functions deal with "offsets"
232 The directory position dealt with by the readdir() and
233 friends is not a simple file offset in modern file systems.
234 Typically, it is some kind of cookie value. Add text and
235 make other changes to these pages to eliminate the
236 implication that this is an offset, and warn the reader
237 that directory positions should be treated strictly as
238 opaque values.
239
240 In the process, rename the 'offset' argument of seekdir(3)
241 to 'loc', and add some text to readdir(3) to note that
242 the 'd_off' field is the same value returned by telldir(3)
243 at the current directory position.
244
245 See also https://lwn.net/Articles/544298/
246
247scalb.3
248 Mark H Weaver
249 Fix prototypes for scalbf() and scalbl()
250
251sched_getcpu.3
252 Michael Kerrisk
253 Update feature test macro requirements
254 The requirements quietly changed changed in glibc 2.14
255
256 See also http://www.sourceware.org/bugzilla/show_bug.cgi?id=4749
257
258ualarm.3
259 Michael Kerrisk [Nicolas Hillegeer]
260 Add note on the behavior when 'usecs' is zero
261 POSIX.1-2001 does not specify the behavior in this case
262 and no other system that I checked documented the behavior.
263 Probably, most or all systems do what Linux does in this
264 case: cancel any pending alarm, just as alarm(0) does.
265 Add that info in NOTES.
266
267elf.5
268 Mike Frysinger
269 Add byte positions for all EI_xxx fields
270 When describing e_ident, most of the EI_xxx defines mention the
271 exact byte number. This is useful when manually hacking an ELF
272 with a hex editor. However, the last few fields don't do this,
273 which means you have to count things up yourself.
274 Add a single word to each so you don't have to do that.
188275
189proc.5276proc.5
190 Michael Kerrisk277 Michael Kerrisk
191 Document /proc/meminfo278 Refer to sched_rr_get_interval(2) for info on sched_rr_timeslice_ms
192 Info mostly taken from Documentation/filesystems/proc.txt279 Since Linux 3.9, /proc/sys/kernel/sched_rr_timeslice_ms can
193 and Documentation/vm/hugetlbpage.txt.280 be used to change the SCHED_RR quantum.
194 Michael Kerrisk281 Michael Kerrisk
195 Default for /proc/sys/fs/protected_{hardlinks,symlinks} is now 0282 SEE ALSO: Add sysctl(8)
196 The default setting of 1 in/proc/sys/fs/protected_hardlinks283 Krzysztof Konopko
197 and /proc/sys/fs/protected_symlinks caused one too many284 Simplify the example of printing out environ
198 breakages for Linus's taste, so commit 561ec64ae67e changed285 The binutils package contains a very handy utility to
199 the default for both files to 0.286 print out null-byte delimited strings from a file. This
200 Note system call error yielded by /proc/sys/fs/protected_symlinks287 can replace a rather complex expression with cat(1)
201 Note that violating 'protected_symlinks' restrictions288 provided as an example for printing out /proc/[pid]/environ.
202 causes system calls to fail with the error EACCES.289 Michael Kerrisk
203 Michael Kerrisk290 Update /proc/PID/maps example
204 Since Linux 2.6.27, /proc/sys/kernel/modprobe depends on CONFIG_MODULES291 Update to 64-bit example that includes "[heap]", "[stack],
205292 and "[vdso]"
206ipv6.7293 Michael Kerrisk
207 Bert Hubert294 Formatting fixes for /proc/PID/maps
208 Document IPV6_RECVPKTINFO295 Mike Frysinger
209296 Document the "pathname" field of /proc/PID/maps
210man-pages.7297 Michael Kerrisk
211 Michael Kerrisk298 Add reference to capabilities(7) for /proc/sys/kernel/cap_last_cap
212 Note rules for capitalization in NAME section299 Michael Kerrisk
213300 /proc/PID/maps: add a reference to mmap(2)
214time.7301
215 Michael Kerrisk302ip.7
216 Add a subsection on timer slack303 Radek Pazdera
217304 Document IP_MULTICAST_ALL
218ld.so.8305 This commit adds documentation for the IP_MULTICAST_ALL socket
219 Michael Kerrisk306 option.
220 SEE ALSO: add getauxval(3)307
308 The option was added to the Linux kernel in 2.6.31:
309
310 Author Nivedita Singhvi <niv@us.ibm.com>
311 Commit f771bef98004d9d141b085d987a77d06669d4f4f
312
313 The description is based on a previous one [3] posted by the
314 original author of the code -- Nivedita, but it is slightly
315 re-worded.
316
317 I tested it myself and it works as described.
318
319 References:
320 [1] http://lxr.free-electrons.com/source/net/ipv4/ip_sockglue.c#L972
321 [2] http://lxr.free-electrons.com/source/net/ipv4/igmp.c#L2267
322 [3] http://patchwork.ozlabs.org/patch/28902/
323
324units.7
325 Brian M. Carlson
326 units should use an actual µ
327 The units(7) man page uses an ASCII u in place of the actual Greek
328 letter mu. Since we're in the twenty-first century, with
329 UTF-8-compatible terminals and terminal emulators, we should use
330 the actual letter µ instead of an ASCII approximation.
331
332 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=704787
221333
=== modified file 'Changes.old'
--- Changes.old 2012-11-16 10:33:14 +0000
+++ Changes.old 2013-07-21 03:51:25 +0000
@@ -24731,3 +24731,1594 @@
24731 Michael Kerrisk24731 Michael Kerrisk
24732 Add some details for LD_PRELOAD24732 Add some details for LD_PRELOAD
24733 Note that LD_PRELOAD list separator can be space or colon24733 Note that LD_PRELOAD list separator can be space or colon
24734
24735
24736==================== Changes in man-pages-3.44 ====================
24737
24738Released: 2012-11-07, Barcelona
24739
24740
24741Contributors
24742------------
24743
24744The following people contributed patches/fixes or (noted in brackets
24745in the changelog below) reports, notes, and ideas that have been
24746incorporated in changes in this release:
24747
24748Bert Hubert <bert.hubert@netherlabs.nl>
24749David Prévot <taffit@debian.org>
24750James Youngman <jay@gnu.org>
24751Kees Cook <keescook@chromium.org>
24752Lars Wirzenius <liw@iki.fi>
24753Lucas De Marchi <lucas.de.marchi@gmail.com>
24754Michael Kerrisk <mtk.manpages@gmail.com>
24755Rusty Russell <rusty@rustcorp.com.au>
24756Simon Paillard <spaillard@debian.org>
24757Thomas Habets <thomas@habets.se>
24758
24759Apologies if I missed anyone!
24760
24761
24762New and rewritten pages
24763-----------------------
24764
24765delete_module.2
24766 Michael Kerrisk
24767 Rewrite to Linux 2.6+ reality
24768 Michael Kerrisk
24769 Change license and copyright
24770 There is now nothing left of the original FSF-copyrighted
24771 page. So, change the copyright and license.
24772 Michael Kerrisk [Lucas De Marchi, Rusty Russell]
24773 Substantial reorganization after comments from Rusty Russell
24774 Rusty notes that O_NONBLOCK is almost always used in
24775 practice. Therefore, it would be better to reorganize
24776 the page to consider that "the default".
24777
24778init_module.2
24779 Michael Kerrisk
24780 Rewrite to Linux 2.6+ reality
24781 Michael Kerrisk
24782 Change copyright and license
24783 Little of the original page now remains. Change
24784 copyright and license
24785 Michael Kerrisk [Rusty Russell]
24786 Changes after review comments from Rusty Russell
24787 Kees Cook
24788 Add various pieces describing Linux 2.6+ behavior
24789 Pieces take from, or inspired by, a patch sent by Kees.
24790
24791getauxval.3
24792 Michael Kerrisk
24793 Document getauxval() function added in glibc 2.16
24794
24795
24796Global changes
24797--------------
24798
24799Various pages
24800 Michael Kerrisk
24801 Global fix: Use consistent capitalization in NAME section
24802 The line(s) in the NAME section should only use capitals
24803 where English usage dictates that. Otherwise, use
24804 lowercase throughout.
24805
24806Various pages
24807 Michael Kerrisk
24808 Global fix: "userspace" ==> "user space" or "user-space"
24809 Existing pages variously use "userspace or "user space".
24810 But, "userspace" is not quite an English word.
24811 So change "userspace" to "user space" or, when used
24812 attributively, "user-space".
24813
24814
24815Changes to individual pages
24816---------------------------
24817
24818clock_getres.2
24819clock_nanosleep.2
24820 Michael Kerrisk
24821 Linking with -lrt is no longer needed from glibc 2.17 onward
24822
24823create_module.2
24824 Michael Kerrisk
24825 Note that this system call is present only in kernels before 2.6
24826 Michael Kerrisk
24827 Note that ENOSYS probably indicates kernel 2.6+
24828
24829execve.2
24830 Michael Kerrisk
24831 Document treatment of PR_SET_PDEATHSIG on execve()
24832 Michael Kerrisk
24833 Document treatment of SECBIT_KEEP_CAPS securebits flag on execve()
24834
24835fork.2
24836 Michael Kerrisk
24837 Note treatment of default timer slack value on fork()
24838
24839getdomainname.2
24840 Simon Paillard [Lars Wirzenius]
24841 Point out that these calls relate to NIS, not DNS
24842 See http://bugs.debian.org/295635
24843
24844get_kernel_syms.2
24845 Michael Kerrisk
24846 Note that this system call is present only in kernels before 2.6
24847
24848ipc.2
24849 Michael Kerrisk
24850 Update note on architectures that don't have ipc()
24851 Replace mention of ia64 with x86-64 and ARM.
24852
24853link.2
24854 Michael Kerrisk
24855 Add EPERM error triggered by /proc/sys/fs/protected_hardlink
24856
24857prctl.2
24858 Michael Kerrisk
24859 Mention Documentation/prctl/no_new_privs.txt for PR_SET_NO_NEW_PRIVS
24860 Kees Cook
24861 update seccomp sections for mode 2 (BPF)
24862 This adds a short summary of the arguments used
24863 for "mode 2" (BPF) seccomp.
24864 Michael Kerrisk
24865 Small improvements to PR_SET_SECCOMP discussion
24866 Note type of 'arg3' for SECCOMP_MODE_FILTER.
24867 Add pointer to Documentation/prctl/seccomp_filter.txt.
24868 Michael Kerrisk
24869 Note 'seccomp' semantics with respect to fork(), execve(), and prctl()
24870 Michael Kerrisk
24871 Document PR_SET_TIMERSLACK and PR_GET_TIMERSLACK
24872 Michael Kerrisk
24873 Reword PR_SET_NAME and PR_GET_NAME in terms of threads
24874 Plus tfix
24875 Kees Cook
24876 document PR_SET_NO_NEW_PRIVS, PR_GET_NO_NEW_PRIVS
24877 This adds a short description of the no_new_privs bit,
24878 as described in Documentation/prctl/no_new_privs.txt.
24879
24880ptrace.2
24881 Michael Kerrisk
24882 Clarify that some operations are not present on all architectures
24883 PTRACE_GETREGS, PTRACE_SETGREFS, PTRACE_GETFPREGS,
24884 and PTRACE_GETSPREGS are not present on all architectures.
24885 PTRACE_SYSEMU and PTRACE_SYSEMU_SINGLESTEP are present only
24886 on x86.
24887
24888 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=122383
24889
24890query_module.2
24891 Michael Kerrisk
24892 Add a few words clarifying reference to /sys/module
24893 Michael Kerrisk
24894 Note that this system call is present only in kernels before 2.6
24895 Michael Kerrisk
24896 Note that ENOSYS probably indicates kernel 2.6+
24897 Michael Kerrisk
24898 SEE ALSO: Add modinfo(8) and lsinfo(8)
24899 Michael Kerrisk
24900 Move some information in NOTES to VERSIONS
24901
24902socketcall.2
24903 Michael Kerrisk
24904 Update note on architectures that don't have socketcall()
24905 Replace mention of ia64 with x86-64 and ARM.
24906
24907times.2
24908 Thomas Habets
24909 Recommend clock_gettime(2) as alternative to times(2)
24910
24911clock_getcpuclockid.3
24912 Michael Kerrisk
24913 Linking with -lrt is no longer needed from glibc 2.17 onward
24914
24915fts.3
24916 Simon Paillard [James Youngman]
24917 Improve description of physical vs. logical tree walking
24918 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=633505
24919
24920getenv.3
24921 Michael Kerrisk
24922 SEE ALSO: add getauxval(3)
24923
24924proc.5
24925 Michael Kerrisk
24926 Document /proc/meminfo
24927 Info mostly taken from Documentation/filesystems/proc.txt
24928 and Documentation/vm/hugetlbpage.txt.
24929 Michael Kerrisk
24930 Default for /proc/sys/fs/protected_{hardlinks,symlinks} is now 0
24931 The default setting of 1 in/proc/sys/fs/protected_hardlinks
24932 and /proc/sys/fs/protected_symlinks caused one too many
24933 breakages for Linus's taste, so commit 561ec64ae67e changed
24934 the default for both files to 0.
24935 Note system call error yielded by /proc/sys/fs/protected_symlinks
24936 Note that violating 'protected_symlinks' restrictions
24937 causes system calls to fail with the error EACCES.
24938 Michael Kerrisk
24939 Since Linux 2.6.27, /proc/sys/kernel/modprobe depends on CONFIG_MODULES
24940
24941ipv6.7
24942 Bert Hubert
24943 Document IPV6_RECVPKTINFO
24944
24945man-pages.7
24946 Michael Kerrisk
24947 Note rules for capitalization in NAME section
24948
24949time.7
24950 Michael Kerrisk
24951 Add a subsection on timer slack
24952
24953ld.so.8
24954 Michael Kerrisk
24955 SEE ALSO: add getauxval(3)
24956
24957
24958==================== Changes in man-pages-3.45 ====================
24959
24960Released: 2012-12-21, Christchurch
24961
24962
24963Contributors
24964------------
24965
24966The following people contributed patches/fixes or (noted in brackets
24967in the changelog below) reports, notes, and ideas that have been
24968incorporated in changes in this release:
24969
24970Andi Kleen <andi@firstfloor.org>
24971Cyril Hrubis <chrubis@suse.cz>
24972David Prévot <taffit@debian.org>
24973Elie De Brauwer <eliedebrauwer@gmail.com>
24974Eric Dumazet <eric.dumazet@gmail.com>
24975Felipe Pena <felipensp@gmail.com>
24976Florian Weimer <fweimer@redhat.com>
24977Gao Feng <gaofeng@cn.fujitsu.com>
24978Jan Glauber <jang@linux.vnet.ibm.com>
24979Jim Paris <jim@jtan.com>
24980Jon Grant <jg@jguk.org>
24981Julien Cristau <jcristau@debian.org>
24982Michael Kerrisk <mtk.manpages@gmail.com>
24983Mike Frysinger <vapier@gentoo.org>
24984Rens van der Heijden <rens.vanderheijden@uni-ulm.de>
24985Simon Paillard <spaillard@debian.org>
24986Thierry Vignaud <thierry.vignaud@gmail.com>
24987Trevor Woerner <twoerner@gmail.com>
24988YOSHIFUJI Hideaki <yoshfuji@linux-ipv6.org>
24989
24990Apologies if I missed anyone!
24991
24992
24993New and rewritten pages
24994-----------------------
24995
24996s390_runtime_instr.2
24997 Jan Glauber
24998 New page for s390-specific s390_runtime_instr(2)
24999
25000if_nameindex.3
25001 YOSHIFUJI Hideaki
25002 Document if_nameindex(3) and if_freenameindex(3)
25003 Michael Kerrisk
25004 Edits, improvements and corrections to Hideaki's page
25005 Michael Kerrisk
25006 Add an example program
25007
25008if_nametoindex.3
25009 YOSHIFUJI Hideaki
25010 New page documenting if_nametoindex(3) and if_indextoname(3)
25011
25012
25013New and changed links
25014---------------------
25015
25016if_freenameindex.3
25017 Michael Kerrisk
25018 New link to if_nameindex.3
25019
25020if_indextoname.3
25021 Michael Kerrisk
25022 New link to if_nametoindex.3
25023
25024
25025Global changes
25026--------------
25027
25028sysconf.3
25029cciss.4
25030 Michael Kerrisk
25031 Global fix: s/runtime/run time/
25032
25033
25034Changes to individual pages
25035---------------------------
25036
25037clone.2
25038 Michael Kerrisk
25039 Since 2.6.30, CLONE_NEWIPC also supports POSIX message queues
25040
25041delete_module.2
25042 Michael Kerrisk
25043 Small rewording of description of effect of O_TRUNC
25044
25045getrlimit.2
25046 Michael Kerrisk [Trevor Woerner]
25047 Document Linux's nonstandard treatment or RLIMIT_CPU soft limit
25048 Upon encountering the RLIMIT_CPU soft limit when a SIGXCPU handler
25049 has been installed, Linux invokes the signal handler *and* raises
25050 the soft limit by one second. This behavior repeats until the
25051 limit is encountered. No other implementation that I tested
25052 (Solaris 10, FreeBSD 9.0, OpenBSD 5.0) does this, and it seems
25053 unlikely to be POSIX-conformant. The (Linux-specific)
25054 RLIMIT_RTTIME soft limit exhibits similar behavior.
25055 Michael Kerrisk
25056 Point reader at discussion of /proc/[pid]/limits in proc(5)
25057
25058io_getevents.2
25059 Michael Kerrisk
25060 io_getevents() may cause segfault when called with invalid ctx_id
25061 For reference see: http://marc.info/?l=linux-aio&m=130089887002435&w=2
25062
25063recv.2
25064 Michael Kerrisk [Eric Dumazet]
25065 UNIX domain sockets support MSG_TRUNC since 3.4
25066
25067sendmmsg.2
25068 Elie De Brauwer
25069 Add example program for sendmmsg()
25070
25071stat.2
25072 Simon Paillard
25073 Clarify description of EOVERFLOW error
25074 The EOVERFLOW error is not only for st_size, but also
25075 inode and block size fields. See glibc source file
25076 sysdeps/unix/sysv/linux/xstatconv.c and kernel source
25077 file fs/stat.c. Also, fix bit/byte confusion
25078 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=604928
25079
25080syscalls.2
25081 Michael Kerrisk
25082 Update various references to "i386" to "x86"
25083 Michael Kerrisk
25084 Add s390_runtime_instr(2)
25085
25086sysctl.2
25087 Michael Kerrisk
25088 Mention CONFIG_SYSCTL_SYSCALL
25089 Michael Kerrisk
25090 Calls to sysctl() log warnings to the kernel log since 2.6.24
25091
25092syslog.2
25093 Michael Kerrisk
25094 Substantially reorganize discussion of commands
25095 Make the layout of the discussion of the commands
25096 more readable.
25097 Michael Kerrisk
25098 Add kernel symbolic 'type' names
25099 Michael Kerrisk
25100 Clarify SYSLOG_ACTION_SIZE_UNREAD semantics
25101 SYSLOG_ACTION_SIZE_UNREAD returns the number of bytes
25102 available for reading via SYSLOG_ACTION_READ.
25103 Michael Kerrisk
25104 Clarify where SYSLOG_ACTION_READ_ALL places data it reads
25105 Michael Kerrisk
25106 Clarify semantics of SYSLOG_ACTION_CLEAR
25107 The SYSLOG_ACTION_CLEAR command (5) does not really clear
25108 the ring buffer; rather it affects the semantics of what
25109 is returned by commands 3 (SYSLOG_ACTION_READ_ALL) and
25110 4 (SYSLOG_ACTION_READ_CLEAR).
25111 Michael Kerrisk
25112 Clarify discussion of privileges for commands 3 and 10
25113 Michael Kerrisk
25114 Add mention of CONFIG_LOG_BUF_SHIFT
25115
25116wait.2
25117 Michael Kerrisk
25118 BUGS: Document odd waitid() behavior when 'infop' is NULL
25119
25120getifaddrs.3
25121 Michael Kerrisk [Julien Cristau]
25122 Update description of ifa_data to Linux 2.6+ reality
25123 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=526778
25124
25125memcmp.3
25126 Michael Kerrisk [Jon Grant]
25127 Enhance RETURN VALUE text and remove redundant text from DESCRIPTION
25128 Note that sign of result equals sign of difference between
25129 first two bytes that differ (treated as "unsigned char")."
25130
25131mkstemp.3
25132 Michael Kerrisk [Florian Weimer]
25133 Deemphasize discussion of mode 066 in glibc 2.0.6
25134 Glibc 2.0.6 is now so ld that the discussion of details
25135 of that version can be deemphasized placing just under
25136 NOTES.
25137
25138 See https://bugzilla.kernel.org/show_bug.cgi?id=51811
25139
25140strcmp.3
25141 Michael Kerrisk [Jon Grant]
25142 Enhance RETURN VALUE text and remove redundant text from DESCRIPTION
25143 Note that sign of result equals sign of difference between
25144 first two bytes that differ (treated as "unsigned char")."
25145
25146ttyname.3
25147 Michael Kerrisk
25148 Fix confused text in ERRORS
25149 The existing text suggested that the ERRORS applied
25150 only for ttyname_r(). However, 2 of the 3 errors
25151 can occur for ttyname().
25152
25153undocumented.3
25154 Michael Kerrisk
25155 Remove some now documented functions
25156
25157proc.5
25158 Michael Kerrisk [Jim Paris]
25159 Correct description of SwapFree in /proc/meminfo
25160 Michael Kerrisk
25161 Note change of /proc/[pid]/limits file permissions in 2.6.36
25162
25163resolv.conf.5
25164 Simon Paillard
25165 Document IPv6 format for nameserver
25166 See: http://bugs.debian.org/610036
25167
25168capabilities.7
25169 Michael Kerrisk [Rens van der Heijden]
25170 Correct URL for POSIX.1e draft
25171
25172ipv6.7
25173 Gao Feng
25174 Add description of getsockopt() for IPV6_MTU
25175 In IPv4,IP_MTU is only supported by getsockopt.
25176 In IPv6, we can use IPV6_MTU to set socket's MTU,
25177 but the return value of getsockopt() is the path MTU.
25178
25179rtnetlink.7
25180 Michael Kerrisk [Julien Cristau]
25181 Update description of IFLA_STATS to Linux 2.6+ reality
25182 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=526778
25183
25184socket.7
25185 Michael Kerrisk [YOSHIFUJI Hideaki]
25186 Document 'sockaddr' and 'sockaddr_storage' types
25187 Andi Kleen
25188 Explain effect of SO_SNDTIMEO for connect()
25189 When SO_SNDTIMEO is set before connect(), then connect()
25190 may return EWOULDBLOCK when the timeout fires.
25191
25192
25193==================== Changes in man-pages-3.46 ====================
25194
25195Released: 2013-01-27, Canberra
25196
25197
25198Contributors
25199------------
25200
25201The following people contributed patches/fixes or (noted in brackets
25202in the changelog below) reports, notes, and ideas that have been
25203incorporated in changes in this release:
25204
25205Andrew Perepechko <andrew_perepechko@xyratex.com>
25206Cédric Boutillier <cedric.boutillier@gmail.com>
25207Cyrill Gorcunov <gorcunov@openvz.org>
25208Daan Spitz <daan.f.spitz@gmail.com>
25209David Prévot <taffit@debian.org>
25210Elie De Brauwer <eliedebrauwer@gmail.com>
25211Garrett Cooper <yanegomi@gmail.com>
25212James Noble <James.Noble@daktronics.com>
25213Justin Lebar <justin.lebar@gmail.com>
25214Kees Cook <keescook@chromium.org>
25215Lucas De Marchi <lucas.demarchi@profusion.mobi>
25216Mark Hills <mark@pogo.org.uk>
25217Maxin B. John <maxin.john@gmail.com>
25218Michael Kerrisk <mtk.manpages@gmail.com>
25219Michal Gorny <mgorny@gentoo.org>
25220Peter Budny <bigpeteb@gmail.com>
25221Peter Lekeynstein <lekensteyn@gmail.com>
25222Rusty Russell <rusty@rustcorp.com.au>
25223Samuel Thibault <sthibault@debian.org>
25224Sam Varshavchik <mrsam@courier-mta.com>
25225Shawn Landden <shawnlandden@gmail.com>
25226Simon Paillard <spaillard@debian.org>
25227Starlight <starlight.2013q1@binnacle.cx>
25228Theodore Ts'o <tytso@mit.edu>
25229Wolfgang Rohdewald <wolfgang@rohdewald.de>
25230Zsbán Ambrus <ambrus@math.bme.hu>
25231
25232Apologies if I missed anyone!
25233
25234
25235New and rewritten pages
25236-----------------------
25237
25238kcmp.2
25239 Cyrill Gorcunov, Michael Kerrisk
25240 New page for kcmp(2)
25241
25242
25243Newly documented interfaces in existing pages
25244---------------------------------------------
25245
25246init_module.2
25247 Michael Kerrisk [Kees Cook, Rusty Russell, Lucas De Marchi]
25248 Document finit_module(2)
25249 Rusty Russell [Lucas De Marchi, Kees Cook]
25250 Document finit_module() 'flags' argument
25251 Document MODULE_INIT_IGNORE_MODVERSIONS and
25252 MODULE_INIT_IGNORE_VERMAGIC. (Some edits by mtk.)
25253
25254
25255New and changed links
25256---------------------
25257
25258finit_module.2
25259 Michael Kerrisk
25260 New link to init_module.2
25261
25262__after_morecore_hook.3
25263__free_hook.3
25264__malloc_initialize_hook.3
25265__memalign_hook.3
25266__realloc_hook.3
25267 Michael Kerrisk
25268 New link to malloc_hook.3
25269
25270
25271Global changes
25272--------------
25273
25274Various pages
25275 Michael Kerrisk
25276 Global fix: s/tty/terminal/
25277
25278
25279Changes to individual pages
25280---------------------------
25281
25282clone.2
25283 Michael Kerrisk
25284 Add kernel versions for various CLONE_* constants
25285 Michael Kerrisk
25286 CLONE_NEWIPC governs mechanisms that don't have filesystem pathnames
25287 Michael Kerrisk
25288 CLONE_NEWIPC doesn't mount the POSIX MQ file system
25289 Michael Kerrisk
25290 Add an example program (CLONE_NEWUTS)
25291 Michael Kerrisk
25292 Some reworking of CLONE_NEWIPC text
25293 No substantial content changes.
25294 Michael Kerrisk
25295 SEE ALSO: add kcmp(2)
25296 SEE ALSO: add setns(2)
25297
25298fallocate.2
25299 Michael Kerrisk
25300 FALLOC_FL_* flags are defined in glibc only since 2.18
25301
25302getxattr.2
25303removexattr.2
25304setxattr.2
25305 Michael Kerrisk [Andrew Perepechko, ]
25306 Note that ENOATTR is a synonym for ENODATA
25307 Various people have pointed out that strace(1) shows ENODATA
25308 for the case where the named attribute does not exist, or
25309 the process has no access to this attribute. ENODATA
25310 and ENOATTR are in fact defined as synonyms. Point this out
25311 in the man page, so that people understand the strace(1) info.
25312
25313 See https://bugzilla.kernel.org/show_bug.cgi?id=51871
25314
25315getxattr.2
25316listxattr.2
25317removexattr.2
25318setxattr.2
25319 Michael Kerrisk
25320 Put errors under ERRORS section
25321 The errno values on these pages were listed in a nonstandard
25322 way under the RETURN VALUE section. Put them in ERRORS sections.
25323
25324init_module.2
25325 Michael Kerrisk [Rusty Russell]
25326 ERRORS: Add errors for module signatures (EBADMSG, ENOKEY)
25327
25328link.2
25329mkdir.2
25330mknod.2
25331open.2
25332rename.2
25333symlink.2
25334write.2
25335mkfifo.3
25336 Mark Hills
25337 Document EDQUOT error
25338 The return error EDQUOT is not documented in open(2), write(2),
25339 symlink(2) etc.
25340
25341 Whether inodes or disk blocks are required for each function
25342 is something I based on received wisdom and BSD documentation,
25343 rather than tracing the code to the kernel. For symlink(2)
25344 this certainly depends on the file system type.
25345
25346listxattr.2
25347 Michael Kerrisk [Theodore Ts'o]
25348 Fix RETURN VALUE description
25349 On success, 0 may be returned, so change wording from
25350 "positive number" to "nonnegative number".
25351
25352outb.2
25353 Michael Kerrisk
25354 Add SYNOPSIS
25355
25356prctl.2
25357 Kees Cook
25358 Document PR_SET_PTRACER
25359 Document the Yama LSM's prctl handler that allows processes to
25360 declare ptrace restriction exception relationships via
25361 PR_SET_PTRACER.
25362 Michael Kerrisk
25363 Make it explicit that PR_SET_PTRACER replaces previous setting
25364 The attribute is a scalar, not a list.
25365 Shawn Landden
25366 Document EINVAL error for PR_SET_PTRACER
25367 Michael Kerrisk
25368 Document PR_GET_TID_ADDRESS
25369
25370ptrace.2
25371 Michael Kerrisk
25372 Document PTRACE_O_EXITKILL
25373 Michael Kerrisk
25374 Place PTRACE_SETOPTIONS list in alphabetical order
25375
25376query_module.2
25377 Michael Kerrisk
25378 Must be called using syscall(2)
25379 Yes, the call is way obsolete, but add this info
25380 for completeness.
25381
25382recvmmsg.2
25383 Elie De Brauwer
25384 Add/correct kernel version info for recvmmsg() and MSG_WAITFORNONE
25385 This patch isolates the since/version related fixes as requested.
25386 This change introduces the following delta:
25387 * The page states it was added in 2.6.32 but it is only added
25388 2.6.33 (ref: http://kernelnewbies.org/Linux_2_6_33)
25389 * The MSG_WAITFORONE flag was in turn only added in 2.6.34
25390 (ref: http://kernelnewbies.org/Linux_2_6_34)
25391 Elie De Brauwer
25392 Add an example program
25393
25394setns.2
25395 Michael Kerrisk
25396 Add example program
25397
25398sigaction.2
25399 Michael Kerrisk [Zsbán Ambrus]
25400 Note feature test macro requirements for 'siginfo_t'
25401 See https://bugzilla.kernel.org/show_bug.cgi?id=52931
25402
25403syscalls.2
25404 Michael Kerrisk
25405 Add kern_features(2)
25406 Michael Kerrisk
25407 Add utrap_install(2)
25408 Sparc-specific, present since ancient times
25409 Michael Kerrisk
25410 Add finit_module(2)
25411
25412sysctl.2
25413 Michael Kerrisk [Garrett Cooper]
25414 ERRORS: EACCES as a synonym for EPRM
25415 See https://bugzilla.kernel.org/show_bug.cgi?id=46731
25416 and http://thread.gmane.org/gmane.linux.ltp/11413/focus=957635
25417 From: Garrett Cooper <yanegomi <at> gmail.com>
25418 Subject: Re: [LTP] [PATCH] sysctl03: sysctl returns EACCES after 2.6.33-rc1
25419 Newsgroups: gmane.linux.kernel, gmane.linux.ltp
25420 Date: 2010-03-04 18:35:33 GMT
25421
25422unshare.2
25423 Michael Kerrisk
25424 Update NOTES on unimplemented flags
25425 Michael Kerrisk
25426 Fix text problems in description of CLONE_FS
25427 Michael Kerrisk
25428 SEE ALSO: add kcmp(2)
25429 SEE ALSO: add setns(2)
25430 Michael Kerrisk
25431 Reorder CLONE_NEWUTS entry in list
25432
25433difftime.3
25434 Michael Kerrisk [Michal Gorny]
25435 Remove crufty text about 'time_t' on "other systems"
25436 Back in 2006, some text came in via Debian patches that seems
25437 crufty. Remove it.
25438
25439 See https://bugzilla.kernel.org/show_bug.cgi?id=46731
25440
25441getaddrinfo.3
25442getnameinfo.3
25443 Michael Kerrisk [Peter Budny]
25444 Fix some confused references to function names
25445 See https://bugzilla.kernel.org/show_bug.cgi?id=52741
25446
25447getspnam.3
25448 Michael Kerrisk [Wolfgang Rohdewald]
25449 ERRORS: Add EACCES
25450 See https://bugzilla.kernel.org/show_bug.cgi?id=52681
25451
25452__setfpucw.3
25453 Michael Kerrisk
25454 Add proper page cross refs for alternate functions
25455
25456core.5
25457proc.5
25458 Kees Cook
25459 Clarify suid_dumpable versus core_pattern
25460 In Linux 3.6, additional requirements were placed on core_pattern
25461 when suid_dumpable is set to 2. Document this and include commit
25462 references.
25463 Justin Lebar
25464 statm's "shared" field refers to pages backed by files
25465 I noticed that statm's "shared" field doesn't match the sum of
25466 all the "shared" entries in smaps [1].
25467
25468 The kernel docs explain that statm's "shared" field is "number of
25469 pages that are shared (i.e. backed by a file)" [2]. smaps appears
25470 to call a page shared if it's mapped by at least two processes,
25471 which explains this discrepancy.
25472
25473 I'm not a kernel hacker, but it appears to me they do mean "i.e."
25474 and not "e.g." in the statm description: In
25475 fs/proc/task_mmu.c::task_statm, I see
25476
25477 *shared = get_mm_counter(mm, MM_FILEPAGES);
25478
25479 Here's a patch which updates the man page to match the (hopefully
25480 correct) kernel docs.
25481
25482 [1] https://bugzilla.mozilla.org/show_bug.cgi?id=807181
25483 [2] http://git.kernel.org/?p=linux/kernel/git/torvalds/linux.git;a=blob;f=Documentation/filesystems/proc.txt;h=a1793d670cd01bd374eddf54ffdfc768504291ff;hb=HEAD
25484
25485proc.5
25486 Kees Cook
25487 Put /proc/sys/kernel/hotplug in alphabetical order
25488 Kees Cook
25489 Document /proc/sys/kernel/dmesg_restrict
25490 Kees Cook
25491 Linux 3.4 changed permissions needed to change kptr_restrict
25492 Michael Kerrisk [Samuel Thibault, Simon Paillard]
25493 Add field numbers for /proc/PID/stat
25494 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=553413
25495 Add numbering to /proc/stat "cpu" fields
25496 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=553413
25497 Michael Kerrisk
25498 Reorganize text describing /proc/stat "cpu" fields
25499 Michael Kerrisk
25500 Rewording of suid_dumpable text after comments from Kees Cook
25501 Michael Kerrisk [Samuel Thibault, Simon Paillard]
25502 Add field numbers for /proc/[pid]/statm
25503 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=553413
25504 Michael Kerrisk
25505 Document /proc/stat "cpu" "nice_guest" field
25506 Info taken from commit ce0e7b28fb75cb003cfc8d0238613aaf1c55e797
25507 Michael Kerrisk [Peter Lekeynstein]
25508 Document /prod/[pid]/oom_score_adj
25509 Text taken directly from Documentation/filesystems/proc.txt,
25510 with some light editing.
25511
25512 See https://bugzilla.kernel.org/show_bug.cgi?id=50421
25513
25514shells.5
25515 Michael Kerrisk
25516 Add /etc/bash to list of example shells
25517
25518ttytype.5
25519 Michael Kerrisk
25520 Add proper xref for termcap and terminfo pages
25521
25522capabilities.7
25523 Michael Kerrisk
25524 Add kcmp(2) under CAP_SYS_PTRACE
25525
25526man-pages.7
25527 Michael Kerrisk
25528 Update description of Section 7
25529
25530
25531==================== Changes in man-pages-3.47 ====================
25532
25533Released: 2013-02-12, Christchurch
25534
25535
25536Contributors
25537------------
25538
25539The following people contributed patches/fixes or (noted in brackets
25540in the changelog below) reports, notes, and ideas that have been
25541incorporated in changes in this release:
25542
25543David Prévot <taffit@debian.org>
25544D. Barbier <bouzim@gmail.com>
25545Lennart Poettering <lennart@poettering.net>
25546Michael Kerrisk <mtk.manpages@gmail.com>
25547Mike Frysinger <vapier@gentoo.org>
25548Peter Schiffer <pschiffe@redhat.com>
25549Radek Pazdera <rpazdera@redhat.com>
25550Reuben Thomas <rrt@sc3d.org>
25551Shawn Landden <shawnlandden@gmail.com>
25552Simon Paillard <spaillard@debian.org>
25553Vince Weaver <vweaver1@eecs.utk.edu>
25554
25555Apologies if I missed anyone!
25556
25557
25558New and rewritten pages
25559-----------------------
25560
25561perf_event_open.2
25562 Vincent Weaver
25563 New page documenting perf_event_open(2)
25564
25565pthread_setname_np.3
25566 Chandan Apsangi, Michael Kerrisk
25567 New page for pthread_setname_np(3) and pthread_getname_np(3)
25568
25569sln.8
25570 Michael Kerrisk [Peter Schiffer]
25571 New page documenting the 'sln' command provided by glibc
25572 Inspired by a Red Hat downstream page, but with rather
25573 more detail.
25574
25575
25576Newly documented interfaces in existing pages
25577---------------------------------------------
25578
25579prctl.2
25580 Michael Kerrisk [Shawn Landden, Lennart Poettering]
25581 Document PR_SET_CHILD_SUBREAPER and PR_GET_CHILD_SUBREAPER
25582
25583ip.7
25584 Radek Pazdera
25585 Add source-specific multicast sockopts
25586 This patch adds documentation of several source-specific multicast
25587 socket options that were added to kernel with implementation
25588 of IGMPv3 in 2.5.68.
25589
25590 The following socket options were added:
25591 IP_ADD_SOURCE_MEMBERSHIP
25592 IP_DROP_SOURCE_MEMBERSHIP
25593 IP_BLOCK_SOURCE
25594 IP_UNBLOCK_SOURCE
25595 IP_MSFILTER
25596
25597
25598Pages moved across sections
25599---------------------------
25600
25601getcontext.3
25602 Michael Kerrisk
25603 This page really belongs in Section 3 (moved from Section 2)
25604
25605getdtablesize.3
25606 Michael Kerrisk
25607 Move from Section 2
25608
25609
25610New and changed links
25611---------------------
25612
25613getcontext.2
25614 Michael Kerrisk
25615 Make link to page moved into Section 3
25616
25617getdtablesize.2
25618 Michael Kerrisk
25619 Link to renamed getdtablesize.3
25620
25621setcontext.2
25622 Michael Kerrisk
25623 Modify link to point to Section 3
25624
25625pthread_getname_np.3
25626 Michael Kerrisk
25627 New link to new pthread_setname_np.3
25628
25629setcontext.3
25630 Michael Kerrisk
25631 Link to getcontext page renamed into Section 3
25632
25633
25634Changes to individual pages
25635---------------------------
25636
25637fallocate.2
25638 Michael Kerrisk
25639 SEE ALSO: add fallocate(1)
25640
25641flock.2
25642 Michael Kerrisk
25643 SEE ALSO: add flock(1)
25644
25645fork.2
25646 Michael Kerrisk
25647 SEE ALSO: add exit(2)
25648
25649getpriority.2
25650 Michael Kerrisk
25651 BUGS: note that nice value is per-thread on Linux
25652
25653getrlimit.2
25654 Michael Kerrisk
25655 SEE ALSO: add prlimit(1)
25656
25657gettid.2
25658 Michael Kerrisk
25659 SEE ALSO: add various system calls that use thread IDs
25660
25661ioprio_set.2
25662 Michael Kerrisk
25663 SEE ALSO: add ionice(1)
25664
25665sched_setaffinity.2
25666 Michael Kerrisk
25667 SEE ALSO: add taskset(1)
25668
25669sched_setparam.2
25670 Michael Kerrisk
25671 Scheduling policy and parameters are per-thread on Linux
25672 Direct the reader to the discussion in sched_setscheduler(2).
25673
25674sched_setscheduler.2
25675 Michael Kerrisk
25676 Scheduling policy and parameters are per-thread on Linux
25677 Michael Kerrisk
25678 SEE ALSO: add chrt(1)
25679
25680setsid.2
25681 Michael Kerrisk
25682 SEE ALSO: add setsid(1)
25683
25684shmop.2
25685 Michael Kerrisk [Peter Schiffer]
25686 ERRORS: Add EIDRM
25687 Taken from Red Hat downstream patch
25688
25689sigaction.2
25690makecontext.3
25691 Michael Kerrisk
25692 Change getcontext/setcontext page ref to Section 3
25693
25694signal.2
25695 Michael Kerrisk [Reuben Thomas]
25696 Clarify System V vs BSD semantics for signal()
25697
25698syscalls.2
25699 Michael Kerrisk
25700 The list on this page is not just syscalls common to all platforms
25701 Michael Kerrisk
25702 Add perfctr(2)
25703 Add ppc_rtas(2)
25704 Michael Kerrisk
25705 Add kernel version number of utrap_install(2)
25706
25707unimplemented.2
25708 Michael Kerrisk [Peter Schiffer]
25709 Remove mention of kernel version number in DESCRIPTION
25710
25711inet.3
25712 Michael Kerrisk [Peter Schiffer]
25713 Fix error in EXAMPLE using inet_aton()
25714 See https://bugzilla.redhat.com/show_bug.cgi?id=837090
25715 Patch taken from Red Hat downstream.
25716
25717posix_fallocate.3
25718 Michael Kerrisk
25719 SEE ALSO: add fallocate(1)
25720
25721regex.3
25722 Reuben Thomas
25723 Clarify details of matching
25724 The first is that it's far from clear that the end points of the
25725 complete string match are stored in the zero'th element of the
25726 regmatch_t array; secondly, the phrase "next largest substring
25727 match" is positively misleading, implying some sort of size
25728 ordering, whereas in fact they are ordered according to their
25729 appearance in the regex pattern.
25730
25731scanf.3
25732 Michael Kerrisk
25733 Clarify meaning of "string conversions" for 'm' modifier
25734 Mike Frysinger
25735 Update %a vs %m documentation
25736 POSIX.1-2008 adopted the 'm' flag for dynamic allocation. Update
25737 page to cover it and relegate the glibc-specific 'a' flag to
25738 NOTES.
25739
25740strtol.3
25741 Michael Kerrisk [Peter Schiffer]
25742 Replace some bogus text about "thousands separator"
25743 See https://bugzilla.redhat.com/show_bug.cgi?id=652870
25744
25745sysconf.3
25746 Michael Kerrisk [Peter Schiffer]
25747 Use "_SC_PAGESIZE" consistently on page
25748 s/_SC_PAGE_SIZE/_SC_PAGESIZE/ in one instance.
25749 From Red Hat downstream patch.
25750
25751nscd.conf.5
25752 Peter Schiffer
25753 Add max-db-size and auto-propagate descriptions, default values, + misc
25754 * added missing valid services (services and netgroup)
25755 * added many default values for options
25756 * reordered options according to the nscd.conf file
25757 (logical order)
25758 * added 2 missing options: max-db-size and auto-propagate
25759
25760nsswitch.conf.5
25761 Peter Schiffer
25762 Mention initgroups db
25763
25764proc.5
25765 Michael Kerrisk
25766 Document /proc/profile
25767 Michael Kerrisk [Peter Schiffer]
25768 Update /proc/sys/fs/file-nr to include Linux 2.6 details
25769 Michael Kerrisk
25770 Clarify relationship between file-max and file-nr
25771 The third value in /proc/sys/fs/file-nr is the same as
25772 the value in /proc/sys/fs/file-max.
25773 Michael Kerrisk
25774 Note message written to kernel log when file-max limit is hit
25775 Info from Documentation/sysctl/fs.txt.
25776 Michael Kerrisk
25777 Mention lscpu(1) under discussion of /proc/cpuinfo
25778
25779resolv.conf.5
25780 Michael Kerrisk [Peter Schiffer]
25781 Document "single-request-reopen" option
25782 Taken from Red Hat downstream patch
25783
25784 See https://bugzilla.redhat.com/show_bug.cgi?id=717770
25785 See http://thread.gmane.org/gmane.linux.man/3161
25786
25787utmp.5
25788 Michael Kerrisk
25789 SEE ALSO: add utmpdump(1)
25790
25791cpuset.7
25792 Simon Paillard
25793 Add missing 'cpuset.' prefix for some flags
25794 See kernel commit e21a05cb408bb9f244f11a0813d4b355dad0822e
25795
25796svipc.7
25797 Michael Kerrisk
25798 SEE ALSO: add ipcmk(1), ipcrm(1), ipcs(1)
25799
25800termio.7
25801 Michael Kerrisk
25802 SEE ALSO: add reset(1), setterm(1), stty(1), tty(4)
25803
25804ld.so.8
25805 Michael Kerrisk [Peter Schiffer]
25806 LD_VERBOSE does not work with ld.so --list and --verify
25807 From Red Hat downstream patch
25808
25809 See https://bugzilla.redhat.com/show_bug.cgi?id=532629
25810 Michael Kerrisk
25811 SEE ALSO: add sln(8)
25812
25813zdump.8
25814 Michael Kerrisk [Peter Schiffer]
25815 Bring up to date with zdump --help
25816 Patch taken from Red Hat downstream.
25817
25818
25819==================== Changes in man-pages-3.48 ====================
25820
25821Released: 2013-03-05, Munich
25822
25823
25824Contributors
25825------------
25826
25827The following people contributed patches/fixes or (noted in brackets
25828in the changelog below) reports, notes, and ideas that have been
25829incorporated in changes in this release:
25830
25831Andrey Vagin <avagin@openvz.org>
25832Aristeu Rozanski <aris@ruivo.org>
25833Colin Walters <walters@verbum.org>
25834Cyril Hrubis <chrubis@suse.cz>
25835Cyrill Gorcunov <gorcunov@openvz.org>
25836Daniel P. Berrange <berrange@redhat.com>
25837David Prévot <taffit@debian.org>
25838D. Barbier <bouzim@gmail.com>
25839Denys Vlasenko <vda.linux@googlemail.com>
25840Flavio Leitner <fbl@redhat.com>
25841Graham Gower <graham.gower@gmail.com>
25842Ivana Varekova <varekova@redhat.com>
25843Kai Kunschke <kai@kunfoo.org>
25844Marcela Maslanova <mmaslano@redhat.com>
25845Marc Lehmann <debian-reportbug@plan9.de>
25846Marshel Abraham <Marshel.Abraham@in.bosch.com>
25847Michael Kerrisk <mtk.manpages@gmail.com>
25848Nathan Stratton Treadway <kernelbugs@nathanst.com>
25849Pavel Emelyanov <xemul@parallels.com>
25850Peter Schiffer <pschiffe@redhat.com>
25851Simon Heimberg <simohe@besonet.ch>
25852Simon Paillard <spaillard@debian.org>
25853Török Edwin <edwintorok@gmail.com>
25854Ulrich Drepper <drepper@redhat.com>
25855Zack Weinberg <zackw@panix.com>
25856
25857Apologies if I missed anyone!
25858
25859
25860New and rewritten pages
25861-----------------------
25862
25863getunwind.2
25864 Marcela Maslanova
25865 New page documenting getunwind(2)
25866 Taken from Red Hat downstream man pages set
25867 Michael Kerrisk
25868 Much rewriting
25869 Some text taken from arch/ia64/kernel/unwind.c.
25870
25871perfmonctl.2
25872 Ivana Varekova
25873 New page documenting IA-64-specific perfmonctl(2)
25874 Taken from Red Hat downstream man pages
25875 Michael Kerrisk
25876 Rework discussion of PFM_CREATE_CONTEXT
25877 Add VERSIONS and CONFORMING TO
25878 Note that there is no glibc wrapper
25879 Remove PFM_CREATE_EVTSETS, PFM_DELETE_EVTSETS, PFM_GETINFO_EVTSETS
25880 These don't exist, and it appears they never have.
25881 Fix argument types for PFM_WRITE_PMCS, PFM_WRITE_PMDS, PFM_READ_PMDS
25882 The types that were being used don't exist!
25883 Briefly document PFM_GET_FEATURES, PFM_DEBUG, PFM_GET_PMC_RESET_VAL
25884
25885gai.conf.5
25886 Ulrich Drepper
25887 New page documenting gai.conf
25888 Taken from Red Hat downstream pages
25889
25890nss.5
25891 Ulrich Drepper
25892 New page describing nss.conf
25893
25894
25895Newly documented interfaces in existing pages
25896---------------------------------------------
25897
25898clock_getres.2
25899 Cyril Hrubis
25900 Document CLOCK_REALTIME_COARSE and CLOCK_MONOTONIC_COARSE
25901 Cyril Hrubis
25902 Document CLOCK_BOOTTIME
25903 Michael Kerrisk
25904 Some improvements to CLOCK_BOOTTIME description
25905
25906ptrace.2
25907 Denys Vlasenko
25908 Document PTRACE_GETREGSET, PTRACE_SETREGSET, PTRACE_SEIZE, and friends
25909 Document PTRACE_GETREGSET, PTRACE_SETREGSET,
25910 PTRACE_SEIZE, PTRACE_INTERRUPT, and PTRACE_LISTEN.
25911
25912
25913New and changed links
25914---------------------
25915
25916fattach.2
25917fdetach.2
25918getmsg.2
25919isastream.2
25920putmsg.2
25921 Michael Kerrisk [Peter Schiffer]
25922 New link to unimplemented.2
25923 Taken from Red Hat downstream.
25924
25925 See https://bugzilla.redhat.com/show_bug.cgi?id=436407
25926
25927
25928Global changes
25929--------------
25930
25931Many pages
25932 Michael Kerrisk
25933 Global fix: remove unneeded double quotes in .SH headings
25934
25935Many pages
25936 Michael Kerrisk
25937 Global fix: remove unneeded double quotes in .SS headings
25938
25939Many pages
25940 Michael Kerrisk
25941 Global fix: use consistent capitalization in .SS headings
25942 Capitalization in .SS sections across pages (and sometimes even
25943 within a single page) is wildly inconsistent. Make it consistent.
25944 Capitalize first word in heading, but otherwise use lower case,
25945 except where English usage (e.g., proper nouns) or programming
25946 language requirements (e.g., identifier names) dictate otherwise.
25947Many pages
25948 Michael Kerrisk [Denys Vlasenko]
25949 Remove double blank lines in output
25950
25951Various pages
25952 Michael Kerrisk
25953 Fix order of SH sections
25954
25955
25956Changes to individual pages
25957---------------------------
25958
25959accept.2
25960 Michael Kerrisk
25961 NAME: Add "accept4"
25962
25963access.2
25964 Colin Walters
25965 Note that access() may also fail for FUSE
25966 Since in some cases (e.g. libguestfs's guestmount) it also has the
25967 semantics where files can appear owned by root, but are actually
25968 mutable by the user, despite what one might infer from the Unix
25969 permissions.
25970
25971getpeername.2
25972 Michael Kerrisk [Kai Kunschke]
25973 Clarify semantics of getpeername() for datagram sockets
25974 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=674034
25975
25976getuid.2
25977 Michael Kerrisk
25978 Remove duplicate section heading
25979
25980mmap.2
25981 Cyril Hrubis
25982 Add note about partial page in BUGS section
25983 This adds a note about Linux behavior with partial page at the end
25984 of the object. The problem here is that a page that contains only
25985 part of a file (because the file size is not multiple of PAGE_SIZE)
25986 stays in page cache even after the mapping is unmapped and the file
25987 is closed. So if some process dirties such page, other mappings
25988 will see the changes rather than zeroes.
25989 Michael Kerrisk [Török Edwin]
25990 Some 'flags' values require a feature test macro to be defined
25991 Add text to NOTES noting that some MAP_* constants are
25992 defined only if a suitable feature test macro is defined.
25993 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=542601
25994 Cyril Hrubis
25995 Document EOVERFLOW error
25996
25997open.2
25998 Michael Kerrisk
25999 Clarify list of file creation flags
26000 POSIX.1-2008 TC1 clarified this, so that O_CLOEXEC,
26001 O_DIRECTORY, and O_NOFOLLOW are also in this list.
26002
26003prctl.2
26004 Cyrill Gorcunov
26005 Add some details for PR_GET_TID_ADDRESS
26006
26007read.2
26008 Michael Kerrisk [Zack Weinberg]
26009 Clarify interaction of count==0 and error checking
26010 POSIX deliberately leaves this case open, so the man
26011 page should be less specific about what happens.
26012
26013 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=533232
26014 Michael Kerrisk [Marc Lehmann]
26015 Remove crufty text about O_NONBLOCK on files
26016 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=700529
26017 Michael Kerrisk
26018 Clarify details for seekable files
26019
26020unimplemented.2
26021 Michael Kerrisk [Peter Schiffer]
26022 Add various STREAMS interfaces to NAME
26023 Taken from Red Hat downstream.
26024
26025 See https://bugzilla.redhat.com/show_bug.cgi?id=436407
26026
26027cexp2.3
26028 Michael Kerrisk
26029 Still does not exist in glibc 2.17
26030
26031exit.3
26032 Michael Kerrisk
26033 Note that a call to execve() clears exit handler registrations
26034
26035getaddrinfo.3
26036 Michael Kerrisk
26037 SEE ALSO: Add gai.conf(5)
26038
26039malloc_trim.3
26040 Michael Kerrisk
26041 Remove duplicate section title
26042
26043printf.3
26044 Marshel Abraham [Graham Gower, Graham Gower]
26045 Fix error handling in example code
26046 See https://bugzilla.kernel.org/show_bug.cgi?id=23282
26047
26048pthread_yield.3
26049 Michael Kerrisk [Aristeu Rozanski]
26050 Add _GNU_SOURCE feature test macro to SYNOPSIS
26051
26052resolver.3
26053resolv.conf.5
26054 Michael Kerrisk [Nathan Stratton Treadway, Simon Heimberg]
26055 RES_DEBUG is only available if glibc is compiled with debug support
26056 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=692136
26057 and https://bugzilla.kernel.org/show_bug.cgi?id=43061
26058
26059strtol.3
26060 Michael Kerrisk [Peter Schiffer]
26061 Remove crufty text from previous fix
26062
26063core.5
26064 Michael Kerrisk
26065 Document CONFIG_COREDUMP
26066
26067capabilities.7
26068 Andrey Vagin
26069 Nonexistent bits are no longer shown as set in /proc/PID/status Cap*
26070
26071inotify.7
26072 Michael Kerrisk
26073 A monitoring process can't easily distinguish events triggered by itself
26074
26075ip.7
26076 Flavio Leitner [Peter Schiffer]
26077 Improve explanation about calling listen() or connect()
26078
26079man-pages.7
26080 Michael Kerrisk
26081 Describe rules for capitalization in .SS headings
26082
26083rtnetlink.7
26084 Pavel Emelyanov
26085 Add info about ability to create links with given index
26086 Since kernel v3.7 the RTM_NEWLINK message now accepts nonzero
26087 values in ifi_index field. Mention this fact in the respective
26088 rtnetlink.7 section.
26089
26090socket.7
26091 Pavel Emelyanov
26092 SO_BINDTODEVICE is now readable
26093 SO_BINDTODEVICE is readable since since kernel 3.8.
26094
26095
26096==================== Changes in man-pages-3.49 ====================
26097
26098Released: 2013-03-10, Munich
26099
26100
26101Contributors
26102------------
26103
26104The following people contributed patches/fixes or (noted in brackets
26105in the changelog below) reports, notes, and ideas that have been
26106incorporated in changes in this release:
26107
26108Michael Kerrisk <mtk.manpages@gmail.com>
26109
26110
26111Global changes
26112--------------
26113
26114The goal of the changes below to consistently format copyright
26115and license information in the comments in the page source
26116at the top of each page. This allows for easy scripting to
26117extract that information. Following these changes the comments
26118the top of the page source should now consistently have the form:
26119
26120 .\" <copyright info, possibly spread over several lines>
26121 .\"
26122 .\" %%%LICENSE_START(<license-type>)
26123 .\" <license text>
26124 .\" %%%LICENSE_END
26125 .\" <other comments>
26126
26127Note that the 'license-type' is merely descriptive. Its purpose is
26128to simplify scripting for the purpose of gathering statistics on
26129types of licenses used in man-pages. It is NOT a statement about
26130the actual licensing of the page; that license is contain INSIDE the
26131LICENSE_START...LICENSE_END clause.
26132
26133
26134All pages
26135 Michael Kerrisk
26136 Add a LICENSE_START()...LICENSE_END clause in source at
26137 top of each page that encapsulates the license text.
26138 Michael Kerrisk
26139 Put copyright info at top of page, followed by blank line and LICENSE
26140
26141Various pages
26142 Michael Kerrisk
26143 Update info in source comments on where to get a copy of the GPL
26144
26145Various pages
26146 Michael Kerrisk
26147 Remove "Hey Emacs" comment in page source
26148 Only certain pages have this; there is no consistency, so
26149 remove it from all pages
26150 Michael Kerrisk
26151 Remove "-*- nroff -*-" comment at top of source
26152
26153
26154==================== Changes in man-pages-3.50 ====================
26155
26156Released: 2013-03-15, Munich
26157
26158
26159Contributors
26160------------
26161
26162The following people contributed patches/fixes or (noted in brackets
26163in the changelog below) reports, notes, and ideas that have been
26164incorporated in changes in this release:
26165
26166Andrey Vagin <avagin@openvz.org>
26167Bernhard Kuemel <bernhard@bksys.at>
26168Elie De Brauwer <eliedebrauwer@gmail.com>
26169Erik Saule <erik.saule@bmi.osu.edu>
26170Florian Weimer <fweimer@bfk.de>
26171Friedrich Delgado Friedrichs <friedel@nomaden.org>
26172Jonathan Nieder <jrnieder@gmail.com>
26173Jose Luis Domingo Lopez <debian@24x7linux.com>
26174Mark R Bannister <mark@proseconsulting.co.uk>
26175Michael Kerrisk <mtk.manpages@gmail.com>
26176Sam Varshavchik <mrsam@courier-mta.com>
26177Simon Paillard <spaillard@debian.org>
26178
26179Apologies if I missed anyone!
26180
26181
26182New and rewritten pages
26183-----------------------
26184
26185canonicalize_file_name.3
26186 Michael Kerrisk
26187 Rewrite page, adding much more detail
26188
26189
26190Global changes
26191--------------
26192
26193Various pages
26194 Michael Kerrisk
26195 Global fix: s/END_LICENSE/LICENSE_END/
26196
26197Various pages
26198 Michael Kerrisk
26199 Global fix: s/bitmask/bit mask/
26200
26201
26202Changes to individual pages
26203---------------------------
26204
26205getent.1
26206 Mark R Bannister
26207 netgroup description incorrectly refers to initgroups
26208
26209capget.2
26210 Michael Kerrisk
26211 Update URL for libcap
26212
26213fork.2
26214 Michael Kerrisk
26215 Port access permission bits (ioperm()) are turned off in the child
26216
26217futex.2
26218 Michael Kerrisk
26219 'timeout' is a minimum duration that the call will wait, not a maximum
26220
26221ioperm.2
26222 Michael Kerrisk
26223 Note that iopl() level of 3 is needed to access ports
26224 Michael Kerrisk
26225 'num' is *bits* not bytes!
26226 Michael Kerrisk
26227 Linux 2.6.8 lifted the port limit to 65,536
26228 See http://article.gmane.org/gmane.linux.kernel/202624/
26229 From: Stas Sergeev <stsp <at> aknet.ru>
26230 Subject: [patch][rfc] Larger IO bitmap
26231 Date: 2004-05-07 19:55:03 GMT
26232 Michael Kerrisk
26233 ioperm() operates on the calling *thread* (not process)
26234 Michael Kerrisk
26235 Clarify meaning of 'turn_on' argument
26236 Plus form formatting fixes.
26237 Michael Kerrisk
26238 Clarify that default state of permission bits in child is off
26239 Michael Kerrisk
26240 NOTES: add mention of /proc/ioports
26241 Michael Kerrisk
26242 SEE ALSO: add outb(2)
26243
26244iopl.2
26245 Michael Kerrisk
26246 CAP_SYS_RAWIO is required to *raise* the I/O privilege level
26247 Michael Kerrisk
26248 Clarify that the two least significant bits of 'level' are what matter
26249 Michael Kerrisk
26250 SEE ALSO: add outb(2)
26251
26252syscalls.2
26253 Michael Kerrisk
26254 Add version information for all (other) syscalls
26255 Michael Kerrisk
26256 Add perfmonctl(2)
26257
26258futimes.3
26259 Michael Kerrisk [Jonathan Nieder]
26260 ERRORS: Add ENOSYS for lutimes()
26261 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=620746
26262
26263getpass.3
26264 Michael Kerrisk [Erik Saule]
26265 Suggest use of the ECHO flag as an alternative
26266 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=644261
26267
26268realpath.3
26269 Michael Kerrisk
26270 Document GNU extensions for EACCES and ENOENT errors
26271
26272stdarg.3
26273 Michael Kerrisk [Friedrich Delgado Friedrichs]
26274 Describe va_copy()
26275 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=575077
26276
26277termios.3
26278 Michael Kerrisk [Bernhard Kuemel]
26279 Mention that noncanonical mode does not do input processing
26280 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=643854
26281
26282random.4
26283 Elie De Brauwer
26284 Document write and document the ioctl interface of /dev/random
26285 The update consists out of two parts:
26286 - a minor thing which just documents what happens if a write to
26287 /dev/(u)random is performed, which is used in the example
26288 script but not explicitly mentioned.
26289 - the other (biggest) part is the documentation of the ioctl()
26290 interface which /dev/(u)random exposes. This ioctl() lives in
26291 drivers/char/random.c and the primitives can be found in
26292 include/linux/random.h
26293
26294 One comment remains, there used to be an RNDGETPOOL ioctl() which
26295 disappeared in v2.6.9. I found two patches on the net:
26296 - http://www.kernel.org/pub/linux/kernel/people/akpm/patches/2.6/2.6.8.1/2.6.8.1-mm4/broken-out/dev-random-remove-rndgetpool-ioctl.patch
26297 - https://lkml.org/lkml/2004/3/25/168
26298
26299 But as far as I can tell the first one got applied but the 2nd
26300 one seems more correct. The result is that even today one can
26301 still find traces of the RNDGETPOOL ioctl() in the header files.
26302 Is this there for historical reasons or because it might break
26303 userspace, even though using it will just give an EINVAL.
26304
26305bootparam.7
26306 Jose Luis Domingo Lopez
26307 Document 'rootfstype' option
26308 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=182014
26309
26310capabilities.7
26311 Michael Kerrisk
26312 Add various pieces under CAP_SYS_RAWIO
26313 Info obtained by grepping the kernel source.
26314 Michael Kerrisk
26315 Add CAP_SYS_RESOURCE /proc/PID/oom_score_adj case
26316
26317netlink.7
26318 Andrey Vagin
26319 Add a note about broadcast messages to multiple groups
26320
26321socket.7
26322 Michael Kerrisk [Florian Weimer]
26323 Define _GNU_SOURCE to obtain the definition of 'struct ucred'
26324 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=572210
2473426325
=== modified file 'Makefile'
--- Makefile 2012-11-16 10:33:14 +0000
+++ Makefile 2013-07-21 03:51:25 +0000
@@ -55,7 +55,7 @@
55 install -m 644 "$$i"/* $(DESTDIR)$(MANDIR)/"$$i" || exit $$?; \55 install -m 644 "$$i"/* $(DESTDIR)$(MANDIR)/"$$i" || exit $$?; \
56 done; \56 done; \
5757
58# Check if groff reports warnings (may be words of sentances not displayed)58# Check if groff reports warnings (may be words or sentences not displayed)
59# from http://lintian.debian.org/tags/manpage-has-errors-from-man.html 59# from http://lintian.debian.org/tags/manpage-has-errors-from-man.html
60GROFF_LOG := $(shell mktemp /tmp/manpages-checksXXXX)60GROFF_LOG := $(shell mktemp /tmp/manpages-checksXXXX)
61check-groff-warnings:61check-groff-warnings:
6262
=== modified file 'debian/changelog'
--- debian/changelog 2012-11-16 10:33:14 +0000
+++ debian/changelog 2013-07-21 03:51:25 +0000
@@ -1,3 +1,62 @@
1manpages (3.51-1ubuntu1) saucy; urgency=low
2
3 * Resynchronize with debian (LP: #1179064), remaining changes:
4 - man2/ptrace.2: Document Ubuntu-specific PTRACE_ATTACH
5 * man2/prctl.2: PR_SET_PTRACER now documented upstream, change dropped.
6
7 -- Matthew Fischer <matthew.fischer@canonical.com> Fri, 19 Jul 2013 20:07:34 -0600
8
9manpages (3.51-1) unstable; urgency=low
10
11 * Imported Upstream version 3.51:
12 . new manpages: kcmp.3 s390_runtime_instr.2 if_freenameindex.3
13 if_indextoname.3 if_nameindex.3 if_nametoindex.3 (Closes: #235967)
14 perf_event_open.2 getcontext.3 getdtablesize.3 pthread_getname_np.3
15 pthread_setname_np.3 setcontext.3 sln.8
16 fattach.2 fdetach.2 getmsg.2 getunwind.2 isastream.2
17 perfmonctl.2 putmsg.2 nss.5
18 . ttyname.3: Fix confused text in ERRORS (Closes: #676264)
19 . proc.5: Add field numbers for (Closes: #553413)
20 . read.2: Remove crufty text about O_NONBLOCK on files (Closes: #700529)
21 . read.2: Clarify interaction of count==0 and error check (Closes: #533232)
22 . getpeername.2: Clarify semantics of getpeername() for datagram
23 sockets (Closes: #674034)
24 . mmap.2: Some 'flags' values require a feature test macro to be
25 defined (Closes: #542601)
26 . resolver.3, resolv.conf.5: RES_DEBUG is only available if glibc is
27 compiled with debug support (Closes: #692136)
28 . stdarg.3: Describe va_copy() (Closes: #575077)
29 . futimes.3: ERRORS: Add ENOSYS for lutimes() (Closes: #620746)
30 . units.7: units should use an actual µ (Closes: #704787)
31 . access.2: Clarify RETURN VALUE for F_OK (Closes: #705293)
32 . resolv.conf.5: Document "single-request-reopen" option (Closes: #699387)
33 . bootparam.7: Document 'rootfstype' option (Closes: #182014)
34 . ioperm.2: Linux 2.6.8 lifted the port limit to 65,536 (Closes: #578178)
35 * d/rules: build-{arch,indep} as required by policy 3.9.4
36 * lintian overrides: FSSTND-dir-in-manual-page are alternate path
37
38 -- Simon Paillard <spaillard@debian.org> Thu, 23 May 2013 23:05:10 +0200
39
40manpages (3.44-1) unstable; urgency=low
41
42 * Imported Upstream version 3.44: (Closes: #692595)
43 . new manpages: getauxval.3 secure_getenv.3
44 . major update to delete_module.2 init_module.2 prctl.2 getauxval.3 proc.5
45 . fts.3: Improve description of physical vs. logical (Closes: #633505)
46 . getdomainname.2: these calls relate to NIS, not DNS (Closes: #295635)
47 . proc.5: fix 'starttime' description of /proc/PID/stat (Closes: #675891)
48 . ptrace.2: Clarify some operations are not present on all
49 architectures (Closes: #122383)
50 * motd.5 updated and motd.tail removed: due to new behaviour of sysvinit
51 2.88dsf-24 (Closes: #691414)
52 * Add glibc-doc-reference to package description (Closes: #640764)
53 * fputs.3: missing space in putc(c,stdout) (Closes: #693255)
54 * resolv.conf.5: Document IPv6 format for nameserver (Closes: #610036)
55 * stat.2: Clarify description of EOVERFLOW error (Closes: #604928)
56 * Ack my NMUs (Closes: #651476, #670874)
57
58 -- Simon Paillard <spaillard@debian.org> Fri, 16 Nov 2012 19:56:48 +0100
59
1manpages (3.44-0ubuntu1) raring; urgency=low60manpages (3.44-0ubuntu1) raring; urgency=low
261
3 * New upstream release62 * New upstream release
463
=== added file 'debian/check-conflicts'
--- debian/check-conflicts 1970-01-01 00:00:00 +0000
+++ debian/check-conflicts 2013-07-21 03:51:25 +0000
@@ -0,0 +1,18 @@
1#!/bin/bash
2
3BASEMAN="/usr/share/man"
4
5which apt-file >/dev/null 2>&1
6if [ $? -ne 0 ] ; then
7 echo "apt-file is required" 1>&2 ;
8 exit 1
9fi
10
11echo -e "WARNING: This tool assumes apt-file has been updated based on sid\n" 1>&2 ;
12
13
14for j in man*/*.* ;
15 do (dpkg -S "$BASEMAN/$j.gz" 2>/dev/null || apt-file search "$BASEMAN/$j.gz") \
16 | grep -v '^manpages:' \
17 | grep -v '^manpages-dev:' ;
18done
019
=== modified file 'debian/control'
--- debian/control 2012-10-28 01:14:59 +0000
+++ debian/control 2013-07-21 03:51:25 +0000
@@ -5,15 +5,15 @@
5Uploaders: Simon Paillard <spaillard@debian.org>5Uploaders: Simon Paillard <spaillard@debian.org>
6Priority: important6Priority: important
7Build-Depends: debhelper (>= 7)7Build-Depends: debhelper (>= 7)
8Standards-Version: 3.9.38Standards-Version: 3.9.4
9Vcs-Browser: http://cvs.infodrom.org/manpages/?cvsroot=debian9Vcs-Browser: http://anonscm.debian.org/gitweb/?p=collab-maint/manpages.git
10Vcs-CVS: :pserver:anonymous@cvs.infofrom.org:/var/cvs/debian manpages10Vcs-Git: git://anonscm.debian.org/collab-maint/manpages.git
11Homepage: http://www.kernel.org/doc/man-pages/11Homepage: http://www.kernel.org/doc/man-pages/
1212
13Package: manpages13Package: manpages
14Architecture: all14Architecture: all
15Suggests: man-browser15Suggests: man-browser
16Replaces: rsh-server (<< 0.10-7), bind, libc-bin (<< 2.16)16Replaces: rsh-server (<< 0.10-7), bind, libc-bin (<< 2.13-31)
17Depends: ${misc:Depends}17Depends: ${misc:Depends}
18Priority: important18Priority: important
19Description: Manual pages about using a GNU/Linux system19Description: Manual pages about using a GNU/Linux system
@@ -40,4 +40,4 @@
40 these two sections:40 these two sections:
41 2 = Linux system calls.41 2 = Linux system calls.
42 3 = Library calls (note that a more comprehensive source of information42 3 = Library calls (note that a more comprehensive source of information
43 may be found in the glibc-doc package).43 may be found in the glibc-doc and glibc-doc-reference packages).
4444
=== modified file 'debian/copyright'
--- debian/copyright 2008-04-25 16:16:42 +0000
+++ debian/copyright 2013-07-21 03:51:25 +0000
@@ -1,3 +1,7 @@
1Upstream-Name: man-pages
2Upstream-Contact: Michael Kerrisk <mtk.manpages@gmail.com>, linux-man@vger.kernel.org
3Source: https://www.kernel.org/pub/linux/docs/man-pages/
4
1Manual pages for Debian GNU/Linux5Manual pages for Debian GNU/Linux
2---------------------------------6---------------------------------
37
@@ -13,7 +17,3 @@
13<http://www.kernel.org/doc/man-pages/changelog.html>17<http://www.kernel.org/doc/man-pages/changelog.html>
14and the current version of the pages is browsable at18and the current version of the pages is browsable at
15<http://www.kernel.org/doc/man-pages/>.19<http://www.kernel.org/doc/man-pages/>.
16
17The source of the Debian package is managed using CVS. It is publicly
18available at <http://cvs.infodrom.org/manpages/?cvsroot=debian> or as
19<:pserver:anonymous@cvs.infodrom.org/var/cvs/debian/manpages/>.
2020
=== modified file 'debian/inst'
--- debian/inst 2012-05-06 15:24:57 +0000
+++ debian/inst 2013-07-21 03:51:25 +0000
@@ -15,13 +15,15 @@
15 for j in $i/*.*; do15 for j in $i/*.*; do
16 echo -n ${j#*/}16 echo -n ${j#*/}
17 case ${j#*/} in17 case ${j#*/} in
18 time.1|ldd.1|\18 time.1|\
19 console.4|fd.4|fstab.5|ftpusers.5|lilo.conf.5|nfs.5|exports.5|ttytype.5|\19 console.4|fd.4|fstab.5|ftpusers.5|lilo.conf.5|nfs.5|exports.5|ttytype.5|\
20 passwd.5|lilo.8|zic.8|zdump.8|ldconfig.8|nscd.conf.5|nscd.8|\20 passwd.5|lilo.8|zic.8|zdump.8|\
21 mdoc.samples.7|environ.5|\21 mdoc.samples.7|environ.5)
22 ld.so.8)
23 echo -n "(skipped)"22 echo -n "(skipped)"
24 ;; 23 ;;
24 ldd.1|ldconfig.8|ld.so.8|nscd.conf.5|nscd.8|gai.conf.5)
25 echo -n "(skipped, provided by eglibc)"
26 ;;
25 *)27 *)
26 read Y < $j 28 read Y < $j
27 case "$Y" in29 case "$Y" in
@@ -63,11 +65,13 @@
63 case ${j#*/} in65 case ${j#*/} in
64 intro.*)66 intro.*)
65 ;;67 ;;
66 infnan.3|fgetxattr.2|flistxattr.2|fremovexattr.2|fsetxattr.2|\68 infnan.3|query_module.2|set_mempolicy.2)
69 echo -n "(skipped)"
70 ;;
71 fgetxattr.2|flistxattr.2|fremovexattr.2|fsetxattr.2|\
67 getxattr.2|lgetxattr.2|listxattr.2|llistxattr.2|lremovexattr.2|\72 getxattr.2|lgetxattr.2|listxattr.2|llistxattr.2|lremovexattr.2|\
68 query_module.2|set_mempolicy.2|\
69 lsetxattr.2|removexattr.2|setxattr.2)73 lsetxattr.2|removexattr.2|setxattr.2)
70 echo -n "(skipped)"74 echo -n "(skipped, provided by libattr1-dev)"
71 ;; 75 ;;
72 *)76 *)
73 read Y < $j 77 read Y < $j
7478
=== modified file 'debian/lintian.manpages'
--- debian/lintian.manpages 2011-06-04 01:57:30 +0000
+++ debian/lintian.manpages 2013-07-21 03:51:25 +0000
@@ -1,2 +1,9 @@
1# nam stands for "no automatic margins"1# nam stands for "no automatic margins"
2manpages binary: spelling-error-in-manpage usr/share/man/man5/termcap.5.gz2manpages binary: spelling-error-in-manpage usr/share/man/man5/termcap.5.gz
3
4# /usr/doc/ indicated as old place for documentation
5manpages binary: FSSTND-dir-in-manual-page usr/share/man/man7/LDP.7.gz
6
7# /var/catman/ only described as alternate path
8manpages binary: FSSTND-dir-in-manual-page usr/share/man/man7/hier.7.gz
9
310
=== modified file 'debian/make-copyright'
--- debian/make-copyright 2011-12-08 22:30:21 +0000
+++ debian/make-copyright 2013-07-21 03:51:25 +0000
@@ -64,6 +64,9 @@
64 'sync.8' => 'GPL',64 'sync.8' => 'GPL',
65 'fcloseall.3' => 'Linux1',65 'fcloseall.3' => 'Linux1',
66 'fallocate.2' => 'GPLv2',66 'fallocate.2' => 'GPLv2',
67 'getdtablesize.2' => 'Linux2',
68 'gai.conf.5' => 'GPLv2',
69 'nss.5' => 'GPLv2',
67 'cciss.4' => 'GPLv2',70 'cciss.4' => 'GPLv2',
68 'hpsa.4' => 'GPLv2'71 'hpsa.4' => 'GPLv2'
69 );72 );
7073
=== modified file 'debian/rules'
--- debian/rules 2012-10-28 01:14:59 +0000
+++ debian/rules 2013-07-21 03:51:25 +0000
@@ -17,6 +17,10 @@
17 rm -rf licenses17 rm -rf licenses
18 dh_clean18 dh_clean
1919
20# For Policy 3.9.4
21build-arch: build
22build-indep: build
23
20binary-arch: build24binary-arch: build
2125
22binary-indep: build26binary-indep: build
2327
=== removed file 'man-pages-3.44.Announce'
--- man-pages-3.44.Announce 2012-11-16 10:33:14 +0000
+++ man-pages-3.44.Announce 1970-01-01 00:00:00 +0000
@@ -1,62 +0,0 @@
1RELEASE
2The Linux man page maintainer proudly announces. . .
3
4 man-pages-3.44.tar.gz - man pages for Linux
5
6Differences from the previous manual pages release are listed in
7the file "Changes".
8
9For further information, visit http://www.kernel.org/doc/man-pages/
10
11POSIX PAGES
12This package used to contains a copy of the POSIX 1003.1-2003
13man pages. The POSIX pages are now distributed in the separate
14man-pages-posix package.
15
16THE PAGES
17These pages are most of the section 2, 3, 4, 5, 7 man pages
18for Linux. A few pages are provided in sections 1 and 8 for commands
19that are not documented in other packages, and there are a few pages
20in sections 5 and 8 for the timezone utilities.
21
22[The timezone pages were taken from
23ftp://elsie.nci.nih.gov/pub/tzcode2001a.tar.gz.]
24[The section 3 man pages for the db routines have been taken from
25ftp://ftp.terra.net/pub/sleepycat/db.1.86.tar.gz.]
26[The rpc man pages were taken from the 4.4BSD-Lite CDROM.]
27
28Here is a breakdown of what this distribution contains:
29
30 Section 1 = user commands (intro, plus a few other pages)
31 Section 2 = system calls
32 Section 3 = libc calls
33 Section 4 = devices (e.g., hd, sd)
34 Section 5 = file formats and protocols (e.g., wtmp, /etc/passwd, nfs)
35 Section 6 = games (intro only)
36 Section 7 = overviews, conventions, macro packages, etc.
37 Section 8 = system administration (intro, plus a few other pages)
38
39 This package contains no, or very few, section 1, 6, and 8 man pages
40 because these should be distributed with the binaries they are written
41 for. Sometimes Section 9 is used for man pages describing parts of
42 the kernel.
43
44 Note that only Section 2 is rather complete, but Section 3 contains
45 several hundred man pages. If you want to write some man pages,
46 or suggest improvments to existing pages, please visit
47 http://www.kernel.org/doc/man-pages/ .
48
49
50Copyright information:
51
52 These man pages are distributed under a variety of copyright licenses.
53 Although these licenses permit free distribution of the nroff sources
54 contained in this package, commercial distribution may impose other
55 requirements (e.g., acknowledgement of copyright or inclusion of the
56 raw nroff sources with the commercial distribution).
57 If you distribute these man pages commercially, it is your
58 responsibility to figure out your obligations. (For many man pages,
59 these obligations require you to distribute nroff sources with any
60 pre-formatted man pages that you provide.) Each file that contains
61 nroff source for a man page also contains the author(s) name, email
62 address, and copyright notice.
630
=== removed file 'man-pages-3.44.lsm'
--- man-pages-3.44.lsm 2012-11-16 10:33:14 +0000
+++ man-pages-3.44.lsm 1970-01-01 00:00:00 +0000
@@ -1,14 +0,0 @@
1Begin3
2Title: Section 2, 3, 4, 5 and 7 man pages for Linux
3Version: 3.44
4Entered-date: 2012-11-07
5Description: Linux manual pages
6Keywords: man pages
7Author: several
8Maintained-by: Michael Kerrisk <mtk.manpages@gmail.com>
9Primary-site: ftp://ftp.kernel.org/pub/linux/docs/man-pages
10 1773k man-pages-3.44.tar.gz
11Alternate-site: ftp://ftp.win.tue.nl/pub/linux-local/manpages
12Copying-policy: several; the pages are all freely distributable as long as
13 nroff source is provided
14End
150
=== added file 'man-pages-3.51.Announce'
--- man-pages-3.51.Announce 1970-01-01 00:00:00 +0000
+++ man-pages-3.51.Announce 2013-07-21 03:51:25 +0000
@@ -0,0 +1,62 @@
1RELEASE
2The Linux man page maintainer proudly announces. . .
3
4 man-pages-3.51.tar.gz - man pages for Linux
5
6Differences from the previous manual pages release are listed in
7the file "Changes".
8
9For further information, visit http://www.kernel.org/doc/man-pages/
10
11POSIX PAGES
12This package used to contains a copy of the POSIX 1003.1-2003
13man pages. The POSIX pages are now distributed in the separate
14man-pages-posix package.
15
16THE PAGES
17These pages are most of the section 2, 3, 4, 5, 7 man pages
18for Linux. A few pages are provided in sections 1 and 8 for commands
19that are not documented in other packages, and there are a few pages
20in sections 5 and 8 for the timezone utilities.
21
22[The timezone pages were taken from
23ftp://elsie.nci.nih.gov/pub/tzcode2001a.tar.gz.]
24[The section 3 man pages for the db routines have been taken from
25ftp://ftp.terra.net/pub/sleepycat/db.1.86.tar.gz.]
26[The rpc man pages were taken from the 4.4BSD-Lite CDROM.]
27
28Here is a breakdown of what this distribution contains:
29
30 Section 1 = user commands (intro, plus a few other pages)
31 Section 2 = system calls
32 Section 3 = libc calls
33 Section 4 = devices (e.g., hd, sd)
34 Section 5 = file formats and protocols (e.g., wtmp, /etc/passwd, nfs)
35 Section 6 = games (intro only)
36 Section 7 = overviews, conventions, macro packages, etc.
37 Section 8 = system administration (intro, plus a few other pages)
38
39 This package contains no, or very few, section 1, 6, and 8 man pages
40 because these should be distributed with the binaries they are written
41 for. Sometimes Section 9 is used for man pages describing parts of
42 the kernel.
43
44 Note that only Section 2 is rather complete, but Section 3 contains
45 several hundred man pages. If you want to write some man pages,
46 or suggest improvments to existing pages, please visit
47 http://www.kernel.org/doc/man-pages/ .
48
49
50Copyright information:
51
52 These man pages are distributed under a variety of copyright licenses.
53 Although these licenses permit free distribution of the nroff sources
54 contained in this package, commercial distribution may impose other
55 requirements (e.g., acknowledgement of copyright or inclusion of the
56 raw nroff sources with the commercial distribution).
57 If you distribute these man pages commercially, it is your
58 responsibility to figure out your obligations. (For many man pages,
59 these obligations require you to distribute nroff sources with any
60 pre-formatted man pages that you provide.) Each file that contains
61 nroff source for a man page also contains the author(s) name, email
62 address, and copyright notice.
063
=== added file 'man-pages-3.51.lsm'
--- man-pages-3.51.lsm 1970-01-01 00:00:00 +0000
+++ man-pages-3.51.lsm 2013-07-21 03:51:25 +0000
@@ -0,0 +1,14 @@
1Begin3
2Title: Section 2, 3, 4, 5 and 7 man pages for Linux
3Version: 3.51
4Entered-date: 2013-04-17
5Description: Linux manual pages
6Keywords: man pages
7Author: several
8Maintained-by: Michael Kerrisk <mtk.manpages@gmail.com>
9Primary-site: ftp://ftp.kernel.org/pub/linux/docs/man-pages
10 1839k man-pages-3.51.tar.gz
11Alternate-site: ftp://ftp.win.tue.nl/pub/linux-local/manpages
12Copying-policy: several; the pages are all freely distributable as long as
13 nroff source is provided
14End
015
=== modified file 'man1/getent.1'
--- man1/getent.1 2012-11-16 10:33:14 +0000
+++ man1/getent.1 2013-07-21 03:51:25 +0000
@@ -1,5 +1,6 @@
1.\" Copyright (c) 2011, Mark R. Bannister <cambridge@users.sourceforge.net>1.\" Copyright (c) 2011, Mark R. Bannister <cambridge@users.sourceforge.net>
2.\"2.\"
3.\" %%%LICENSE_START(GPLv2+_DOC_FULL)
3.\" This is free documentation; you can redistribute it and/or4.\" This is free documentation; you can redistribute it and/or
4.\" modify it under the terms of the GNU General Public License as5.\" modify it under the terms of the GNU General Public License as
5.\" published by the Free Software Foundation; either version 2 of6.\" published by the Free Software Foundation; either version 2 of
@@ -16,11 +17,11 @@
16.\" GNU General Public License for more details.17.\" GNU General Public License for more details.
17.\"18.\"
18.\" You should have received a copy of the GNU General Public19.\" You should have received a copy of the GNU General Public
19.\" License along with this manual; if not, write to the Free20.\" License along with this manual; if not, see
20.\" Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111,21.\" <http://www.gnu.org/licenses/>.
21.\" USA.22.\" %%%LICENSE_END
22.\"23.\"
23.TH GETENT 1 2011-10-31 "Linux" "User Commands"24.TH GETENT 1 2013-03-15 "Linux" "User Commands"
24.SH NAME25.SH NAME
25getent \- get entries from Name Service Switch libraries26getent \- get entries from Name Service Switch libraries
26.SH SYNOPSIS27.SH SYNOPSIS
@@ -214,7 +215,7 @@
214to match to a netgroup name via215to match to a netgroup name via
215.BR innetgr (3).216.BR innetgr (3).
216Enumeration is not supported on217Enumeration is not supported on
217.BR initgroups ,218.BR netgroup ,
218so either one or three219so either one or three
219.I keys220.I keys
220must be provided.221must be provided.
@@ -341,7 +342,7 @@
341.BR getspnam (3)342.BR getspnam (3)
342and display the result.343and display the result.
343.RE344.RE
344.SH "EXIT STATUS"345.SH EXIT STATUS
345One of the following exit values can be returned by346One of the following exit values can be returned by
346.BR getent :347.BR getent :
347.RS 3348.RS 3
@@ -364,10 +365,10 @@
364Enumeration not supported on this365Enumeration not supported on this
365.IR database .366.IR database .
366.RE367.RE
367.SH "SEE ALSO"368.SH SEE ALSO
368.BR nsswitch.conf (5)369.BR nsswitch.conf (5)
369.SH COLOPHON370.SH COLOPHON
370This page is part of release 3.44 of the Linux371This page is part of release 3.51 of the Linux
371.I man-pages372.I man-pages
372project.373project.
373A description of the project,374A description of the project,
374375
=== modified file 'man1/intro.1'
--- man1/intro.1 2012-11-16 10:33:14 +0000
+++ man1/intro.1 2013-07-21 03:51:25 +0000
@@ -1,5 +1,6 @@
1.\" Copyright (c) 2002 Andries Brouwer <aeb@cwi.nl>1.\" Copyright (c) 2002 Andries Brouwer <aeb@cwi.nl>
2.\"2.\"
3.\" %%%LICENSE_START(VERBATIM)
3.\" Permission is granted to make and distribute verbatim copies of this4.\" Permission is granted to make and distribute verbatim copies of this
4.\" manual provided the copyright notice and this permission notice are5.\" manual provided the copyright notice and this permission notice are
5.\" preserved on all copies.6.\" preserved on all copies.
@@ -19,6 +20,7 @@
19.\"20.\"
20.\" Formatted or processed versions of this manual, if unaccompanied by21.\" Formatted or processed versions of this manual, if unaccompanied by
21.\" the source, must acknowledge the copyright and authors of this work.22.\" the source, must acknowledge the copyright and authors of this work.
23.\" %%%LICENSE_END
22.\"24.\"
23.\" 2007-10-23 mtk Added intro paragraph about section, plus a paragraph25.\" 2007-10-23 mtk Added intro paragraph about section, plus a paragraph
24.\" about exit status values.26.\" about exit status values.
@@ -57,7 +59,7 @@
57That is faster and more powerful,59That is faster and more powerful,
58but requires finding out what the commands are.60but requires finding out what the commands are.
59Below a bare minimum, to get started.61Below a bare minimum, to get started.
60.SS "Login"62.SS Login
61In order to start working, you probably first have to login,63In order to start working, you probably first have to login,
62that is, give your username and password.64that is, give your username and password.
63See also65See also
@@ -71,7 +73,7 @@
71and a mouse click will start a shell in a window.73and a mouse click will start a shell in a window.
72See also74See also
73.BR xterm (1).75.BR xterm (1).
74.SS "The shell"76.SS The shell
75One types commands to the77One types commands to the
76.IR shell ,78.IR shell ,
77the command interpreter.79the command interpreter.
@@ -194,7 +196,7 @@
194.I grep196.I grep
195(from "g/re/p") finds occurrences of a string in one or more files.197(from "g/re/p") finds occurrences of a string in one or more files.
196Here it finds Maja's telephone number.198Here it finds Maja's telephone number.
197.SS "Pathnames and the current directory"199.SS Pathnames and the current directory
198Files live in a large tree, the file hierarchy.200Files live in a large tree, the file hierarchy.
199Each has a201Each has a
200.I "pathname"202.I "pathname"
@@ -202,8 +204,8 @@
202to the file.204to the file.
203For example, such a full pathname might be /home/aeb/tel.205For example, such a full pathname might be /home/aeb/tel.
204Always using full pathnames would be inconvenient, and the name206Always using full pathnames would be inconvenient, and the name
205of a file in the current directory may be abbreviated by only giving207of a file in the current directory may be abbreviated by giving
206the last component.208only the last component.
207That is why "/home/aeb/tel" can be abbreviated209That is why "/home/aeb/tel" can be abbreviated
208to "tel" when the current directory is "/home/aeb".210to "tel" when the current directory is "/home/aeb".
209.LP211.LP
@@ -215,7 +217,7 @@
215.I cd217.I cd
216changes the current directory.218changes the current directory.
217Try "cd /" and "pwd" and "cd" and "pwd".219Try "cd /" and "pwd" and "cd" and "pwd".
218.SS "Directories"220.SS Directories
219The command221The command
220.I mkdir222.I mkdir
221makes a new directory.223makes a new directory.
@@ -235,7 +237,7 @@
235Large searches on a multi-GB disk will be time-consuming,237Large searches on a multi-GB disk will be time-consuming,
236and it may be better to use238and it may be better to use
237.BR locate (1).239.BR locate (1).
238.SS "Disks and Filesystems"240.SS Disks and filesystems
239The command241The command
240.I mount242.I mount
241will attach the file system found on some disk (or floppy, or CDROM or so)243will attach the file system found on some disk (or floppy, or CDROM or so)
@@ -246,7 +248,7 @@
246The command248The command
247.I df249.I df
248will tell you how much of your disk is still free.250will tell you how much of your disk is still free.
249.SS "Processes"251.SS Processes
250On a UNIX system many user and system processes run simultaneously.252On a UNIX system many user and system processes run simultaneously.
251The one you are talking to runs in the253The one you are talking to runs in the
252.IR foreground ,254.IR foreground ,
@@ -264,7 +266,7 @@
264And "kill \-9" followed by the number266And "kill \-9" followed by the number
265of the process is an immediate kill.267of the process is an immediate kill.
266Foreground processes can often be killed by typing Control-C.268Foreground processes can often be killed by typing Control-C.
267.SS "Getting information"269.SS Getting information
268There are thousands of commands, each with many options.270There are thousands of commands, each with many options.
269Traditionally commands are documented on271Traditionally commands are documented on
270.IR "man pages" ,272.IR "man pages" ,
@@ -297,10 +299,10 @@
297.\"299.\"
298.\" Actual examples? Separate section for each of cat, cp, ...?300.\" Actual examples? Separate section for each of cat, cp, ...?
299.\" gzip, bzip2, tar, rpm301.\" gzip, bzip2, tar, rpm
300.SH "SEE ALSO"302.SH SEE ALSO
301.BR standards (7)303.BR standards (7)
302.SH COLOPHON304.SH COLOPHON
303This page is part of release 3.44 of the Linux305This page is part of release 3.51 of the Linux
304.I man-pages306.I man-pages
305project.307project.
306A description of the project,308A description of the project,
307309
=== modified file 'man1/ldd.1'
--- man1/ldd.1 2012-11-16 10:33:14 +0000
+++ man1/ldd.1 2013-07-21 03:51:25 +0000
@@ -5,8 +5,12 @@
5.\" Copyright 2000 Jakub Jelinek (jakub@redhat.com)5.\" Copyright 2000 Jakub Jelinek (jakub@redhat.com)
6.\" Corrected.6.\" Corrected.
7.\" Most of this was copied from the README file.7.\" Most of this was copied from the README file.
8.\"
9.\" %%%LICENSE_START(GPL_NOVERSION_ONELINE)
8.\" Do not restrict distribution.10.\" Do not restrict distribution.
9.\" May be distributed under the GNU General Public License11.\" May be distributed under the GNU General Public License
12.\" %%%LICENSE_END
13.\"
10.TH LDD 1 2012-07-16 "" "Linux Programmer's Manual"14.TH LDD 1 2012-07-16 "" "Linux Programmer's Manual"
11.SH NAME15.SH NAME
12ldd \- print shared library dependencies16ldd \- print shared library dependencies
@@ -104,7 +108,7 @@
104.BR ld.so (8),108.BR ld.so (8),
105.BR ldconfig (8)109.BR ldconfig (8)
106.SH COLOPHON110.SH COLOPHON
107This page is part of release 3.44 of the Linux111This page is part of release 3.51 of the Linux
108.I man-pages112.I man-pages
109project.113project.
110A description of the project,114A description of the project,
111115
=== modified file 'man1/time.1'
--- man1/time.1 2012-11-16 10:33:14 +0000
+++ man1/time.1 2013-07-21 03:51:25 +0000
@@ -1,9 +1,11 @@
1.\" Copyright Andries Brouwer, 20001.\" Copyright Andries Brouwer, 2000
2.\"
3.\" This page is distributed under GPL.
4.\" Some fragments of text came from the time-1.7 info file.2.\" Some fragments of text came from the time-1.7 info file.
5.\" Inspired by kromJx@crosswinds.net.3.\" Inspired by kromJx@crosswinds.net.
6.\"4.\"
5.\" %%%LICENSE_START(GPL_NOVERSION_ONELINE)
6.\" Distributed under GPL
7.\" %%%LICENSE_END
8.\"
7.TH TIME 1 2008-11-14 "" "Linux User's Manual"9.TH TIME 1 2008-11-14 "" "Linux User's Manual"
8.SH NAME10.SH NAME
9time \- time a simple command or give resource usage11time \- time a simple command or give resource usage
@@ -60,7 +62,7 @@
60(with numbers in seconds)62(with numbers in seconds)
61where the number of decimals in the output for %f is unspecified63where the number of decimals in the output for %f is unspecified
62but is sufficient to express the clock tick accuracy, and at least one.64but is sufficient to express the clock tick accuracy, and at least one.
63.SH "EXIT STATUS"65.SH EXIT STATUS
64If66If
65.I command67.I command
66was invoked, the exit status is that of68was invoked, the exit status is that of
@@ -83,7 +85,7 @@
83The last one to search for85The last one to search for
84.IR command .86.IR command .
85The remaining ones for the text and formatting of the output.87The remaining ones for the text and formatting of the output.
86.SH "GNU VERSION"88.SH GNU VERSION
87Below a description of the GNU 1.7 version of89Below a description of the GNU 1.7 version of
88.BR time .90.BR time .
89Disregarding the name of the utility, GNU makes it output lots of91Disregarding the name of the utility, GNU makes it output lots of
@@ -119,7 +121,7 @@
119.in121.in
120.PP122.PP
121is used.123is used.
122.SS "The format string"124.SS The format string
123The format is interpreted in the usual printf-like way.125The format is interpreted in the usual printf-like way.
124Ordinary characters are directly copied, tab, newline126Ordinary characters are directly copied, tab, newline
125and backslash are escaped using \et, \en and \e\e,127and backslash are escaped using \et, \en and \e\e,
@@ -219,7 +221,7 @@
219.TP221.TP
220.B %x222.B %x
221(Not in tcsh.) Exit status of the command.223(Not in tcsh.) Exit status of the command.
222.SS "GNU Options"224.SS GNU options
223.TP225.TP
224.BI "\-f " FORMAT ", \-\-format=" FORMAT226.BI "\-f " FORMAT ", \-\-format=" FORMAT
225Specify output format, possibly overriding the format specified227Specify output format, possibly overriding the format specified
@@ -236,7 +238,7 @@
236.TP238.TP
237.B "\-v, \-\-verbose"239.B "\-v, \-\-verbose"
238Give very verbose output about all the program knows about.240Give very verbose output about all the program knows about.
239.SS "GNU Standard Options"241.SS GNU standard options
240.TP242.TP
241.B "\-\-help"243.B "\-\-help"
242Print a usage message on standard output and exit successfully.244Print a usage message on standard output and exit successfully.
@@ -299,12 +301,12 @@
299.\" Helped with portability301.\" Helped with portability
300.\" .IP "Francois Pinard"302.\" .IP "Francois Pinard"
301.\" Helped with portability303.\" Helped with portability
302.SH "SEE ALSO"304.SH SEE ALSO
303.BR tcsh (1),305.BR tcsh (1),
304.BR times (2),306.BR times (2),
305.BR wait3 (2)307.BR wait3 (2)
306.SH COLOPHON308.SH COLOPHON
307This page is part of release 3.44 of the Linux309This page is part of release 3.51 of the Linux
308.I man-pages310.I man-pages
309project.311project.
310A description of the project,312A description of the project,
311313
=== modified file 'man2/_exit.2'
--- man2/_exit.2 2012-11-16 10:33:14 +0000
+++ man2/_exit.2 2013-07-21 03:51:25 +0000
@@ -1,8 +1,7 @@
1.\" Hey Emacs! This file is -*- nroff -*- source.
2.\"
3.\" This manpage is Copyright (C) 1992 Drew Eckhardt;1.\" This manpage is Copyright (C) 1992 Drew Eckhardt;
4.\" 1993 Michael Haardt, Ian Jackson.2.\" and Copyright (C) 1993 Michael Haardt, Ian Jackson.
5.\"3.\"
4.\" %%%LICENSE_START(VERBATIM)
6.\" Permission is granted to make and distribute verbatim copies of this5.\" Permission is granted to make and distribute verbatim copies of this
7.\" manual provided the copyright notice and this permission notice are6.\" manual provided the copyright notice and this permission notice are
8.\" preserved on all copies.7.\" preserved on all copies.
@@ -22,6 +21,7 @@
22.\"21.\"
23.\" Formatted or processed versions of this manual, if unaccompanied by22.\" Formatted or processed versions of this manual, if unaccompanied by
24.\" the source, must acknowledge the copyright and authors of this work.23.\" the source, must acknowledge the copyright and authors of this work.
24.\" %%%LICENSE_END
25.\"25.\"
26.\" Modified Wed Jul 21 23:02:38 1993 by Rik Faith <faith@cs.unc.edu>26.\" Modified Wed Jul 21 23:02:38 1993 by Rik Faith <faith@cs.unc.edu>
27.\" Modified 2001-11-17, aeb27.\" Modified 2001-11-17, aeb
@@ -76,9 +76,9 @@
76.BR _Exit ()76.BR _Exit ()
77is equivalent to77is equivalent to
78.BR _exit ().78.BR _exit ().
79.SH "RETURN VALUE"79.SH RETURN VALUE
80These functions do not return.80These functions do not return.
81.SH "CONFORMING TO"81.SH CONFORMING TO
82SVr4, POSIX.1-2001, 4.3BSD.82SVr4, POSIX.1-2001, 4.3BSD.
83The function83The function
84.BR _Exit ()84.BR _Exit ()
@@ -121,7 +121,7 @@
121Since glibc 2.3, the wrapper function invokes121Since glibc 2.3, the wrapper function invokes
122.BR exit_group (2),122.BR exit_group (2),
123in order to terminate all of the threads in a process.123in order to terminate all of the threads in a process.
124.SH "SEE ALSO"124.SH SEE ALSO
125.BR execve (2),125.BR execve (2),
126.BR exit_group (2),126.BR exit_group (2),
127.BR fork (2),127.BR fork (2),
@@ -134,7 +134,7 @@
134.BR on_exit (3),134.BR on_exit (3),
135.BR termios (3)135.BR termios (3)
136.SH COLOPHON136.SH COLOPHON
137This page is part of release 3.44 of the Linux137This page is part of release 3.51 of the Linux
138.I man-pages138.I man-pages
139project.139project.
140A description of the project,140A description of the project,
141141
=== modified file 'man2/_syscall.2'
--- man2/_syscall.2 2012-11-16 10:33:14 +0000
+++ man2/_syscall.2 2013-07-21 03:51:25 +0000
@@ -1,7 +1,7 @@
1.\"
2.\" Copyright (c) 1993 Michael Haardt (michael@moria.de),1.\" Copyright (c) 1993 Michael Haardt (michael@moria.de),
3.\" Fri Apr 2 11:32:09 MET DST 19932.\" Fri Apr 2 11:32:09 MET DST 1993
4.\"3.\"
4.\" %%%LICENSE_START(GPLv2+_DOC_FULL)
5.\" This is free documentation; you can redistribute it and/or5.\" This is free documentation; you can redistribute it and/or
6.\" modify it under the terms of the GNU General Public License as6.\" modify it under the terms of the GNU General Public License as
7.\" published by the Free Software Foundation; either version 2 of7.\" published by the Free Software Foundation; either version 2 of
@@ -18,9 +18,9 @@
18.\" GNU General Public License for more details.18.\" GNU General Public License for more details.
19.\"19.\"
20.\" You should have received a copy of the GNU General Public20.\" You should have received a copy of the GNU General Public
21.\" License along with this manual; if not, write to the Free21.\" License along with this manual; if not, see
22.\" Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111,22.\" <http://www.gnu.org/licenses/>.
23.\" USA.23.\" %%%LICENSE_END
24.\"24.\"
25.\" Tue Jul 6 12:42:46 MDT 1993 <dminer@nyx.cs.du.edu>25.\" Tue Jul 6 12:42:46 MDT 1993 <dminer@nyx.cs.du.edu>
26.\" Added "Calling Directly" and supporting paragraphs26.\" Added "Calling Directly" and supporting paragraphs
@@ -38,7 +38,7 @@
38.TH _SYSCALL 2 2007-12-19 "Linux" "Linux Programmer's Manual"38.TH _SYSCALL 2 2007-12-19 "Linux" "Linux Programmer's Manual"
39.SH NAME39.SH NAME
40_syscall \- invoking a system call without library support (OBSOLETE)40_syscall \- invoking a system call without library support (OBSOLETE)
41.SH "SYNOPSIS"41.SH SYNOPSIS
42.B #include <linux/unistd.h>42.B #include <linux/unistd.h>
4343
44A _syscall macro44A _syscall macro
@@ -74,7 +74,7 @@
74you call the system call by \fIname\fP.74you call the system call by \fIname\fP.
75.SH FILES75.SH FILES
76.I /usr/include/linux/unistd.h76.I /usr/include/linux/unistd.h
77.SH "CONFORMING TO"77.SH CONFORMING TO
78The use of these macros is Linux-specific, and deprecated.78The use of these macros is Linux-specific, and deprecated.
79.SH NOTES79.SH NOTES
80Starting around kernel 2.6.18, the _syscall macros were removed80Starting around kernel 2.6.18, the _syscall macros were removed
@@ -108,7 +108,7 @@
108.\" The preferred way to invoke system calls that glibc does not know108.\" The preferred way to invoke system calls that glibc does not know
109.\" about yet is via109.\" about yet is via
110.\" .BR syscall (2).110.\" .BR syscall (2).
111.\" However, this mechanism can only be used if using a libc111.\" However, this mechanism can be used only if using a libc
112.\" (such as glibc) that supports112.\" (such as glibc) that supports
113.\" .BR syscall (2),113.\" .BR syscall (2),
114.\" and if the114.\" and if the
@@ -150,7 +150,7 @@
150 exit(EXIT_SUCCESS);150 exit(EXIT_SUCCESS);
151}151}
152.fi152.fi
153.SS "Sample Output"153.SS Sample output
154.nf154.nf
155code error = 0155code error = 0
156uptime = 502034s156uptime = 502034s
@@ -160,12 +160,12 @@
160Swap: total 27881472 / free 24698880160Swap: total 27881472 / free 24698880
161Number of processes = 40161Number of processes = 40
162.fi162.fi
163.SH "SEE ALSO"163.SH SEE ALSO
164.BR intro (2),164.BR intro (2),
165.BR syscall (2),165.BR syscall (2),
166.BR errno (3)166.BR errno (3)
167.SH COLOPHON167.SH COLOPHON
168This page is part of release 3.44 of the Linux168This page is part of release 3.51 of the Linux
169.I man-pages169.I man-pages
170project.170project.
171A description of the project,171A description of the project,
172172
=== modified file 'man2/accept.2'
--- man2/accept.2 2012-11-16 10:33:14 +0000
+++ man2/accept.2 2013-07-21 03:51:25 +0000
@@ -1,6 +1,7 @@
1.\" Copyright (c) 1983, 1990, 1991 The Regents of the University of California.1.\" Copyright (c) 1983, 1990, 1991 The Regents of the University of California.
2.\" All rights reserved.2.\" All rights reserved.
3.\"3.\"
4.\" %%%LICENSE_START(BSD_4_CLAUSE_UCB)
4.\" Redistribution and use in source and binary forms, with or without5.\" Redistribution and use in source and binary forms, with or without
5.\" modification, are permitted provided that the following conditions6.\" modification, are permitted provided that the following conditions
6.\" are met:7.\" are met:
@@ -28,6 +29,7 @@
28.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY29.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
29.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF30.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
30.\" SUCH DAMAGE.31.\" SUCH DAMAGE.
32.\" %%%LICENSE_END
31.\"33.\"
32.\" Modified 1993-07-24 by Rik Faith <faith@cs.unc.edu>34.\" Modified 1993-07-24 by Rik Faith <faith@cs.unc.edu>
33.\" Modified 1996-10-21 by Eric S. Raymond <esr@thyrsus.com>35.\" Modified 1996-10-21 by Eric S. Raymond <esr@thyrsus.com>
@@ -38,7 +40,7 @@
38.\"40.\"
39.TH ACCEPT 2 2010-09-10 "Linux" "Linux Programmer's Manual"41.TH ACCEPT 2 2010-09-10 "Linux" "Linux Programmer's Manual"
40.SH NAME42.SH NAME
41accept \- accept a connection on a socket43accept, accept4 \- accept a connection on a socket
42.SH SYNOPSIS44.SH SYNOPSIS
43.nf45.nf
44.BR "#include <sys/types.h>" " /* See NOTES */"46.BR "#include <sys/types.h>" " /* See NOTES */"
@@ -175,14 +177,14 @@
175flag in177flag in
176.BR open (2)178.BR open (2)
177for reasons why this may be useful.179for reasons why this may be useful.
178.SH "RETURN VALUE"180.SH RETURN VALUE
179On success,181On success,
180these system calls return a nonnegative integer that is a descriptor182these system calls return a nonnegative integer that is a descriptor
181for the accepted socket.183for the accepted socket.
182On error, \-1 is returned, and184On error, \-1 is returned, and
183.I errno185.I errno
184is set appropriately.186is set appropriately.
185.SS "Error Handling"187.SS Error handling
186Linux188Linux
187.BR accept ()189.BR accept ()
188(and190(and
@@ -289,7 +291,7 @@
289.BR accept4 ()291.BR accept4 ()
290system call is available starting with Linux 2.6.28;292system call is available starting with Linux 2.6.28;
291support in glibc is available starting with version 2.10.293support in glibc is available starting with version 2.10.
292.SH "CONFORMING TO"294.SH CONFORMING TO
293.BR accept ():295.BR accept ():
294POSIX.1-2001,296POSIX.1-2001,
295SVr4, 4.4BSD,297SVr4, 4.4BSD,
@@ -376,7 +378,7 @@
376.SH EXAMPLE378.SH EXAMPLE
377See379See
378.BR bind (2).380.BR bind (2).
379.SH "SEE ALSO"381.SH SEE ALSO
380.BR bind (2),382.BR bind (2),
381.BR connect (2),383.BR connect (2),
382.BR listen (2),384.BR listen (2),
@@ -384,7 +386,7 @@
384.BR socket (2),386.BR socket (2),
385.BR socket (7)387.BR socket (7)
386.SH COLOPHON388.SH COLOPHON
387This page is part of release 3.44 of the Linux389This page is part of release 3.51 of the Linux
388.I man-pages390.I man-pages
389project.391project.
390A description of the project,392A description of the project,
391393
=== modified file 'man2/access.2'
--- man2/access.2 2012-11-16 10:33:14 +0000
+++ man2/access.2 2013-07-21 03:51:25 +0000
@@ -1,9 +1,8 @@
1.\" Hey Emacs! This file is -*- nroff -*- source.
2.\"
3.\" This manpage is Copyright (C) 1992 Drew Eckhardt;1.\" This manpage is Copyright (C) 1992 Drew Eckhardt;
4.\" 1993 Michael Haardt, Ian Jackson.2.\" and Copyright (C) 1993 Michael Haardt, Ian Jackson.
5.\" and Copyright (C) 2007 Michael Kerrisk <mtk.manpages@gmail.com>3.\" and Copyright (C) 2007 Michael Kerrisk <mtk.manpages@gmail.com>
6.\"4.\"
5.\" %%%LICENSE_START(VERBATIM)
7.\" Permission is granted to make and distribute verbatim copies of this6.\" Permission is granted to make and distribute verbatim copies of this
8.\" manual provided the copyright notice and this permission notice are7.\" manual provided the copyright notice and this permission notice are
9.\" preserved on all copies.8.\" preserved on all copies.
@@ -23,6 +22,7 @@
23.\"22.\"
24.\" Formatted or processed versions of this manual, if unaccompanied by23.\" Formatted or processed versions of this manual, if unaccompanied by
25.\" the source, must acknowledge the copyright and authors of this work.24.\" the source, must acknowledge the copyright and authors of this work.
25.\" %%%LICENSE_END
26.\"26.\"
27.\" Modified 1993-07-21 Rik Faith (faith@cs.unc.edu)27.\" Modified 1993-07-21 Rik Faith (faith@cs.unc.edu)
28.\" Modified 1994-08-21 by Michael Chastain (mec@shell.portal.com):28.\" Modified 1994-08-21 by Michael Chastain (mec@shell.portal.com):
@@ -40,7 +40,7 @@
40.\" Modified 2004-06-23 by Michael Kerrisk40.\" Modified 2004-06-23 by Michael Kerrisk
41.\" 2007-06-10, mtk, various parts rewritten, and added BUGS section.41.\" 2007-06-10, mtk, various parts rewritten, and added BUGS section.
42.\"42.\"
43.TH ACCESS 2 2010-10-24 "Linux" "Linux Programmer's Manual"43.TH ACCESS 2 2013-04-16 "Linux" "Linux Programmer's Manual"
44.SH NAME44.SH NAME
45access \- check real user's permissions for a file45access \- check real user's permissions for a file
46.SH SYNOPSIS46.SH SYNOPSIS
@@ -86,10 +86,18 @@
86check is successful for a regular file if execute permission86check is successful for a regular file if execute permission
87is enabled for any of the file owner, group, or other.87is enabled for any of the file owner, group, or other.
88.SH "RETURN VALUE"88.SH "RETURN VALUE"
89On success (all requested permissions granted), zero is returned.89On success (all requested permissions granted, or
90.I mode
91is
92.B F_OK
93and the file exists), zero is returned.
90On error (at least one bit in94On error (at least one bit in
91.I mode95.I mode
92asked for a permission that is denied, or some other error occurred),96asked for a permission that is denied, or
97.I mode
98is
99.B F_OK
100and the file does not exist, or some other error occurred),
93\-1 is returned, and101\-1 is returned, and
94.I errno102.I errno
95is set appropriately.103is set appropriately.
@@ -184,7 +192,7 @@
184.\" HPU-UX 11 and Tru64 5.1 do this.192.\" HPU-UX 11 and Tru64 5.1 do this.
185Linux does not do this.193Linux does not do this.
186.PP194.PP
187A file is only accessible if the permissions on each of the195A file is accessible only if the permissions on each of the
188directories in the path prefix of196directories in the path prefix of
189.I pathname197.I pathname
190grant search (i.e., execute) access.198grant search (i.e., execute) access.
@@ -204,6 +212,7 @@
204may not work correctly on NFS file systems with UID mapping enabled,212may not work correctly on NFS file systems with UID mapping enabled,
205because UID mapping is done on the server and hidden from the client,213because UID mapping is done on the server and hidden from the client,
206which checks permissions.214which checks permissions.
215Similar problems can occur to FUSE mounts.
207.SH BUGS216.SH BUGS
208In kernel 2.4 (and earlier) there is some strangeness in the handling of217In kernel 2.4 (and earlier) there is some strangeness in the handling of
209.B X_OK218.B X_OK
@@ -250,7 +259,7 @@
250.BR credentials (7),259.BR credentials (7),
251.BR path_resolution (7)260.BR path_resolution (7)
252.SH COLOPHON261.SH COLOPHON
253This page is part of release 3.44 of the Linux262This page is part of release 3.51 of the Linux
254.I man-pages263.I man-pages
255project.264project.
256A description of the project,265A description of the project,
257266
=== modified file 'man2/acct.2'
--- man2/acct.2 2012-11-16 10:33:14 +0000
+++ man2/acct.2 2013-07-21 03:51:25 +0000
@@ -1,9 +1,8 @@
1.\" Hey Emacs! This file is -*- nroff -*- source.
2.\"
3.\" Copyright (c) 1993 Michael Haardt1.\" Copyright (c) 1993 Michael Haardt
4.\" (michael@moria.de),2.\" (michael@moria.de),
5.\" Fri Apr 2 11:32:09 MET DST 19933.\" Fri Apr 2 11:32:09 MET DST 1993
6.\"4.\"
5.\" %%%LICENSE_START(GPLv2+_DOC_FULL)
7.\" This is free documentation; you can redistribute it and/or6.\" This is free documentation; you can redistribute it and/or
8.\" modify it under the terms of the GNU General Public License as7.\" modify it under the terms of the GNU General Public License as
9.\" published by the Free Software Foundation; either version 2 of8.\" published by the Free Software Foundation; either version 2 of
@@ -20,9 +19,9 @@
20.\" GNU General Public License for more details.19.\" GNU General Public License for more details.
21.\"20.\"
22.\" You should have received a copy of the GNU General Public21.\" You should have received a copy of the GNU General Public
23.\" License along with this manual; if not, write to the Free22.\" License along with this manual; if not, see
24.\" Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111,23.\" <http://www.gnu.org/licenses/>.
25.\" USA.24.\" %%%LICENSE_END
26.\"25.\"
27.\" Modified 1993-07-22 by Rik Faith <faith@cs.unc.edu>26.\" Modified 1993-07-22 by Rik Faith <faith@cs.unc.edu>
28.\" Modified 1993-08-10 by Alan Cox <iiitac@pyramid.swansea.ac.uk>27.\" Modified 1993-08-10 by Alan Cox <iiitac@pyramid.swansea.ac.uk>
@@ -57,7 +56,7 @@
57and records for each terminating process are appended to56and records for each terminating process are appended to
58\fIfilename\fP as it terminates.57\fIfilename\fP as it terminates.
59An argument of NULL causes accounting to be turned off.58An argument of NULL causes accounting to be turned off.
60.SH "RETURN VALUE"59.SH RETURN VALUE
61On success, zero is returned.60On success, zero is returned.
62On error, \-1 is returned, and61On error, \-1 is returned, and
63.I errno62.I errno
@@ -127,7 +126,7 @@
127.TP126.TP
128.B EUSERS127.B EUSERS
129There are no more free file structures or we ran out of memory.128There are no more free file structures or we ran out of memory.
130.SH "CONFORMING TO"129.SH CONFORMING TO
131SVr4, 4.3BSD (but not POSIX).130SVr4, 4.3BSD (but not POSIX).
132.\" SVr4 documents an EBUSY error condition, but no EISDIR or ENOSYS.131.\" SVr4 documents an EBUSY error condition, but no EISDIR or ENOSYS.
133.\" Also AIX and HP-UX document EBUSY (attempt is made132.\" Also AIX and HP-UX document EBUSY (attempt is made
@@ -140,10 +139,10 @@
140139
141The structure of the records written to the accounting file is described in140The structure of the records written to the accounting file is described in
142.BR acct (5).141.BR acct (5).
143.SH "SEE ALSO"142.SH SEE ALSO
144.BR acct (5)143.BR acct (5)
145.SH COLOPHON144.SH COLOPHON
146This page is part of release 3.44 of the Linux145This page is part of release 3.51 of the Linux
147.I man-pages146.I man-pages
148project.147project.
149A description of the project,148A description of the project,
150149
=== modified file 'man2/add_key.2'
--- man2/add_key.2 2012-11-16 10:33:14 +0000
+++ man2/add_key.2 2013-07-21 03:51:25 +0000
@@ -1,11 +1,12 @@
1.\"
2.\" Copyright (C) 2006 Red Hat, Inc. All Rights Reserved.1.\" Copyright (C) 2006 Red Hat, Inc. All Rights Reserved.
3.\" Written by David Howells (dhowells@redhat.com)2.\" Written by David Howells (dhowells@redhat.com)
4.\"3.\"
4.\" %%%LICENSE_START(GPLv2+_SW_ONEPARA)
5.\" This program is free software; you can redistribute it and/or5.\" This program is free software; you can redistribute it and/or
6.\" modify it under the terms of the GNU General Public License6.\" modify it under the terms of the GNU General Public License
7.\" as published by the Free Software Foundation; either version7.\" as published by the Free Software Foundation; either version
8.\" 2 of the License, or (at your option) any later version.8.\" 2 of the License, or (at your option) any later version.
9.\" %%%LICENSE_END
9.\"10.\"
10.TH ADD_KEY 2 2010-02-25 Linux "Linux Key Management Calls"11.TH ADD_KEY 2 2010-02-25 Linux "Linux Key Management Calls"
11.SH NAME12.SH NAME
@@ -75,15 +76,12 @@
75.RB \*(lq afs:mykey \*(rq).76.RB \*(lq afs:mykey \*(rq).
76The77The
77.I payload78.I payload
78may be empty or79may be empty or NULL for keys of this type.
79.B NULL
80for keys of this type.
81.TP80.TP
82.B \*(lqkeyring\*(rq81.B \*(lqkeyring\*(rq
83Keyrings are special key types that may contain links to sequences of other82Keyrings are special key types that may contain links to sequences of other
84keys of any type.83keys of any type.
85If this interface is used to create a keyring, then a84If this interface is used to create a keyring, then a NULL
86.B NULL
87.I payload85.I payload
88should be specified, and86should be specified, and
89.I plen87.I plen
@@ -92,8 +90,7 @@
92On success90On success
93.BR add_key ()91.BR add_key ()
94returns the serial number of the key it created or updated.92returns the serial number of the key it created or updated.
95On error, the value93On error, the value \-1
96.B -1
97will be returned and errno will have been set to an appropriate error.94will be returned and errno will have been set to an appropriate error.
98.SH ERRORS95.SH ERRORS
99.TP96.TP
@@ -131,7 +128,7 @@
131.BR keyctl (2),128.BR keyctl (2),
132.BR request_key (2)129.BR request_key (2)
133.SH COLOPHON130.SH COLOPHON
134This page is part of release 3.44 of the Linux131This page is part of release 3.51 of the Linux
135.I man-pages132.I man-pages
136project.133project.
137A description of the project,134A description of the project,
138135
=== modified file 'man2/adjtimex.2'
--- man2/adjtimex.2 2012-11-16 10:33:14 +0000
+++ man2/adjtimex.2 2013-07-21 03:51:25 +0000
@@ -1,7 +1,6 @@
1.\" Hey Emacs! This file is -*- nroff -*- source.
2.\"
3.\" Copyright (c) 1995 Michael Chastain (mec@shell.portal.com), 15 April 1995.1.\" Copyright (c) 1995 Michael Chastain (mec@shell.portal.com), 15 April 1995.
4.\"2.\"
3.\" %%%LICENSE_START(GPLv2+_DOC_FULL)
5.\" This is free documentation; you can redistribute it and/or4.\" This is free documentation; you can redistribute it and/or
6.\" modify it under the terms of the GNU General Public License as5.\" modify it under the terms of the GNU General Public License as
7.\" published by the Free Software Foundation; either version 2 of6.\" published by the Free Software Foundation; either version 2 of
@@ -18,9 +17,9 @@
18.\" GNU General Public License for more details.17.\" GNU General Public License for more details.
19.\"18.\"
20.\" You should have received a copy of the GNU General Public19.\" You should have received a copy of the GNU General Public
21.\" License along with this manual; if not, write to the Free20.\" License along with this manual; if not, see
22.\" Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111,21.\" <http://www.gnu.org/licenses/>.
23.\" USA.22.\" %%%LICENSE_END
24.\"23.\"
25.\" Modified 1997-01-31 by Eric S. Raymond <esr@thyrsus.com>24.\" Modified 1997-01-31 by Eric S. Raymond <esr@thyrsus.com>
26.\" Modified 1997-07-30 by Paul Slootman <paul@wurtel.demon.nl>25.\" Modified 1997-07-30 by Paul Slootman <paul@wurtel.demon.nl>
@@ -91,7 +90,7 @@
91Only the superuser may set any parameters.90Only the superuser may set any parameters.
92.br91.br
93.ne 12v92.ne 12v
94.SH "RETURN VALUE"93.SH RETURN VALUE
95On success,94On success,
96.BR adjtimex ()95.BR adjtimex ()
97returns the clock state:96returns the clock state:
@@ -140,7 +139,7 @@
140Under Linux the139Under Linux the
141.B CAP_SYS_TIME140.B CAP_SYS_TIME
142capability is required.141capability is required.
143.SH "CONFORMING TO"142.SH CONFORMING TO
144.BR adjtimex ()143.BR adjtimex ()
145is Linux-specific and should not be used in programs144is Linux-specific and should not be used in programs
146intended to be portable.145intended to be portable.
@@ -148,13 +147,13 @@
148.BR adjtime (3)147.BR adjtime (3)
149for a more portable, but less flexible,148for a more portable, but less flexible,
150method of adjusting the system clock.149method of adjusting the system clock.
151.SH "SEE ALSO"150.SH SEE ALSO
152.BR settimeofday (2),151.BR settimeofday (2),
153.BR adjtime (3),152.BR adjtime (3),
154.BR capabilities (7),153.BR capabilities (7),
155.BR time (7)154.BR time (7)
156.SH COLOPHON155.SH COLOPHON
157This page is part of release 3.44 of the Linux156This page is part of release 3.51 of the Linux
158.I man-pages157.I man-pages
159project.158project.
160A description of the project,159A description of the project,
161160
=== modified file 'man2/alarm.2'
--- man2/alarm.2 2012-11-16 10:33:14 +0000
+++ man2/alarm.2 2013-07-21 03:51:25 +0000
@@ -1,8 +1,7 @@
1.\" Hey Emacs! This file is -*- nroff -*- source.
2.\"
3.\" This manpage is Copyright (C) 1992 Drew Eckhardt;1.\" This manpage is Copyright (C) 1992 Drew Eckhardt;
4.\" 1993 Michael Haardt, Ian Jackson.2.\" and Copyright (C) 1993 Michael Haardt, Ian Jackson.
5.\"3.\"
4.\" %%%LICENSE_START(VERBATIM)
6.\" Permission is granted to make and distribute verbatim copies of this5.\" Permission is granted to make and distribute verbatim copies of this
7.\" manual provided the copyright notice and this permission notice are6.\" manual provided the copyright notice and this permission notice are
8.\" preserved on all copies.7.\" preserved on all copies.
@@ -22,12 +21,13 @@
22.\"21.\"
23.\" Formatted or processed versions of this manual, if unaccompanied by22.\" Formatted or processed versions of this manual, if unaccompanied by
24.\" the source, must acknowledge the copyright and authors of this work.23.\" the source, must acknowledge the copyright and authors of this work.
24.\" %%%LICENSE_END
25.\"25.\"
26.\" Modified Wed Jul 21 19:42:57 1993 by Rik Faith <faith@cs.unc.edu>26.\" Modified Wed Jul 21 19:42:57 1993 by Rik Faith <faith@cs.unc.edu>
27.\" Modified Sun Jul 21 21:25:26 1996 by Andries Brouwer <aeb@cwi.nl>27.\" Modified Sun Jul 21 21:25:26 1996 by Andries Brouwer <aeb@cwi.nl>
28.\" Modified Wed Nov 6 03:46:05 1996 by Eric S. Raymond <esr@thyrsus.com>28.\" Modified Wed Nov 6 03:46:05 1996 by Eric S. Raymond <esr@thyrsus.com>
29.\"29.\"
30.TH ALARM 2 2008-06-12 "Linux" "Linux Programmer's Manual"30.TH ALARM 2 2013-04-18 "Linux" "Linux Programmer's Manual"
31.SH NAME31.SH NAME
32alarm \- set an alarm clock for delivery of a signal32alarm \- set an alarm clock for delivery of a signal
33.SH SYNOPSIS33.SH SYNOPSIS
@@ -46,19 +46,17 @@
4646
47If47If
48.I seconds48.I seconds
49is zero, no new49is zero, any pending alarm is cancelled.
50.BR alarm ()
51is scheduled.
5250
53In any event any previously set51In any event any previously set
54.BR alarm ()52.BR alarm ()
55is canceled.53is canceled.
56.SH "RETURN VALUE"54.SH RETURN VALUE
57.BR alarm ()55.BR alarm ()
58returns the number of seconds remaining until any previously scheduled56returns the number of seconds remaining until any previously scheduled
59alarm was due to be delivered, or zero if there was no previously57alarm was due to be delivered, or zero if there was no previously
60scheduled alarm.58scheduled alarm.
61.SH "CONFORMING TO"59.SH CONFORMING TO
62SVr4, POSIX.1-2001, 4.3BSD.60SVr4, POSIX.1-2001, 4.3BSD.
63.SH NOTES61.SH NOTES
64.BR alarm ()62.BR alarm ()
@@ -78,7 +76,7 @@
7876
79Scheduling delays can, as ever, cause the execution of the process to77Scheduling delays can, as ever, cause the execution of the process to
80be delayed by an arbitrary amount of time.78be delayed by an arbitrary amount of time.
81.SH "SEE ALSO"79.SH SEE ALSO
82.BR gettimeofday (2),80.BR gettimeofday (2),
83.BR pause (2),81.BR pause (2),
84.BR select (2),82.BR select (2),
@@ -88,7 +86,7 @@
88.BR sleep (3),86.BR sleep (3),
89.BR time (7)87.BR time (7)
90.SH COLOPHON88.SH COLOPHON
91This page is part of release 3.44 of the Linux89This page is part of release 3.51 of the Linux
92.I man-pages90.I man-pages
93project.91project.
94A description of the project,92A description of the project,
9593
=== modified file 'man2/alloc_hugepages.2'
--- man2/alloc_hugepages.2 2012-11-16 10:33:14 +0000
+++ man2/alloc_hugepages.2 2013-07-21 03:51:25 +0000
@@ -1,7 +1,6 @@
1.\" Hey Emacs! This file is -*- nroff -*- source.
2.\"
3.\" Copyright 2003 Andries E. Brouwer (aeb@cwi.nl)1.\" Copyright 2003 Andries E. Brouwer (aeb@cwi.nl)
4.\"2.\"
3.\" %%%LICENSE_START(VERBATIM)
5.\" Permission is granted to make and distribute verbatim copies of this4.\" Permission is granted to make and distribute verbatim copies of this
6.\" manual provided the copyright notice and this permission notice are5.\" manual provided the copyright notice and this permission notice are
7.\" preserved on all copies.6.\" preserved on all copies.
@@ -21,6 +20,7 @@
21.\"20.\"
22.\" Formatted or processed versions of this manual, if unaccompanied by21.\" Formatted or processed versions of this manual, if unaccompanied by
23.\" the source, must acknowledge the copyright and authors of this work.22.\" the source, must acknowledge the copyright and authors of this work.
23.\" %%%LICENSE_END
24.\"24.\"
25.TH ALLOC_HUGEPAGES 2 2007-05-31 "Linux" "Linux Programmer's Manual"25.TH ALLOC_HUGEPAGES 2 2007-05-31 "Linux" "Linux Programmer's Manual"
26.SH NAME26.SH NAME
@@ -106,7 +106,7 @@
106If this flag is not set, then106If this flag is not set, then
107.B ENOENT107.B ENOENT
108is returned when no segment with the given key exists.108is returned when no segment with the given key exists.
109.SH "RETURN VALUE"109.SH RETURN VALUE
110On success,110On success,
111.BR alloc_hugepages ()111.BR alloc_hugepages ()
112returns the allocated virtual address, and112returns the allocated virtual address, and
@@ -127,7 +127,7 @@
127.I /proc/meminfo127.I /proc/meminfo
128Gives info on the number of configured hugetlb pages and on their size128Gives info on the number of configured hugetlb pages and on their size
129in the three variables HugePages_Total, HugePages_Free, Hugepagesize.129in the three variables HugePages_Total, HugePages_Free, Hugepagesize.
130.SH "CONFORMING TO"130.SH CONFORMING TO
131These calls are specific to Linux on Intel processors, and should not be131These calls are specific to Linux on Intel processors, and should not be
132used in programs intended to be portable.132used in programs intended to be portable.
133.SH NOTES133.SH NOTES
@@ -148,7 +148,7 @@
148.\" mount -t hugetlbfs hugetlbfs /huge148.\" mount -t hugetlbfs hugetlbfs /huge
149.\" SHM_HUGETLB149.\" SHM_HUGETLB
150.SH COLOPHON150.SH COLOPHON
151This page is part of release 3.44 of the Linux151This page is part of release 3.51 of the Linux
152.I man-pages152.I man-pages
153project.153project.
154A description of the project,154A description of the project,
155155
=== modified file 'man2/arch_prctl.2'
--- man2/arch_prctl.2 2012-11-16 10:33:14 +0000
+++ man2/arch_prctl.2 2013-07-21 03:51:25 +0000
@@ -1,7 +1,6 @@
1.\" Hey Emacs! This file is -*- nroff -*- source.
2.\"
3.\" Copyright (C) 2003 Andi Kleen1.\" Copyright (C) 2003 Andi Kleen
4.\"2.\"
3.\" %%%LICENSE_START(VERBATIM)
5.\" Permission is granted to make and distribute verbatim copies of this4.\" Permission is granted to make and distribute verbatim copies of this
6.\" manual provided the copyright notice and this permission notice are5.\" manual provided the copyright notice and this permission notice are
7.\" preserved on all copies.6.\" preserved on all copies.
@@ -21,6 +20,8 @@
21.\"20.\"
22.\" Formatted or processed versions of this manual, if unaccompanied by21.\" Formatted or processed versions of this manual, if unaccompanied by
23.\" the source, must acknowledge the copyright and authors of this work.22.\" the source, must acknowledge the copyright and authors of this work.
23.\" %%%LICENSE_END
24.\"
24.TH ARCH_PRCTL 2 2007-12-26 "Linux" "Linux Programmer's Manual"25.TH ARCH_PRCTL 2 2007-12-26 "Linux" "Linux Programmer's Manual"
25.SH NAME26.SH NAME
26arch_prctl \- set architecture-specific thread state27arch_prctl \- set architecture-specific thread state
@@ -49,7 +50,7 @@
49.IR "unsigned long *" ,50.IR "unsigned long *" ,
50for the "get" operations.51for the "get" operations.
51.LP52.LP
52Sub functions for x86-64 are:53Subfunctions for x86-64 are:
53.TP54.TP
54.B ARCH_SET_FS55.B ARCH_SET_FS
55Set the 64-bit base for the56Set the 64-bit base for the
@@ -99,13 +100,13 @@
99is outside the process address space.100is outside the process address space.
100.\" .SH AUTHOR101.\" .SH AUTHOR
101.\" Man page written by Andi Kleen.102.\" Man page written by Andi Kleen.
102.SH "CONFORMING TO"103.SH CONFORMING TO
103.BR arch_prctl ()104.BR arch_prctl ()
104is a Linux/x86-64 extension and should not be used in programs intended105is a Linux/x86-64 extension and should not be used in programs intended
105to be portable.106to be portable.
106.SH NOTES107.SH NOTES
107.BR arch_prctl ()108.BR arch_prctl ()
108is only supported on Linux/x86-64 for 64-bit programs currently.109is supported only on Linux/x86-64 for 64-bit programs currently.
109110
110The 64-bit base changes when a new 32-bit segment selector is loaded.111The 64-bit base changes when a new 32-bit segment selector is loaded.
111112
@@ -120,7 +121,7 @@
120.BR set_thread_area (2)121.BR set_thread_area (2)
121system call in kernel 2.5 or later.122system call in kernel 2.5 or later.
122.BR arch_prctl ()123.BR arch_prctl ()
123is only needed when you want to set bases that are larger than 4GB.124is needed only when you want to set bases that are larger than 4GB.
124Memory in the first 2GB of address space can be allocated by using125Memory in the first 2GB of address space can be allocated by using
125.BR mmap (2)126.BR mmap (2)
126with the127with the
@@ -134,7 +135,7 @@
134135
135.I FS136.I FS
136may be already used by the threading library.137may be already used by the threading library.
137.SH "SEE ALSO"138.SH SEE ALSO
138.BR mmap (2),139.BR mmap (2),
139.BR modify_ldt (2),140.BR modify_ldt (2),
140.BR prctl (2),141.BR prctl (2),
@@ -142,7 +143,7 @@
142143
143AMD X86-64 Programmer's manual144AMD X86-64 Programmer's manual
144.SH COLOPHON145.SH COLOPHON
145This page is part of release 3.44 of the Linux146This page is part of release 3.51 of the Linux
146.I man-pages147.I man-pages
147project.148project.
148A description of the project,149A description of the project,
149150
=== modified file 'man2/bdflush.2'
--- man2/bdflush.2 2012-11-16 10:33:14 +0000
+++ man2/bdflush.2 2013-07-21 03:51:25 +0000
@@ -1,7 +1,6 @@
1.\" Hey Emacs! This file is -*- nroff -*- source.
2.\"
3.\" Copyright (c) 1995 Michael Chastain (mec@shell.portal.com), 15 April 1995.1.\" Copyright (c) 1995 Michael Chastain (mec@shell.portal.com), 15 April 1995.
4.\"2.\"
3.\" %%%LICENSE_START(GPLv2+_DOC_FULL)
5.\" This is free documentation; you can redistribute it and/or4.\" This is free documentation; you can redistribute it and/or
6.\" modify it under the terms of the GNU General Public License as5.\" modify it under the terms of the GNU General Public License as
7.\" published by the Free Software Foundation; either version 2 of6.\" published by the Free Software Foundation; either version 2 of
@@ -18,9 +17,9 @@
18.\" GNU General Public License for more details.17.\" GNU General Public License for more details.
19.\"18.\"
20.\" You should have received a copy of the GNU General Public19.\" You should have received a copy of the GNU General Public
21.\" License along with this manual; if not, write to the Free20.\" License along with this manual; if not, see
22.\" Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111,21.\" <http://www.gnu.org/licenses/>.
23.\" USA.22.\" %%%LICENSE_END
24.\"23.\"
25.\" Modified 1997-01-31 by Eric S. Raymond <esr@thyrsus.com>24.\" Modified 1997-01-31 by Eric S. Raymond <esr@thyrsus.com>
26.\" Modified 2004-06-17 by Michael Kerrisk <mtk.manpages@gmail.com>25.\" Modified 2004-06-17 by Michael Kerrisk <mtk.manpages@gmail.com>
@@ -86,7 +85,7 @@
86The set of parameters, their values, and their valid ranges85The set of parameters, their values, and their valid ranges
87are defined in the Linux kernel source file86are defined in the Linux kernel source file
88.IR fs/buffer.c .87.IR fs/buffer.c .
89.SH "RETURN VALUE"88.SH RETURN VALUE
90If89If
91.I func90.I func
92is negative or 0 and the daemon successfully starts,91is negative or 0 and the daemon successfully starts,
@@ -113,17 +112,17 @@
113Caller does not have the112Caller does not have the
114.B CAP_SYS_ADMIN113.B CAP_SYS_ADMIN
115capability.114capability.
116.SH "CONFORMING TO"115.SH CONFORMING TO
117.BR bdflush ()116.BR bdflush ()
118is Linux-specific and should not be used in programs117is Linux-specific and should not be used in programs
119intended to be portable.118intended to be portable.
120.SH "SEE ALSO"119.SH SEE ALSO
121.BR fsync (2),120.BR fsync (2),
122.BR sync (2),121.BR sync (2),
123.BR sync (8),122.BR sync (8),
124.BR update (8)123.BR update (8)
125.SH COLOPHON124.SH COLOPHON
126This page is part of release 3.44 of the Linux125This page is part of release 3.51 of the Linux
127.I man-pages126.I man-pages
128project.127project.
129A description of the project,128A description of the project,
130129
=== modified file 'man2/bind.2'
--- man2/bind.2 2012-11-16 10:33:14 +0000
+++ man2/bind.2 2013-07-21 03:51:25 +0000
@@ -1,9 +1,8 @@
1.\" Hey Emacs! This file is -*- nroff -*- source.
2.\"
3.\" Copyright 1993 Rickard E. Faith (faith@cs.unc.edu)1.\" Copyright 1993 Rickard E. Faith (faith@cs.unc.edu)
4.\" Portions extracted from /usr/include/sys/socket.h, which does not have2.\" Portions extracted from /usr/include/sys/socket.h, which does not have
5.\" any authorship information in it. It is probably available under the GPL.3.\" any authorship information in it. It is probably available under the GPL.
6.\"4.\"
5.\" %%%LICENSE_START(VERBATIM)
7.\" Permission is granted to make and distribute verbatim copies of this6.\" Permission is granted to make and distribute verbatim copies of this
8.\" manual provided the copyright notice and this permission notice are7.\" manual provided the copyright notice and this permission notice are
9.\" preserved on all copies.8.\" preserved on all copies.
@@ -23,6 +22,7 @@
23.\"22.\"
24.\" Formatted or processed versions of this manual, if unaccompanied by23.\" Formatted or processed versions of this manual, if unaccompanied by
25.\" the source, must acknowledge the copyright and authors of this work.24.\" the source, must acknowledge the copyright and authors of this work.
25.\" %%%LICENSE_END
26.\"26.\"
27.\"27.\"
28.\" Other portions are from the 6.9 (Berkeley) 3/10/91 man page:28.\" Other portions are from the 6.9 (Berkeley) 3/10/91 man page:
@@ -30,6 +30,7 @@
30.\" Copyright (c) 1983 The Regents of the University of California.30.\" Copyright (c) 1983 The Regents of the University of California.
31.\" All rights reserved.31.\" All rights reserved.
32.\"32.\"
33.\" %%%LICENSE_START(BSD_4_CLAUSE_UCB)
33.\" Redistribution and use in source and binary forms, with or without34.\" Redistribution and use in source and binary forms, with or without
34.\" modification, are permitted provided that the following conditions35.\" modification, are permitted provided that the following conditions
35.\" are met:36.\" are met:
@@ -57,6 +58,7 @@
57.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY58.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
58.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF59.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
59.\" SUCH DAMAGE.60.\" SUCH DAMAGE.
61.\" %%%LICENSE_END
60.\"62.\"
61.\" Modified Mon Oct 21 23:05:29 EDT 1996 by Eric S. Raymond <esr@thyrsus.com>63.\" Modified Mon Oct 21 23:05:29 EDT 1996 by Eric S. Raymond <esr@thyrsus.com>
62.\" Modified 1998 by Andi Kleen64.\" Modified 1998 by Andi Kleen
@@ -147,7 +149,7 @@
147.I addr149.I addr
148in order to avoid compiler warnings.150in order to avoid compiler warnings.
149See EXAMPLE below.151See EXAMPLE below.
150.SH "RETURN VALUE"152.SH RETURN VALUE
151On success, zero is returned.153On success, zero is returned.
152On error, \-1 is returned, and154On error, \-1 is returned, and
153.I errno155.I errno
@@ -217,7 +219,7 @@
217.TP219.TP
218.B EROFS220.B EROFS
219The socket inode would reside on a read-only file system.221The socket inode would reside on a read-only file system.
220.SH "CONFORMING TO"222.SH CONFORMING TO
221SVr4, 4.4BSD, POSIX.1-2001223SVr4, 4.4BSD, POSIX.1-2001
222.RB ( bind ()224.RB ( bind ()
223first appeared in 4.2BSD).225first appeared in 4.2BSD).
@@ -314,7 +316,7 @@
314 should be deleted using unlink(2) or remove(3) */316 should be deleted using unlink(2) or remove(3) */
315}317}
316.fi318.fi
317.SH "SEE ALSO"319.SH SEE ALSO
318.BR accept (2),320.BR accept (2),
319.BR connect (2),321.BR connect (2),
320.BR getsockname (2),322.BR getsockname (2),
@@ -328,7 +330,7 @@
328.BR socket (7),330.BR socket (7),
329.BR unix (7)331.BR unix (7)
330.SH COLOPHON332.SH COLOPHON
331This page is part of release 3.44 of the Linux333This page is part of release 3.51 of the Linux
332.I man-pages334.I man-pages
333project.335project.
334A description of the project,336A description of the project,
335337
=== modified file 'man2/brk.2'
--- man2/brk.2 2012-11-16 10:33:14 +0000
+++ man2/brk.2 2013-07-21 03:51:25 +0000
@@ -1,9 +1,8 @@
1.\" Hey Emacs! This file is -*- nroff -*- source.
2.\"
3.\" Copyright (c) 1993 Michael Haardt1.\" Copyright (c) 1993 Michael Haardt
4.\" (michael@moria.de),2.\" (michael@moria.de),
5.\" Fri Apr 2 11:32:09 MET DST 19933.\" Fri Apr 2 11:32:09 MET DST 1993
6.\"4.\"
5.\" %%%LICENSE_START(GPLv2+_DOC_FULL)
7.\" This is free documentation; you can redistribute it and/or6.\" This is free documentation; you can redistribute it and/or
8.\" modify it under the terms of the GNU General Public License as7.\" modify it under the terms of the GNU General Public License as
9.\" published by the Free Software Foundation; either version 2 of8.\" published by the Free Software Foundation; either version 2 of
@@ -20,9 +19,9 @@
20.\" GNU General Public License for more details.19.\" GNU General Public License for more details.
21.\"20.\"
22.\" You should have received a copy of the GNU General Public21.\" You should have received a copy of the GNU General Public
23.\" License along with this manual; if not, write to the Free22.\" License along with this manual; if not, see
24.\" Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111,23.\" <http://www.gnu.org/licenses/>.
25.\" USA.24.\" %%%LICENSE_END
26.\"25.\"
27.\" Modified Wed Jul 21 19:52:58 1993 by Rik Faith <faith@cs.unc.edu>26.\" Modified Wed Jul 21 19:52:58 1993 by Rik Faith <faith@cs.unc.edu>
28.\" Modified Sun Aug 21 17:40:38 1994 by Rik Faith <faith@cs.unc.edu>27.\" Modified Sun Aug 21 17:40:38 1994 by Rik Faith <faith@cs.unc.edu>
@@ -91,7 +90,7 @@
91with an90with an
92.I increment91.I increment
93of 0 can be used to find the current location of the program break.92of 0 can be used to find the current location of the program break.
94.SH "RETURN VALUE"93.SH RETURN VALUE
95On success,94On success,
96.BR brk ()95.BR brk ()
97returns zero.96returns zero.
@@ -112,7 +111,7 @@
112.I errno111.I errno
113is set to112is set to
114.BR ENOMEM .113.BR ENOMEM .
115.SH "CONFORMING TO"114.SH CONFORMING TO
1164.3BSD; SUSv1, marked LEGACY in SUSv2, removed in POSIX.1-2001.1154.3BSD; SUSv1, marked LEGACY in SUSv2, removed in POSIX.1-2001.
117.\"116.\"
118.\" .BR brk ()117.\" .BR brk ()
@@ -139,7 +138,7 @@
139.\" \fIptrdiff_t\fP (libc4, libc5, ulibc, glibc 2.0, 2.1),138.\" \fIptrdiff_t\fP (libc4, libc5, ulibc, glibc 2.0, 2.1),
140.\" \fIintptr_t\fP (e.g., XPGv5, AIX, SunOS 5.8, 5.9, FreeBSD 4.7, NetBSD 1.6,139.\" \fIintptr_t\fP (e.g., XPGv5, AIX, SunOS 5.8, 5.9, FreeBSD 4.7, NetBSD 1.6,
141.\" Tru64 5.1, glibc2.2).140.\" Tru64 5.1, glibc2.2).
142.SS Linux Notes141.SS Linux notes
143The return value described above for142The return value described above for
144.BR brk ()143.BR brk ()
145is the behavior provided by the glibc wrapper function for the Linux144is the behavior provided by the glibc wrapper function for the Linux
@@ -162,13 +161,13 @@
162.BR brk ()161.BR brk ()
163system call, and does some internal bookkeeping so that it can162system call, and does some internal bookkeeping so that it can
164return the old break value.163return the old break value.
165.SH "SEE ALSO"164.SH SEE ALSO
166.BR execve (2),165.BR execve (2),
167.BR getrlimit (2),166.BR getrlimit (2),
168.BR end (3),167.BR end (3),
169.BR malloc (3)168.BR malloc (3)
170.SH COLOPHON169.SH COLOPHON
171This page is part of release 3.44 of the Linux170This page is part of release 3.51 of the Linux
172.I man-pages171.I man-pages
173project.172project.
174A description of the project,173A description of the project,
175174
=== modified file 'man2/cacheflush.2'
--- man2/cacheflush.2 2012-11-16 10:33:14 +0000
+++ man2/cacheflush.2 2013-07-21 03:51:25 +0000
@@ -1,6 +1,7 @@
1.\" Written by Ralf Baechle (ralf@waldorf-gmbh.de),1.\" Written by Ralf Baechle (ralf@waldorf-gmbh.de),
2.\" Copyright (c) 1994, 1995 Waldorf GMBH2.\" Copyright (c) 1994, 1995 Waldorf GMBH
3.\"3.\"
4.\" %%%LICENSE_START(GPLv2+_DOC_FULL)
4.\" This is free documentation; you can redistribute it and/or5.\" This is free documentation; you can redistribute it and/or
5.\" modify it under the terms of the GNU General Public License as6.\" modify it under the terms of the GNU General Public License as
6.\" published by the Free Software Foundation; either version 2 of7.\" published by the Free Software Foundation; either version 2 of
@@ -17,9 +18,9 @@
17.\" GNU General Public License for more details.18.\" GNU General Public License for more details.
18.\"19.\"
19.\" You should have received a copy of the GNU General Public20.\" You should have received a copy of the GNU General Public
20.\" License along with this manual; if not, write to the Free21.\" License along with this manual; if not, see
21.\" Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111,22.\" <http://www.gnu.org/licenses/>.
22.\" USA.23.\" %%%LICENSE_END
23.\"24.\"
24.TH CACHEFLUSH 2 2007-05-26 "Linux" "Linux Programmer's Manual"25.TH CACHEFLUSH 2 2007-05-26 "Linux" "Linux Programmer's Manual"
25.SH NAME26.SH NAME
@@ -49,7 +50,7 @@
49.B BCACHE50.B BCACHE
50Same as51Same as
51.BR (ICACHE|DCACHE) .52.BR (ICACHE|DCACHE) .
52.SH "RETURN VALUE"53.SH RETURN VALUE
53.BR cacheflush ()54.BR cacheflush ()
54returns 0 on success or \-1 on error.55returns 0 on success or \-1 on error.
55If errors are detected,56If errors are detected,
@@ -72,7 +73,7 @@
72or73or
73.BR BCACHE .74.BR BCACHE .
74.SH CONFORMING TO75.SH CONFORMING TO
75This Linux-specific system call is only available on MIPS-based systems.76This Linux-specific system call is available only on MIPS-based systems.
76.\" FIXME This system call was only on MIPS back in 1.2 days, but77.\" FIXME This system call was only on MIPS back in 1.2 days, but
77.\" by now it is on a number of other architectures (but not i386).78.\" by now it is on a number of other architectures (but not i386).
78.\" Investigate the details and update this page.79.\" Investigate the details and update this page.
@@ -86,7 +87,7 @@
86arguments.87arguments.
87Therefore, the whole cache is always flushed.88Therefore, the whole cache is always flushed.
88.SH COLOPHON89.SH COLOPHON
89This page is part of release 3.44 of the Linux90This page is part of release 3.51 of the Linux
90.I man-pages91.I man-pages
91project.92project.
92A description of the project,93A description of the project,
9394
=== modified file 'man2/capget.2'
--- man2/capget.2 2012-11-16 10:33:14 +0000
+++ man2/capget.2 2013-07-21 03:51:25 +0000
@@ -1,5 +1,9 @@
1.\" written by Andrew Morgan <morgan@kernel.org>1.\" written by Andrew Morgan <morgan@kernel.org>
2.\"
3.\" %%%LICENSE_START(GPL_NOVERSION_ONELINE)
2.\" may be distributed as per GPL4.\" may be distributed as per GPL
5.\" %%%LICENSE_END
6.\"
3.\" Modified by David A. Wheeler <dwheeler@ida.org>7.\" Modified by David A. Wheeler <dwheeler@ida.org>
4.\" Modified 2004-05-27, mtk8.\" Modified 2004-05-27, mtk
5.\" Modified 2004-06-21, aeb9.\" Modified 2004-06-21, aeb
@@ -8,7 +12,7 @@
8.\" 64-bit capability sets in kernel 2.6.2[45].12.\" 64-bit capability sets in kernel 2.6.2[45].
9.\" Modified 2009-01-26, andi kleen13.\" Modified 2009-01-26, andi kleen
10.\"14.\"
11.TH CAPGET 2 2012-08-05 "Linux" "Linux Programmer's Manual"15.TH CAPGET 2 2013-03-11 "Linux" "Linux Programmer's Manual"
12.SH NAME16.SH NAME
13capget, capset \- set/get capabilities of thread(s)17capget, capset \- set/get capabilities of thread(s)
14.SH SYNOPSIS18.SH SYNOPSIS
@@ -29,11 +33,11 @@
29call, and a set of permitted capabilities33call, and a set of permitted capabilities
30that it can make effective or inheritable.34that it can make effective or inheritable.
31.PP35.PP
32These two functions are the raw kernel interface for getting and36These two system calls are the raw kernel interface for getting and
33setting thread capabilities.37setting thread capabilities.
34Not only are these system calls specific to Linux,38Not only are these system calls specific to Linux,
35but the kernel API is likely to change and use of39but the kernel API is likely to change and use of
36these functions (in particular the format of the40these system calls (in particular the format of the
37.I cap_user_*_t41.I cap_user_*_t
38types) is subject to extension with each kernel revision,42types) is subject to extension with each kernel revision,
39but old programs will keep working.43but old programs will keep working.
@@ -48,7 +52,7 @@
48.BR capsetp (3)52.BR capsetp (3)
49and53and
50.BR capgetp (3).54.BR capgetp (3).
51.SS "Current details"55.SS Current details
52Now that you have been warned, some current kernel details.56Now that you have been warned, some current kernel details.
53The structures are defined as follows.57The structures are defined as follows.
54.sp58.sp
@@ -73,11 +77,15 @@
73.fi77.fi
74.in -4n78.in -4n
75.sp79.sp
76.I effective, permitted, inheritable80The
77are bitmasks of the capabilities defined in81.IR effective ,
82.IR permitted ,
83and
84.I inheritable
85fields are bit masks of the capabilities defined in
78.I capability(7).86.I capability(7).
79Note the87Note the
80.I CAP_*88.B CAP_*
81values are bit indexes and need to be bit-shifted before ORing into89values are bit indexes and need to be bit-shifted before ORing into
82the bit fields.90the bit fields.
83To define the structures for passing to the system call you have to use the91To define the structures for passing to the system call you have to use the
@@ -108,7 +116,7 @@
108process ID with the116process ID with the
109.I hdrp->pid117.I hdrp->pid
110field value.118field value.
111.SS With VFS Capability Support119.SS With VFS capability support
112VFS Capability support creates a file-attribute method for adding120VFS Capability support creates a file-attribute method for adding
113capabilities to privileged executables.121capabilities to privileged executables.
114This privilege model obsoletes kernel support for one process122This privilege model obsoletes kernel support for one process
@@ -120,7 +128,7 @@
120are 0 or128are 0 or
121.BR getpid (2),129.BR getpid (2),
122which are equivalent.130which are equivalent.
123.SS Without VFS Capability Support131.SS Without VFS capability support
124When the kernel does not support VFS capabilities,132When the kernel does not support VFS capabilities,
125.BR capset ()133.BR capset ()
126calls can operate on the capabilities of the thread specified by the134calls can operate on the capabilities of the thread specified by the
@@ -149,7 +157,7 @@
149157
150For details on the data, see158For details on the data, see
151.BR capabilities (7).159.BR capabilities (7).
152.SH "RETURN VALUE"160.SH RETURN VALUE
153On success, zero is returned.161On success, zero is returned.
154On error, \-1 is returned, and162On error, \-1 is returned, and
155.I errno163.I errno
@@ -207,7 +215,7 @@
207.TP215.TP
208.B ESRCH216.B ESRCH
209No such thread.217No such thread.
210.SH "CONFORMING TO"218.SH CONFORMING TO
211These system calls are Linux-specific.219These system calls are Linux-specific.
212.SH NOTES220.SH NOTES
213The portable interface to the capability querying and setting221The portable interface to the capability querying and setting
@@ -215,14 +223,14 @@
215.I libcap223.I libcap
216library and is available here:224library and is available here:
217.br225.br
218.UR http://www.kernel.org\:/pub\:/linux\:/libs\:/security\:/linux-privs226.UR http://git.kernel.org/cgit\:/linux\:/kernel\:/git\:/morgan\:\:/libcap.git
219.UE227.UE
220.SH "SEE ALSO"228.SH SEE ALSO
221.BR clone (2),229.BR clone (2),
222.BR gettid (2),230.BR gettid (2),
223.BR capabilities (7)231.BR capabilities (7)
224.SH COLOPHON232.SH COLOPHON
225This page is part of release 3.44 of the Linux233This page is part of release 3.51 of the Linux
226.I man-pages234.I man-pages
227project.235project.
228A description of the project,236A description of the project,
229237
=== modified file 'man2/chdir.2'
--- man2/chdir.2 2012-11-16 10:33:14 +0000
+++ man2/chdir.2 2013-07-21 03:51:25 +0000
@@ -1,7 +1,6 @@
1.\" Hey Emacs! This file is -*- nroff -*- source.
2.\"
3.\" Copyright (c) 1992 Drew Eckhardt (drew@cs.colorado.edu), March 28, 19921.\" Copyright (c) 1992 Drew Eckhardt (drew@cs.colorado.edu), March 28, 1992
4.\"2.\"
3.\" %%%LICENSE_START(VERBATIM)
5.\" Permission is granted to make and distribute verbatim copies of this4.\" Permission is granted to make and distribute verbatim copies of this
6.\" manual provided the copyright notice and this permission notice are5.\" manual provided the copyright notice and this permission notice are
7.\" preserved on all copies.6.\" preserved on all copies.
@@ -21,6 +20,7 @@
21.\"20.\"
22.\" Formatted or processed versions of this manual, if unaccompanied by21.\" Formatted or processed versions of this manual, if unaccompanied by
23.\" the source, must acknowledge the copyright and authors of this work.22.\" the source, must acknowledge the copyright and authors of this work.
23.\" %%%LICENSE_END
24.\"24.\"
25.\" Modified by Michael Haardt <michael@moria.de>25.\" Modified by Michael Haardt <michael@moria.de>
26.\" Modified 1993-07-21 by Rik Faith <faith@cs.unc.edu>26.\" Modified 1993-07-21 by Rik Faith <faith@cs.unc.edu>
@@ -67,7 +67,7 @@
67.BR chdir ();67.BR chdir ();
68the only difference is that the directory is given as an68the only difference is that the directory is given as an
69open file descriptor.69open file descriptor.
70.SH "RETURN VALUE"70.SH RETURN VALUE
71On success, zero is returned.71On success, zero is returned.
72On error, \-1 is returned, and72On error, \-1 is returned, and
73.I errno73.I errno
@@ -122,7 +122,7 @@
122.B EBADF122.B EBADF
123.I fd123.I fd
124is not a valid file descriptor.124is not a valid file descriptor.
125.SH "CONFORMING TO"125.SH CONFORMING TO
126SVr4, 4.4BSD, POSIX.1-2001.126SVr4, 4.4BSD, POSIX.1-2001.
127.SH NOTES127.SH NOTES
128The current working directory is the starting point for interpreting128The current working directory is the starting point for interpreting
@@ -133,12 +133,12 @@
133inherits its parent's current working directory.133inherits its parent's current working directory.
134The current working directory is left unchanged by134The current working directory is left unchanged by
135.BR execve (2).135.BR execve (2).
136.SH "SEE ALSO"136.SH SEE ALSO
137.BR chroot (2),137.BR chroot (2),
138.BR getcwd (3),138.BR getcwd (3),
139.BR path_resolution (7)139.BR path_resolution (7)
140.SH COLOPHON140.SH COLOPHON
141This page is part of release 3.44 of the Linux141This page is part of release 3.51 of the Linux
142.I man-pages142.I man-pages
143project.143project.
144A description of the project,144A description of the project,
145145
=== modified file 'man2/chmod.2'
--- man2/chmod.2 2012-11-16 10:33:14 +0000
+++ man2/chmod.2 2013-07-21 03:51:25 +0000
@@ -1,7 +1,6 @@
1.\" Hey Emacs! This file is -*- nroff -*- source.
2.\"
3.\" Copyright (c) 1992 Drew Eckhardt (drew@cs.colorado.edu), March 28, 19921.\" Copyright (c) 1992 Drew Eckhardt (drew@cs.colorado.edu), March 28, 1992
4.\"2.\"
3.\" %%%LICENSE_START(VERBATIM)
5.\" Permission is granted to make and distribute verbatim copies of this4.\" Permission is granted to make and distribute verbatim copies of this
6.\" manual provided the copyright notice and this permission notice are5.\" manual provided the copyright notice and this permission notice are
7.\" preserved on all copies.6.\" preserved on all copies.
@@ -21,6 +20,7 @@
21.\"20.\"
22.\" Formatted or processed versions of this manual, if unaccompanied by21.\" Formatted or processed versions of this manual, if unaccompanied by
23.\" the source, must acknowledge the copyright and authors of this work.22.\" the source, must acknowledge the copyright and authors of this work.
23.\" %%%LICENSE_END
24.\"24.\"
25.\" Modified by Michael Haardt <michael@moria.de>25.\" Modified by Michael Haardt <michael@moria.de>
26.\" Modified 1993-07-21 by Rik Faith <faith@cs.unc.edu>26.\" Modified 1993-07-21 by Rik Faith <faith@cs.unc.edu>
@@ -150,7 +150,7 @@
150open files are maintained by the client.150open files are maintained by the client.
151Widening the permissions may be151Widening the permissions may be
152delayed for other clients if attribute caching is enabled on them.152delayed for other clients if attribute caching is enabled on them.
153.SH "RETURN VALUE"153.SH RETURN VALUE
154On success, zero is returned.154On success, zero is returned.
155On error, \-1 is returned, and155On error, \-1 is returned, and
156.I errno156.I errno
@@ -216,9 +216,9 @@
216.TP216.TP
217.B EROFS217.B EROFS
218See above.218See above.
219.SH "CONFORMING TO"219.SH CONFORMING TO
2204.4BSD, SVr4, POSIX.1-2001.2204.4BSD, SVr4, POSIX.1-2001.
221.SH "SEE ALSO"221.SH SEE ALSO
222.BR chown (2),222.BR chown (2),
223.BR execve (2),223.BR execve (2),
224.BR fchmodat (2),224.BR fchmodat (2),
@@ -226,7 +226,7 @@
226.BR stat (2),226.BR stat (2),
227.BR path_resolution (7)227.BR path_resolution (7)
228.SH COLOPHON228.SH COLOPHON
229This page is part of release 3.44 of the Linux229This page is part of release 3.51 of the Linux
230.I man-pages230.I man-pages
231project.231project.
232A description of the project,232A description of the project,
233233
=== modified file 'man2/chown.2'
--- man2/chown.2 2012-11-16 10:33:14 +0000
+++ man2/chown.2 2013-07-21 03:51:25 +0000
@@ -1,9 +1,8 @@
1.\" Hey Emacs! This file is -*- nroff -*- source.
2.\"
3.\" Copyright (c) 1992 Drew Eckhardt (drew@cs.colorado.edu), March 28, 19921.\" Copyright (c) 1992 Drew Eckhardt (drew@cs.colorado.edu), March 28, 1992
4.\" and Copyright (c) 1998 Andries Brouwer (aeb@cwi.nl)2.\" and Copyright (c) 1998 Andries Brouwer (aeb@cwi.nl)
5.\" and Copyright (c) 2007, 2008 Michael Kerrisk <mtk.manpages@gmail.com>3.\" and Copyright (c) 2007, 2008 Michael Kerrisk <mtk.manpages@gmail.com>
6.\"4.\"
5.\" %%%LICENSE_START(VERBATIM)
7.\" Permission is granted to make and distribute verbatim copies of this6.\" Permission is granted to make and distribute verbatim copies of this
8.\" manual provided the copyright notice and this permission notice are7.\" manual provided the copyright notice and this permission notice are
9.\" preserved on all copies.8.\" preserved on all copies.
@@ -23,6 +22,7 @@
23.\"22.\"
24.\" Formatted or processed versions of this manual, if unaccompanied by23.\" Formatted or processed versions of this manual, if unaccompanied by
25.\" the source, must acknowledge the copyright and authors of this work.24.\" the source, must acknowledge the copyright and authors of this work.
25.\" %%%LICENSE_END
26.\"26.\"
27.\" Modified by Michael Haardt <michael@moria.de>27.\" Modified by Michael Haardt <michael@moria.de>
28.\" Modified 1993-07-21 by Rik Faith <faith@cs.unc.edu>28.\" Modified 1993-07-21 by Rik Faith <faith@cs.unc.edu>
@@ -66,7 +66,7 @@
66.PD66.PD
67.SH DESCRIPTION67.SH DESCRIPTION
68These system calls change the owner and group of a file.68These system calls change the owner and group of a file.
69The differ only in how the file is specified:69They differ only in how the file is specified:
70.IP * 270.IP * 2
71.BR chown ()71.BR chown ()
72changes the ownership of the file specified by72changes the ownership of the file specified by
@@ -116,7 +116,7 @@
116.B S_ISGID116.B S_ISGID
117bit indicates mandatory locking, and is not cleared by a117bit indicates mandatory locking, and is not cleared by a
118.BR chown ().118.BR chown ().
119.SH "RETURN VALUE"119.SH RETURN VALUE
120On success, zero is returned.120On success, zero is returned.
121On error, \-1 is returned, and121On error, \-1 is returned, and
122.I errno122.I errno
@@ -178,11 +178,11 @@
178.TP178.TP
179.B EROFS179.B EROFS
180See above.180See above.
181.SH "CONFORMING TO"181.SH CONFORMING TO
1824.4BSD, SVr4, POSIX.1-2001.1824.4BSD, SVr4, POSIX.1-2001.
183183
184The 4.4BSD version can only be184The 4.4BSD version can be
185used by the superuser (that is, ordinary users cannot give away files).185used only by the superuser (that is, ordinary users cannot give away files).
186.\" chown():186.\" chown():
187.\" SVr4 documents EINVAL, EINTR, ENOLINK and EMULTIHOP returns, but no187.\" SVr4 documents EINVAL, EINTR, ENOLINK and EMULTIHOP returns, but no
188.\" ENOMEM. POSIX.1 does not document ENOMEM or ELOOP error conditions.188.\" ENOMEM. POSIX.1 does not document ENOMEM or ELOOP error conditions.
@@ -333,14 +333,14 @@
333 exit(EXIT_SUCCESS);333 exit(EXIT_SUCCESS);
334}334}
335.fi335.fi
336.SH "SEE ALSO"336.SH SEE ALSO
337.BR chmod (2),337.BR chmod (2),
338.BR fchownat (2),338.BR fchownat (2),
339.BR flock (2),339.BR flock (2),
340.BR path_resolution (7),340.BR path_resolution (7),
341.BR symlink (7)341.BR symlink (7)
342.SH COLOPHON342.SH COLOPHON
343This page is part of release 3.44 of the Linux343This page is part of release 3.51 of the Linux
344.I man-pages344.I man-pages
345project.345project.
346A description of the project,346A description of the project,
347347
=== modified file 'man2/chroot.2'
--- man2/chroot.2 2012-11-16 10:33:14 +0000
+++ man2/chroot.2 2013-07-21 03:51:25 +0000
@@ -1,7 +1,6 @@
1.\" Hey Emacs! This file is -*- nroff -*- source.
2.\"
3.\" Copyright (c) 1992 Drew Eckhardt (drew@cs.colorado.edu), March 28, 19921.\" Copyright (c) 1992 Drew Eckhardt (drew@cs.colorado.edu), March 28, 1992
4.\"2.\"
3.\" %%%LICENSE_START(VERBATIM)
5.\" Permission is granted to make and distribute verbatim copies of this4.\" Permission is granted to make and distribute verbatim copies of this
6.\" manual provided the copyright notice and this permission notice are5.\" manual provided the copyright notice and this permission notice are
7.\" preserved on all copies.6.\" preserved on all copies.
@@ -21,6 +20,7 @@
21.\"20.\"
22.\" Formatted or processed versions of this manual, if unaccompanied by21.\" Formatted or processed versions of this manual, if unaccompanied by
23.\" the source, must acknowledge the copyright and authors of this work.22.\" the source, must acknowledge the copyright and authors of this work.
23.\" %%%LICENSE_END
24.\"24.\"
25.\" Modified by Michael Haardt <michael@moria.de>25.\" Modified by Michael Haardt <michael@moria.de>
26.\" Modified 1993-07-21 by Rik Faith <faith@cs.unc.edu>26.\" Modified 1993-07-21 by Rik Faith <faith@cs.unc.edu>
@@ -87,7 +87,7 @@
8787
88This call does not close open file descriptors, and such file88This call does not close open file descriptors, and such file
89descriptors may allow access to files outside the chroot tree.89descriptors may allow access to files outside the chroot tree.
90.SH "RETURN VALUE"90.SH RETURN VALUE
91On success, zero is returned.91On success, zero is returned.
92On error, \-1 is returned, and92On error, \-1 is returned, and
93.I errno93.I errno
@@ -131,7 +131,7 @@
131.TP131.TP
132.B EPERM132.B EPERM
133The caller has insufficient privilege.133The caller has insufficient privilege.
134.SH "CONFORMING TO"134.SH CONFORMING TO
135SVr4, 4.4BSD, SUSv2 (marked LEGACY).135SVr4, 4.4BSD, SUSv2 (marked LEGACY).
136This function is not part of POSIX.1-2001.136This function is not part of POSIX.1-2001.
137.\" SVr4 documents additional EINTR, ENOLINK and EMULTIHOP error conditions.137.\" SVr4 documents additional EINTR, ENOLINK and EMULTIHOP error conditions.
@@ -148,11 +148,11 @@
148system call.148system call.
149.\" FIXME . eventually say something about containers,149.\" FIXME . eventually say something about containers,
150.\" virtual servers, etc.?150.\" virtual servers, etc.?
151.SH "SEE ALSO"151.SH SEE ALSO
152.BR chdir (2),152.BR chdir (2),
153.BR path_resolution (7)153.BR path_resolution (7)
154.SH COLOPHON154.SH COLOPHON
155This page is part of release 3.44 of the Linux155This page is part of release 3.51 of the Linux
156.I man-pages156.I man-pages
157project.157project.
158A description of the project,158A description of the project,
159159
=== modified file 'man2/clock_getres.2'
--- man2/clock_getres.2 2012-11-16 10:33:14 +0000
+++ man2/clock_getres.2 2013-07-21 03:51:25 +0000
@@ -1,8 +1,7 @@
1.\" Hey Emacs! This file is -*- nroff -*- source.
2.\"
3.\" Copyright (c) 2003 Nick Clifford (zaf@nrc.co.nz), Jan 25, 20031.\" Copyright (c) 2003 Nick Clifford (zaf@nrc.co.nz), Jan 25, 2003
4.\" Copyright (c) 2003 Andries Brouwer (aeb@cwi.nl), Aug 24, 20032.\" Copyright (c) 2003 Andries Brouwer (aeb@cwi.nl), Aug 24, 2003
5.\"3.\"
4.\" %%%LICENSE_START(VERBATIM)
6.\" Permission is granted to make and distribute verbatim copies of this5.\" Permission is granted to make and distribute verbatim copies of this
7.\" manual provided the copyright notice and this permission notice are6.\" manual provided the copyright notice and this permission notice are
8.\" preserved on all copies.7.\" preserved on all copies.
@@ -22,14 +21,13 @@
22.\"21.\"
23.\" Formatted or processed versions of this manual, if unaccompanied by22.\" Formatted or processed versions of this manual, if unaccompanied by
24.\" the source, must acknowledge the copyright and authors of this work.23.\" the source, must acknowledge the copyright and authors of this work.
24.\" %%%LICENSE_END
25.\"25.\"
26.\" 2003-08-23 Martin Schulze <joey@infodrom.org> improvements26.\" 2003-08-23 Martin Schulze <joey@infodrom.org> improvements
27.\" 2003-08-24 aeb, large parts rewritten27.\" 2003-08-24 aeb, large parts rewritten
28.\" 2004-08-06 Christoph Lameter <clameter@sgi.com>, SMP note28.\" 2004-08-06 Christoph Lameter <clameter@sgi.com>, SMP note
29.\"29.\"
30.\" FIXME: Linux 2.6.39 adds CLOCK_BOOTTIME30.TH CLOCK_GETRES 2 2013-02-25 "" "Linux Programmer's Manual"
31.\"
32.TH CLOCK_GETRES 2 2012-11-07 "" "Linux Programmer's Manual"
33.SH NAME31.SH NAME
34clock_getres, clock_gettime, clock_settime \- clock and time functions32clock_getres, clock_gettime, clock_settime \- clock and time functions
35.SH SYNOPSIS33.SH SYNOPSIS
@@ -130,6 +128,13 @@
130.BR adjtime (3)128.BR adjtime (3)
131and NTP.129and NTP.
132.TP130.TP
131.BR CLOCK_REALTIME_COARSE " (since Linux 2.6.32; Linux-specific)"
132.\" Added in commit da15cfdae03351c689736f8d142618592e3cebc3
133A faster but less precise version of
134.BR CLOCK_REALTIME .
135Use when you need very fast, but not fine-grained timestamps.
136.TP
137.TP
133.B CLOCK_MONOTONIC138.B CLOCK_MONOTONIC
134Clock that cannot be set and represents monotonic time since139Clock that cannot be set and represents monotonic time since
135some unspecified starting point.140some unspecified starting point.
@@ -139,6 +144,12 @@
139.BR adjtime (3)144.BR adjtime (3)
140and NTP.145and NTP.
141.TP146.TP
147.BR CLOCK_MONOTONIC_COARSE " (since Linux 2.6.32; Linux-specific)"
148.\" Added in commit da15cfdae03351c689736f8d142618592e3cebc3
149A faster but less precise version of
150.BR CLOCK_MONOTONIC .
151Use when you need very fast, but not fine-grained timestamps.
152.TP
142.BR CLOCK_MONOTONIC_RAW " (since Linux 2.6.28; Linux-specific)"153.BR CLOCK_MONOTONIC_RAW " (since Linux 2.6.28; Linux-specific)"
143.\" Added in commit 2d42244ae71d6c7b0884b5664cf2eda30fb2ae68, John Stultz154.\" Added in commit 2d42244ae71d6c7b0884b5664cf2eda30fb2ae68, John Stultz
144Similar to155Similar to
@@ -148,12 +159,24 @@
148the incremental adjustments performed by159the incremental adjustments performed by
149.BR adjtime (3).160.BR adjtime (3).
150.TP161.TP
162.BR CLOCK_BOOTTIME " (since Linux 2.6.39; Linux-specific)"
163.\" commit 7fdd7f89006dd5a4c702fa0ce0c272345fa44ae0
164.\" commit 70a08cca1227dc31c784ec930099a4417a06e7d0
165Identical to
166.BR CLOCK_MONOTONIC ,
167except it also includes any time that the system is suspended.
168This allows applications to get a suspend-aware monotonic clock
169without having to deal with the complications of
170.BR CLOCK_REALTIME ,
171which may have discontinuities if the time is changed using
172.BR settimeofday (2).
173.TP
151.B CLOCK_PROCESS_CPUTIME_ID174.B CLOCK_PROCESS_CPUTIME_ID
152High-resolution per-process timer from the CPU.175High-resolution per-process timer from the CPU.
153.TP176.TP
154.B CLOCK_THREAD_CPUTIME_ID177.B CLOCK_THREAD_CPUTIME_ID
155Thread-specific CPU-time clock.178Thread-specific CPU-time clock.
156.SH "RETURN VALUE"179.SH RETURN VALUE
157.BR clock_gettime (),180.BR clock_gettime (),
158.BR clock_settime ()181.BR clock_settime ()
159and182and
@@ -178,7 +201,7 @@
178.B EPERM201.B EPERM
179.BR clock_settime ()202.BR clock_settime ()
180does not have permission to set the clock indicated.203does not have permission to set the clock indicated.
181.SH "CONFORMING TO"204.SH CONFORMING TO
182SUSv2, POSIX.1-2001.205SUSv2, POSIX.1-2001.
183.SH AVAILABILITY206.SH AVAILABILITY
184On POSIX systems on which these functions are available, the symbol207On POSIX systems on which these functions are available, the symbol
@@ -216,7 +239,7 @@
216will return239will return
217.B ENOENT240.B ENOENT
218to signify this condition.241to signify this condition.
219The two clocks will then only be useful if it242The two clocks will then be useful only if it
220can be ensured that a process stays on a certain CPU.243can be ensured that a process stays on a certain CPU.
221.PP244.PP
222The processors in an SMP system do not start all at exactly the same245The processors in an SMP system do not start all at exactly the same
@@ -237,7 +260,7 @@
237On Linux, these clocks are not settable260On Linux, these clocks are not settable
238(i.e., no process has "appropriate privileges").261(i.e., no process has "appropriate privileges").
239.\" See http://bugzilla.kernel.org/show_bug.cgi?id=11972262.\" See http://bugzilla.kernel.org/show_bug.cgi?id=11972
240.SH "SEE ALSO"263.SH SEE ALSO
241.BR date (1),264.BR date (1),
242.BR gettimeofday (2),265.BR gettimeofday (2),
243.BR settimeofday (2),266.BR settimeofday (2),
@@ -250,7 +273,7 @@
250.BR sysconf (3),273.BR sysconf (3),
251.BR time (7)274.BR time (7)
252.SH COLOPHON275.SH COLOPHON
253This page is part of release 3.44 of the Linux276This page is part of release 3.51 of the Linux
254.I man-pages277.I man-pages
255project.278project.
256A description of the project,279A description of the project,
257280
=== modified file 'man2/clock_nanosleep.2'
--- man2/clock_nanosleep.2 2012-11-16 10:33:14 +0000
+++ man2/clock_nanosleep.2 2013-07-21 03:51:25 +0000
@@ -1,6 +1,7 @@
1.\" Copyright (c) 2008, Linux Foundation, written by Michael Kerrisk1.\" Copyright (c) 2008, Linux Foundation, written by Michael Kerrisk
2.\" <mtk.manpages@gmail.com>2.\" <mtk.manpages@gmail.com>
3.\"3.\"
4.\" %%%LICENSE_START(VERBATIM)
4.\" Permission is granted to make and distribute verbatim copies of this5.\" Permission is granted to make and distribute verbatim copies of this
5.\" manual provided the copyright notice and this permission notice are6.\" manual provided the copyright notice and this permission notice are
6.\" preserved on all copies.7.\" preserved on all copies.
@@ -20,6 +21,7 @@
20.\"21.\"
21.\" Formatted or processed versions of this manual, if unaccompanied by22.\" Formatted or processed versions of this manual, if unaccompanied by
22.\" the source, must acknowledge the copyright and authors of this work.23.\" the source, must acknowledge the copyright and authors of this work.
24.\" %%%LICENSE_END
23.\"25.\"
24.TH CLOCK_NANOSLEEP 2 2012-11-07 "Linux" "Linux Programmer's Manual"26.TH CLOCK_NANOSLEEP 2 2012-11-07 "Linux" "Linux Programmer's Manual"
25.SH NAME27.SH NAME
@@ -141,7 +143,7 @@
141This value can then be used to call143This value can then be used to call
142.BR clock_nanosleep ()144.BR clock_nanosleep ()
143again and complete a (relative) sleep.145again and complete a (relative) sleep.
144.SH "RETURN VALUE"146.SH RETURN VALUE
145On successfully sleeping for the requested interval,147On successfully sleeping for the requested interval,
146.BR clock_nanosleep ()148.BR clock_nanosleep ()
147returns 0.149returns 0.
@@ -176,7 +178,7 @@
176.BR clock_nanosleep ()178.BR clock_nanosleep ()
177system call first appeared in Linux 2.6.179system call first appeared in Linux 2.6.
178Support is available in glibc since version 2.1.180Support is available in glibc since version 2.1.
179.SH "CONFORMING TO"181.SH CONFORMING TO
180POSIX.1-2001.182POSIX.1-2001.
181.SH NOTES183.SH NOTES
182If the interval specified in184If the interval specified in
@@ -242,7 +244,7 @@
242.BR clock_settime (2)244.BR clock_settime (2)
243shall have no effect on a thread that is blocked on a relative245shall have no effect on a thread that is blocked on a relative
244.BR clock_nanosleep ().246.BR clock_nanosleep ().
245.SH "SEE ALSO"247.SH SEE ALSO
246.BR clock_getres (2),248.BR clock_getres (2),
247.BR nanosleep (2),249.BR nanosleep (2),
248.BR timer_create (2),250.BR timer_create (2),
@@ -250,7 +252,7 @@
250.BR usleep (3),252.BR usleep (3),
251.BR time (7)253.BR time (7)
252.SH COLOPHON254.SH COLOPHON
253This page is part of release 3.44 of the Linux255This page is part of release 3.51 of the Linux
254.I man-pages256.I man-pages
255project.257project.
256A description of the project,258A description of the project,
257259
=== modified file 'man2/clone.2'
--- man2/clone.2 2012-11-16 10:33:14 +0000
+++ man2/clone.2 2013-07-21 03:51:25 +0000
@@ -1,8 +1,10 @@
1.\" Hey Emacs! This file is -*- nroff -*- source.
2.\"
3.\" Copyright (c) 1992 Drew Eckhardt <drew@cs.colorado.edu>, March 28, 19921.\" Copyright (c) 1992 Drew Eckhardt <drew@cs.colorado.edu>, March 28, 1992
4.\" and Copyright (c) Michael Kerrisk, 2001, 2002, 20052.\" and Copyright (c) Michael Kerrisk, 2001, 2002, 2005, 2013
3.\"
4.\" %%%LICENSE_START(GPL_NOVERSION_ONELINE)
5.\" May be distributed under the GNU General Public License.5.\" May be distributed under the GNU General Public License.
6.\" %%%LICENSE_END
7.\"
6.\" Modified by Michael Haardt <michael@moria.de>8.\" Modified by Michael Haardt <michael@moria.de>
7.\" Modified 24 Jul 1993 by Rik Faith <faith@cs.unc.edu>9.\" Modified 24 Jul 1993 by Rik Faith <faith@cs.unc.edu>
8.\" Modified 21 Aug 1994 by Michael Chastain <mec@shell.portal.com>:10.\" Modified 21 Aug 1994 by Michael Chastain <mec@shell.portal.com>:
@@ -40,37 +42,63 @@
40.\" FIXME Document CLONE_NEWUSER, which is new in 2.6.2342.\" FIXME Document CLONE_NEWUSER, which is new in 2.6.23
41.\" (also supported for unshare()?)43.\" (also supported for unshare()?)
42.\"44.\"
43.TH CLONE 2 2012-07-19 "Linux" "Linux Programmer's Manual"45.TH CLONE 2 2013-04-16 "Linux" "Linux Programmer's Manual"
44.SH NAME46.SH NAME
45clone, __clone2 \- create a child process47clone, __clone2 \- create a child process
46.SH SYNOPSIS48.SH SYNOPSIS
47.nf49.nf
48.BR "#define _GNU_SOURCE" " /* See feature_test_macros(7) */"50/* Prototype for the glibc wrapper function */
49.\" Actually _BSD_SOURCE || _SVID_SOURCE51
50.\" FIXME See http://sources.redhat.com/bugzilla/show_bug.cgi?id=4749
51.B #include <sched.h>52.B #include <sched.h>
5253
53.BI "int clone(int (*" "fn" ")(void *), void *" child_stack ,54.BI "int clone(int (*" "fn" ")(void *), void *" child_stack ,
54.BI " int " flags ", void *" "arg" ", ... "55.BI " int " flags ", void *" "arg" ", ... "
55.BI " /* pid_t *" ptid ", struct user_desc *" tls \56.BI " /* pid_t *" ptid ", struct user_desc *" tls \
56", pid_t *" ctid " */ );"57", pid_t *" ctid " */ );"
58
59/* Prototype for the raw system call */
60
61.BI "long clone(unsigned long " flags ", void *" child_stack ,
62.BI " void *" ptid ", void *" ctid ,
63.BI " struct pt_regs *" regs );
57.fi64.fi
65.sp
66.in -4n
67Feature Test Macro Requirements for glibc wrapper function (see
68.BR feature_test_macros (7)):
69.in
70.sp
71.BR clone ():
72.ad l
73.RS 4
74.PD 0
75.TP 4
76Since glibc 2.14:
77_GNU_SOURCE
78.TP 4
79.\" FIXME See http://sources.redhat.com/bugzilla/show_bug.cgi?id=4749
80Before glibc 2.14:
81_BSD_SOURCE || _SVID_SOURCE
82 /* _GNU_SOURCE also suffices */
83.PD
84.RE
85.ad b
58.SH DESCRIPTION86.SH DESCRIPTION
59.BR clone ()87.BR clone ()
60creates a new process, in a manner similar to88creates a new process, in a manner similar to
61.BR fork (2).89.BR fork (2).
62It is actually a library function layered on top of the underlying90
91This page describes both the glibc
63.BR clone ()92.BR clone ()
64system call, hereinafter referred to as93wrapper function and the underlying system call on which it is based.
65.BR sys_clone .94The main text describes the wrapper function;
66A description of95the differences for the raw system call
67.B sys_clone96are described toward the end of this page.
68is given toward the end of this page.
6997
70Unlike98Unlike
71.BR fork (2),99.BR fork (2),
72these calls100.BR clone ()
73allow the child process to share parts of its execution context with101allows the child process to share parts of its execution context with
74the calling process, such as the memory space, the table of file102the calling process, such as the memory space, the table of file
75descriptors, and the table of signal handlers.103descriptors, and the table of signal handlers.
76(Note that on this manual104(Note that on this manual
@@ -87,7 +115,6 @@
87When the child process is created with115When the child process is created with
88.BR clone (),116.BR clone (),
89it executes the function117it executes the function
90application
91.IR fn ( arg ).118.IR fn ( arg ).
92(This differs from119(This differs from
93.BR fork (2),120.BR fork (2),
@@ -167,7 +194,7 @@
167.I ctid194.I ctid
168in child memory.195in child memory.
169.TP196.TP
170.B CLONE_FILES197.BR CLONE_FILES " (since Linux 2.0)"
171If198If
172.B CLONE_FILES199.B CLONE_FILES
173is set, the calling process and the child process share the same file200is set, the calling process and the child process share the same file
@@ -194,7 +221,7 @@
194performed by either the calling221performed by either the calling
195process or the child process do not affect the other process.222process or the child process do not affect the other process.
196.TP223.TP
197.B CLONE_FS224.BR CLONE_FS " (since Linux 2.0)"
198If225If
199.B CLONE_FS226.B CLONE_FS
200is set, the caller and the child process share the same file system227is set, the caller and the child process share the same file system
@@ -261,19 +288,24 @@
261the calling process.288the calling process.
262This flag is intended for the implementation of containers.289This flag is intended for the implementation of containers.
263290
264An IPC namespace consists of the set of identifiers for291An IPC namespace provides an isolated view of System V IPC objects (see
265System V IPC objects.292.BR svipc (7))
266(These objects are created using293and (since Linux 2.6.30)
267.BR msgctl (2),294.\" commit 7eafd7c74c3f2e67c27621b987b28397110d643f
268.BR semctl (2),295.\" https://lwn.net/Articles/312232/
269and296POSIX message queues
270.BR shmctl (2)).297(see
298.BR mq_overview (7)).
299The common characteristic of these IPC mechanisms is that IPC
300objects are identified by mechanisms other than filesystem
301pathnames.
302
271Objects created in an IPC namespace are visible to all other processes303Objects created in an IPC namespace are visible to all other processes
272that are members of that namespace,304that are members of that namespace,
273but are not visible to processes in other IPC namespaces.305but are not visible to processes in other IPC namespaces.
274306
275When an IPC namespace is destroyed307When an IPC namespace is destroyed
276(i.e, when the last process that is a member of the namespace terminates),308(i.e., when the last process that is a member of the namespace terminates),
277all IPC objects in the namespace are automatically destroyed.309all IPC objects in the namespace are automatically destroyed.
278310
279Use of this flag requires: a kernel configured with the311Use of this flag requires: a kernel configured with the
@@ -287,7 +319,7 @@
287.TP319.TP
288.BR CLONE_NEWNET " (since Linux 2.6.24)"320.BR CLONE_NEWNET " (since Linux 2.6.24)"
289.\" FIXME Check when the implementation was completed321.\" FIXME Check when the implementation was completed
290(The implementation of this flag was only completed322(The implementation of this flag was completed only
291by about kernel version 2.6.29.)323by about kernel version 2.6.29.)
292324
293If325If
@@ -309,6 +341,7 @@
309A physical network device can live in exactly one341A physical network device can live in exactly one
310network namespace.342network namespace.
311A virtual network device ("veth") pair provides a pipe-like abstraction343A virtual network device ("veth") pair provides a pipe-like abstraction
344.\" FIXME Add pointer to veth(4) page when it is eventually completed
312that can be used to create tunnels between network namespaces,345that can be used to create tunnels between network namespaces,
313and can be used to create a bridge to a physical network device346and can be used to create a bridge to a physical network device
314in another namespace.347in another namespace.
@@ -515,7 +548,7 @@
515specified only by the system boot process (PID 0).548specified only by the system boot process (PID 0).
516It disappeared in Linux 2.5.16.549It disappeared in Linux 2.5.16.
517.TP550.TP
518.B CLONE_PTRACE551.BR CLONE_PTRACE " (since Linux 2.2)"
519If552If
520.B CLONE_PTRACE553.B CLONE_PTRACE
521is specified, and the calling process is being traced,554is specified, and the calling process is being traced,
@@ -529,7 +562,7 @@
529(See562(See
530.BR set_thread_area (2).)563.BR set_thread_area (2).)
531.TP564.TP
532.B CLONE_SIGHAND565.BR CLONE_SIGHAND " (since Linux 2.0)"
533If566If
534.B CLONE_SIGHAND567.B CLONE_SIGHAND
535is set, the calling process and the child process share the same table of568is set, the calling process and the child process share the same table of
@@ -714,7 +747,7 @@
714.B CLONE_PTRACE747.B CLONE_PTRACE
715on this child process.748on this child process.
716.TP749.TP
717.B CLONE_VFORK750.BR CLONE_VFORK " (since Linux 2.2)"
718If751If
719.B CLONE_VFORK752.B CLONE_VFORK
720is set, the execution of the calling process is suspended753is set, the execution of the calling process is suspended
@@ -732,7 +765,7 @@
732after the call, and an application should not rely on execution occurring765after the call, and an application should not rely on execution occurring
733in any particular order.766in any particular order.
734.TP767.TP
735.B CLONE_VM768.BR CLONE_VM " (since Linux 2.0)"
736If769If
737.B CLONE_VM770.B CLONE_VM
738is set, the calling process and the child process run in the same memory771is set, the calling process and the child process run in the same memory
@@ -753,9 +786,9 @@
753Memory writes or file mappings/unmappings performed by one of the786Memory writes or file mappings/unmappings performed by one of the
754processes do not affect the other, as with787processes do not affect the other, as with
755.BR fork (2).788.BR fork (2).
756.SS "sys_clone"789.SS The raw system call interface
757The790The raw
758.B sys_clone791.BR clone ()
759system call corresponds more closely to792system call corresponds more closely to
760.BR fork (2)793.BR fork (2)
761in that execution in the child continues from the point of the794in that execution in the child continues from the point of the
@@ -768,7 +801,7 @@
768.BR clone ()801.BR clone ()
769wrapper function are omitted.802wrapper function are omitted.
770Furthermore, the argument order changes.803Furthermore, the argument order changes.
771The raw system call interface is roughly:804The raw system call interface on x86 and many other architectures is roughly:
772.in +4805.in +4
773.nf806.nf
774807
@@ -778,9 +811,7 @@
778811
779.fi812.fi
780.in813.in
781Another difference for814Another difference for the raw system call is that the
782.B sys_clone
783is that the
784.I child_stack815.I child_stack
785argument may be zero, in which case copy-on-write semantics ensure that the816argument may be zero, in which case copy-on-write semantics ensure that the
786child gets separate copies of stack pages when either process modifies817child gets separate copies of stack pages when either process modifies
@@ -788,6 +819,50 @@
788In this case, for correct operation, the819In this case, for correct operation, the
789.B CLONE_VM820.B CLONE_VM
790option should not be specified.821option should not be specified.
822
823For some architectures, the order of the arguments for the system call
824differs from that shown above.
825On the score, microblaze, ARM, ARM 64, PA-RISC, arc, Power PC, xtensa,
826and MIPS architectures,
827the order of the fourth and fifth arguments is reversed.
828On the cris and s390 architectures,
829the order of the first and second arguments is reversed.
830.SS blackfin, m68k, and sparc
831The argument-passing conventions on
832blackfin, m68k, and sparc are different from descriptions above.
833For details, see the kernel (and glibc) source.
834.SS ia64
835On ia64, a different interface is used:
836.nf
837
838.BI "int __clone2(int (*" "fn" ")(void *), "
839.BI " void *" child_stack_base ", size_t " stack_size ,
840.BI " int " flags ", void *" "arg" ", ... "
841.BI " /* pid_t *" ptid ", struct user_desc *" tls \
842", pid_t *" ctid " */ );"
843.fi
844.PP
845The prototype shown above is for the glibc wrapper function;
846the raw system call interface has no
847.I fn
848or
849.I arg
850argument, and changes the order of the arguments so that
851.I flags
852is the first argument, and
853.I tls
854is the last argument.
855.PP
856.BR __clone2 ()
857operates in the same way as
858.BR clone (),
859except that
860.I child_stack_base
861points to the lowest address of the child's stack area,
862and
863.I stack_size
864specifies the size of the stack pointed to by
865.IR child_stack_base .
791.SS Linux 2.4 and earlier866.SS Linux 2.4 and earlier
792In Linux 2.4 and earlier,867In Linux 2.4 and earlier,
793.BR clone ()868.BR clone ()
@@ -796,7 +871,7 @@
796.IR tls ,871.IR tls ,
797and872and
798.IR ctid .873.IR ctid .
799.SH "RETURN VALUE"874.SH RETURN VALUE
800.\" gettid(2) returns current->pid;875.\" gettid(2) returns current->pid;
801.\" getpid(2) returns current->tgid;876.\" getpid(2) returns current->tgid;
802On success, the thread ID of the child process is returned877On success, the thread ID of the child process is returned
@@ -920,12 +995,9 @@
920glibc2 provides995glibc2 provides
921.BR clone ()996.BR clone ()
922as described in this manual page.997as described in this manual page.
923.SH "CONFORMING TO"998.SH CONFORMING TO
924The
925.BR clone ()999.BR clone ()
926and1000is Linux-specific and should not be used in programs
927.B sys_clone
928calls are Linux-specific and should not be used in programs
929intended to be portable.1001intended to be portable.
930.SH NOTES1002.SH NOTES
931In the kernel 2.4.x series,1003In the kernel 2.4.x series,
@@ -952,28 +1024,6 @@
952.BR clone ()1024.BR clone ()
953should not be called through vsyscall, but directly through1025should not be called through vsyscall, but directly through
954.IR "int $0x80" .1026.IR "int $0x80" .
955
956On ia64, a different system call is used:
957.nf
958
959.BI "int __clone2(int (*" "fn" ")(void *), "
960.BI " void *" child_stack_base ", size_t " stack_size ,
961.BI " int " flags ", void *" "arg" ", ... "
962.BI " /* pid_t *" ptid ", struct user_desc *" tls \
963", pid_t *" ctid " */ );"
964.fi
965.PP
966The
967.BR __clone2 ()
968system call operates in the same way as
969.BR clone (),
970except that
971.I child_stack_base
972points to the lowest address of the child's stack area,
973and
974.I stack_size
975specifies the size of the stack pointed to by
976.IR child_stack_base .
977.SH BUGS1027.SH BUGS
978Versions of the GNU C library that include the NPTL threading library1028Versions of the GNU C library that include the NPTL threading library
979contain a wrapper function for1029contain a wrapper function for
@@ -1016,20 +1066,120 @@
1016.\" See also the following bug reports1066.\" See also the following bug reports
1017.\" https://bugzilla.redhat.com/show_bug.cgi?id=4175211067.\" https://bugzilla.redhat.com/show_bug.cgi?id=417521
1018.\" http://sourceware.org/bugzilla/show_bug.cgi?id=69101068.\" http://sourceware.org/bugzilla/show_bug.cgi?id=6910
1019.SH "SEE ALSO"1069.SH EXAMPLE
1070.SS Create a child that executes in a separate UTS namespace
1071The following program demonstrates the use of
1072.BR clone ()
1073to create a child process that executes in a separate UTS namespace.
1074The child changes the hostname in its UTS namespace.
1075Both parent and child then display the system hostname,
1076making it possible to see that the hostname
1077differs in the UTS namespaces of the parent and child.
1078For an example of the use of this program, see
1079.BR setns (2).
1080
1081.nf
1082#define _GNU_SOURCE
1083#include <sys/wait.h>
1084#include <sys/utsname.h>
1085#include <sched.h>
1086#include <string.h>
1087#include <stdio.h>
1088#include <stdlib.h>
1089#include <unistd.h>
1090
1091#define errExit(msg) do { perror(msg); exit(EXIT_FAILURE); \\
1092 } while (0)
1093
1094static int /* Start function for cloned child */
1095childFunc(void *arg)
1096{
1097 struct utsname uts;
1098
1099 /* Change hostname in UTS namespace of child */
1100
1101 if (sethostname(arg, strlen(arg)) == \-1)
1102 errExit("sethostname");
1103
1104 /* Retrieve and display hostname */
1105
1106 if (uname(&uts) == \-1)
1107 errExit("uname");
1108 printf("uts.nodename in child: %s\\n", uts.nodename);
1109
1110 /* Keep the namespace open for a while, by sleeping.
1111 This allows some experimentation\-\-for example, another
1112 process might join the namespace. */
1113
1114 sleep(200);
1115
1116 return 0; /* Child terminates now */
1117}
1118
1119#define STACK_SIZE (1024 * 1024) /* Stack size for cloned child */
1120
1121int
1122main(int argc, char *argv[])
1123{
1124 char *stack; /* Start of stack buffer */
1125 char *stackTop; /* End of stack buffer */
1126 pid_t pid;
1127 struct utsname uts;
1128
1129 if (argc < 2) {
1130 fprintf(stderr, "Usage: %s <child\-hostname>\\n", argv[0]);
1131 exit(EXIT_SUCCESS);
1132 }
1133
1134 /* Allocate stack for child */
1135
1136 stack = malloc(STACK_SIZE);
1137 if (stack == NULL)
1138 errExit("malloc");
1139 stackTop = stack + STACK_SIZE; /* Assume stack grows downward */
1140
1141 /* Create child that has its own UTS namespace;
1142 child commences execution in childFunc() */
1143
1144 pid = clone(childFunc, stackTop, CLONE_NEWUTS | SIGCHLD, argv[1]);
1145 if (pid == \-1)
1146 errExit("clone");
1147 printf("clone() returned %ld\\n", (long) pid);
1148
1149 /* Parent falls through to here */
1150
1151 sleep(1); /* Give child time to change its hostname */
1152
1153 /* Display hostname in parent\(aqs UTS namespace. This will be
1154 different from hostname in child\(aqs UTS namespace. */
1155
1156 if (uname(&uts) == \-1)
1157 errExit("uname");
1158 printf("uts.nodename in parent: %s\\n", uts.nodename);
1159
1160 if (waitpid(pid, NULL, 0) == \-1) /* Wait for child */
1161 errExit("waitpid");
1162 printf("child has terminated\\n");
1163
1164 exit(EXIT_SUCCESS);
1165}
1166.fi
1167.SH SEE ALSO
1020.BR fork (2),1168.BR fork (2),
1021.BR futex (2),1169.BR futex (2),
1022.BR getpid (2),1170.BR getpid (2),
1023.BR gettid (2),1171.BR gettid (2),
1172.BR kcmp (2),
1024.BR set_thread_area (2),1173.BR set_thread_area (2),
1025.BR set_tid_address (2),1174.BR set_tid_address (2),
1175.BR setns (2),
1026.BR tkill (2),1176.BR tkill (2),
1027.BR unshare (2),1177.BR unshare (2),
1028.BR wait (2),1178.BR wait (2),
1029.BR capabilities (7),1179.BR capabilities (7),
1030.BR pthreads (7)1180.BR pthreads (7)
1031.SH COLOPHON1181.SH COLOPHON
1032This page is part of release 3.44 of the Linux1182This page is part of release 3.51 of the Linux
1033.I man-pages1183.I man-pages
1034project.1184project.
1035A description of the project,1185A description of the project,
10361186
=== modified file 'man2/close.2'
--- man2/close.2 2012-11-16 10:33:14 +0000
+++ man2/close.2 2013-07-21 03:51:25 +0000
@@ -1,8 +1,7 @@
1.\" Hey Emacs! This file is -*- nroff -*- source.
2.\"
3.\" This manpage is Copyright (C) 1992 Drew Eckhardt;1.\" This manpage is Copyright (C) 1992 Drew Eckhardt;
4.\" 1993 Michael Haardt, Ian Jackson.2.\" and Copyright (C) 1993 Michael Haardt, Ian Jackson.
5.\"3.\"
4.\" %%%LICENSE_START(VERBATIM)
6.\" Permission is granted to make and distribute verbatim copies of this5.\" Permission is granted to make and distribute verbatim copies of this
7.\" manual provided the copyright notice and this permission notice are6.\" manual provided the copyright notice and this permission notice are
8.\" preserved on all copies.7.\" preserved on all copies.
@@ -22,6 +21,7 @@
22.\"21.\"
23.\" Formatted or processed versions of this manual, if unaccompanied by22.\" Formatted or processed versions of this manual, if unaccompanied by
24.\" the source, must acknowledge the copyright and authors of this work.23.\" the source, must acknowledge the copyright and authors of this work.
24.\" %%%LICENSE_END
25.\"25.\"
26.\" Modified Wed Jul 21 22:40:25 1993 by Rik Faith <faith@cs.unc.edu>26.\" Modified Wed Jul 21 22:40:25 1993 by Rik Faith <faith@cs.unc.edu>
27.\" Modified Sat Feb 18 15:27:48 1995 by Michael Haardt27.\" Modified Sat Feb 18 15:27:48 1995 by Michael Haardt
@@ -61,7 +61,7 @@
61removed using61removed using
62.BR unlink (2)62.BR unlink (2)
63the file is deleted.63the file is deleted.
64.SH "RETURN VALUE"64.SH RETURN VALUE
65.BR close ()65.BR close ()
66returns zero on success.66returns zero on success.
67On error, \-1 is returned, and67On error, \-1 is returned, and
@@ -81,7 +81,7 @@
81.TP81.TP
82.B EIO82.B EIO
83An I/O error occurred.83An I/O error occurred.
84.SH "CONFORMING TO"84.SH CONFORMING TO
85SVr4, 4.3BSD, POSIX.1-2001.85SVr4, 4.3BSD, POSIX.1-2001.
86.\" SVr4 documents an additional ENOLINK error condition.86.\" SVr4 documents an additional ENOLINK error condition.
87.SH NOTES87.SH NOTES
@@ -122,7 +122,7 @@
122.\" call has restared after ERESTARTSYS, the original system call will122.\" call has restared after ERESTARTSYS, the original system call will
123.\" later restart with the reused file descriptor. This is most likely a123.\" later restart with the reused file descriptor. This is most likely a
124.\" serious programming error.124.\" serious programming error.
125.SH "SEE ALSO"125.SH SEE ALSO
126.BR fcntl (2),126.BR fcntl (2),
127.BR fsync (2),127.BR fsync (2),
128.BR open (2),128.BR open (2),
@@ -130,7 +130,7 @@
130.BR unlink (2),130.BR unlink (2),
131.BR fclose (3)131.BR fclose (3)
132.SH COLOPHON132.SH COLOPHON
133This page is part of release 3.44 of the Linux133This page is part of release 3.51 of the Linux
134.I man-pages134.I man-pages
135project.135project.
136A description of the project,136A description of the project,
137137
=== modified file 'man2/connect.2'
--- man2/connect.2 2012-11-16 10:33:14 +0000
+++ man2/connect.2 2013-07-21 03:51:25 +0000
@@ -1,9 +1,8 @@
1.\" Hey Emacs! This file is -*- nroff -*- source.
2.\"
3.\" Copyright 1993 Rickard E. Faith (faith@cs.unc.edu)1.\" Copyright 1993 Rickard E. Faith (faith@cs.unc.edu)
4.\" Portions extracted from /usr/include/sys/socket.h, which does not have2.\" Portions extracted from /usr/include/sys/socket.h, which does not have
5.\" any authorship information in it. It is probably available under the GPL.3.\" any authorship information in it. It is probably available under the GPL.
6.\"4.\"
5.\" %%%LICENSE_START(VERBATIM)
7.\" Permission is granted to make and distribute verbatim copies of this6.\" Permission is granted to make and distribute verbatim copies of this
8.\" manual provided the copyright notice and this permission notice are7.\" manual provided the copyright notice and this permission notice are
9.\" preserved on all copies.8.\" preserved on all copies.
@@ -23,6 +22,7 @@
23.\"22.\"
24.\" Formatted or processed versions of this manual, if unaccompanied by23.\" Formatted or processed versions of this manual, if unaccompanied by
25.\" the source, must acknowledge the copyright and authors of this work.24.\" the source, must acknowledge the copyright and authors of this work.
25.\" %%%LICENSE_END
26.\"26.\"
27.\"27.\"
28.\" Other portions are from the 6.9 (Berkeley) 3/10/91 man page:28.\" Other portions are from the 6.9 (Berkeley) 3/10/91 man page:
@@ -30,6 +30,7 @@
30.\" Copyright (c) 1983 The Regents of the University of California.30.\" Copyright (c) 1983 The Regents of the University of California.
31.\" All rights reserved.31.\" All rights reserved.
32.\"32.\"
33.\" %%%LICENSE_START(BSD_4_CLAUSE_UCB)
33.\" Redistribution and use in source and binary forms, with or without34.\" Redistribution and use in source and binary forms, with or without
34.\" modification, are permitted provided that the following conditions35.\" modification, are permitted provided that the following conditions
35.\" are met:36.\" are met:
@@ -57,6 +58,7 @@
57.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY58.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
58.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF59.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
59.\" SUCH DAMAGE.60.\" SUCH DAMAGE.
61.\" %%%LICENSE_END
60.\"62.\"
61.\" Modified 1997-01-31 by Eric S. Raymond <esr@thyrsus.com>63.\" Modified 1997-01-31 by Eric S. Raymond <esr@thyrsus.com>
62.\" Modified 1998, 1999 by Andi Kleen64.\" Modified 1998, 1999 by Andi Kleen
@@ -122,7 +124,7 @@
122set to124set to
123.BR AF_UNSPEC125.BR AF_UNSPEC
124(supported on Linux since kernel 2.2).126(supported on Linux since kernel 2.2).
125.SH "RETURN VALUE"127.SH RETURN VALUE
126If the connection or binding succeeds, zero is returned.128If the connection or binding succeeds, zero is returned.
127On error, \-1 is returned, and129On error, \-1 is returned, and
128.I errno130.I errno
@@ -220,7 +222,7 @@
220busy to accept new connections.222busy to accept new connections.
221Note that for IP sockets the timeout may223Note that for IP sockets the timeout may
222be very long when syncookies are enabled on the server.224be very long when syncookies are enabled on the server.
223.SH "CONFORMING TO"225.SH CONFORMING TO
224SVr4, 4.4BSD, (the226SVr4, 4.4BSD, (the
225.BR connect ()227.BR connect ()
226function first appeared in 4.2BSD), POSIX.1-2001.228function first appeared in 4.2BSD), POSIX.1-2001.
@@ -258,7 +260,7 @@
258.BR connect ()260.BR connect ()
259is shown in261is shown in
260.BR getaddrinfo (3).262.BR getaddrinfo (3).
261.SH "SEE ALSO"263.SH SEE ALSO
262.BR accept (2),264.BR accept (2),
263.BR bind (2),265.BR bind (2),
264.BR getsockname (2),266.BR getsockname (2),
@@ -266,7 +268,7 @@
266.BR socket (2),268.BR socket (2),
267.BR path_resolution (7)269.BR path_resolution (7)
268.SH COLOPHON270.SH COLOPHON
269This page is part of release 3.44 of the Linux271This page is part of release 3.51 of the Linux
270.I man-pages272.I man-pages
271project.273project.
272A description of the project,274A description of the project,
273275
=== modified file 'man2/create_module.2'
--- man2/create_module.2 2012-11-16 10:33:14 +0000
+++ man2/create_module.2 2013-07-21 03:51:25 +0000
@@ -1,6 +1,8 @@
1.\" Copyright (C) 1996 Free Software Foundation, Inc.1.\" Copyright (C) 1996 Free Software Foundation, Inc.
2.\"
3.\" %%%LICENSE_START(GPL_NOVERSION_ONELINE)
2.\" This file is distributed according to the GNU General Public License.4.\" This file is distributed according to the GNU General Public License.
3.\" See the file COPYING in the top level source directory for details.5.\" %%%LICENSE_END
4.\"6.\"
5.\" 2006-02-09, some reformatting by Luc Van Oostenryck; some7.\" 2006-02-09, some reformatting by Luc Van Oostenryck; some
6.\" reformatting and rewordings by mtk8.\" reformatting and rewordings by mtk
@@ -22,7 +24,7 @@
22attempts to create a loadable module entry and reserve the kernel memory24attempts to create a loadable module entry and reserve the kernel memory
23that will be needed to hold the module.25that will be needed to hold the module.
24This system call requires privilege.26This system call requires privilege.
25.SH "RETURN VALUE"27.SH RETURN VALUE
26On success, returns the kernel address at which the module will reside.28On success, returns the kernel address at which the module will reside.
27On error \-1 is returned and29On error \-1 is returned and
28.I errno30.I errno
@@ -54,18 +56,18 @@
54.B CAP_SYS_MODULE56.B CAP_SYS_MODULE
55capability).57capability).
56.SH VERSIONS58.SH VERSIONS
57This system call is only present on Linux up until kernel 2.4;59This system call is present on Linux only up until kernel 2.4;
58it was removed in Linux 2.6.60it was removed in Linux 2.6.
59.\" Removed in Linux 2.5.4861.\" Removed in Linux 2.5.48
60.SH "CONFORMING TO"62.SH CONFORMING TO
61.BR create_module ()63.BR create_module ()
62is Linux-specific.64is Linux-specific.
63.SH "SEE ALSO"65.SH SEE ALSO
64.BR delete_module (2),66.BR delete_module (2),
65.BR init_module (2),67.BR init_module (2),
66.BR query_module (2)68.BR query_module (2)
67.SH COLOPHON69.SH COLOPHON
68This page is part of release 3.44 of the Linux70This page is part of release 3.51 of the Linux
69.I man-pages71.I man-pages
70project.72project.
71A description of the project,73A description of the project,
7274
=== modified file 'man2/delete_module.2'
--- man2/delete_module.2 2012-11-16 10:33:14 +0000
+++ man2/delete_module.2 2013-07-21 03:51:25 +0000
@@ -1,5 +1,6 @@
1.\" Copyright (C) 2012 Michael Kerrisk <mtk.manpages@gmail.com>1.\" Copyright (C) 2012 Michael Kerrisk <mtk.manpages@gmail.com>
2.\"2.\"
3.\" %%%LICENSE_START(VERBATIM)
3.\" Permission is granted to make and distribute verbatim copies of this4.\" Permission is granted to make and distribute verbatim copies of this
4.\" manual provided the copyright notice and this permission notice are5.\" manual provided the copyright notice and this permission notice are
5.\" preserved on all copies.6.\" preserved on all copies.
@@ -19,8 +20,9 @@
19.\"20.\"
20.\" Formatted or processed versions of this manual, if unaccompanied by21.\" Formatted or processed versions of this manual, if unaccompanied by
21.\" the source, must acknowledge the copyright and authors of this work.22.\" the source, must acknowledge the copyright and authors of this work.
23.\" %%%LICENSE_END
22.\"24.\"
23.TH DELETE_MODULE 2 2012-10-24 "Linux" "Linux Programmer's Manual"25.TH DELETE_MODULE 2 2012-11-08 "Linux" "Linux Programmer's Manual"
24.SH NAME26.SH NAME
25delete_module \- unload a kernel module27delete_module \- unload a kernel module
26.SH SYNOPSIS28.SH SYNOPSIS
@@ -100,12 +102,11 @@
100The102The
101.B O_TRUNC103.B O_TRUNC
102flag has one further effect on the rules described above.104flag has one further effect on the rules described above.
103By default,105By default, if a module has an
104attempting to remove a module that has an
105.I init106.I init
106function but no107function but no
107.I exit108.I exit
108function fails.109function, then an attempt to remove the module will fail.
109However, if110However, if
110.BR O_TRUNC111.BR O_TRUNC
111was specified, this requirement is bypassed.112was specified, this requirement is bypassed.
@@ -116,11 +117,11 @@
116If the kernel was not built with117If the kernel was not built with
117.BR CONFIG_MODULE_FORCE_UNLOAD ,118.BR CONFIG_MODULE_FORCE_UNLOAD ,
118this flag is silently ignored.119this flag is silently ignored.
119(Normally ,120(Normally,
120.BR CONFIG_MODULE_FORCE_UNLOAD121.BR CONFIG_MODULE_FORCE_UNLOAD
121is enabled.)122is enabled.)
122Using this flag taints the kernel (TAINT_FORCED_RMMOD).123Using this flag taints the kernel (TAINT_FORCED_RMMOD).
123.SH "RETURN VALUE"124.SH RETURN VALUE
124On success, zero is returned.125On success, zero is returned.
125On error, \-1 is returned and126On error, \-1 is returned and
126.I errno127.I errno
@@ -139,7 +140,6 @@
139.B O_TRUNC140.B O_TRUNC
140was not specified in141was not specified in
141.IR flags .142.IR flags .
142
143.TP143.TP
144.B EFAULT144.B EFAULT
145.I name145.I name
@@ -169,7 +169,7 @@
169.B O_TRUNC169.B O_TRUNC
170was not specified in170was not specified in
171.IR flags .171.IR flags .
172.SH "CONFORMING TO"172.SH CONFORMING TO
173.BR delete_module ()173.BR delete_module ()
174is Linux-specific.174is Linux-specific.
175.SH NOTES175.SH NOTES
@@ -199,7 +199,7 @@
199in Linux 2.4 and earlier are199in Linux 2.4 and earlier are
200.I not200.I not
201currently explained in this manual page.201currently explained in this manual page.
202.SH "SEE ALSO"202.SH SEE ALSO
203.BR create_module (2),203.BR create_module (2),
204.BR init_module (2),204.BR init_module (2),
205.BR query_module (2),205.BR query_module (2),
@@ -207,7 +207,7 @@
207.BR modprobe (8),207.BR modprobe (8),
208.BR rmmod (8)208.BR rmmod (8)
209.SH COLOPHON209.SH COLOPHON
210This page is part of release 3.44 of the Linux210This page is part of release 3.51 of the Linux
211.I man-pages211.I man-pages
212project.212project.
213A description of the project,213A description of the project,
214214
=== modified file 'man2/dup.2'
--- man2/dup.2 2012-11-16 10:33:14 +0000
+++ man2/dup.2 2013-07-21 03:51:25 +0000
@@ -1,9 +1,8 @@
1.\" Hey Emacs! This file is -*- nroff -*- source.
2.\"
3.\" This manpage is Copyright (C) 1992 Drew Eckhardt;1.\" This manpage is Copyright (C) 1992 Drew Eckhardt;
4.\" and Copyright (C) 1993 Michael Haardt, Ian Jackson.2.\" and Copyright (C) 1993 Michael Haardt, Ian Jackson.
5.\" and Copyright (C) 2005, 2008 Michael Kerrisk <mtk.manpages@gmail.com>3.\" and Copyright (C) 2005, 2008 Michael Kerrisk <mtk.manpages@gmail.com>
6.\"4.\"
5.\" %%%LICENSE_START(VERBATIM)
7.\" Permission is granted to make and distribute verbatim copies of this6.\" Permission is granted to make and distribute verbatim copies of this
8.\" manual provided the copyright notice and this permission notice are7.\" manual provided the copyright notice and this permission notice are
9.\" preserved on all copies.8.\" preserved on all copies.
@@ -23,6 +22,7 @@
23.\"22.\"
24.\" Formatted or processed versions of this manual, if unaccompanied by23.\" Formatted or processed versions of this manual, if unaccompanied by
25.\" the source, must acknowledge the copyright and authors of this work.24.\" the source, must acknowledge the copyright and authors of this work.
25.\" %%%LICENSE_END
26.\"26.\"
27.\" Modified 1993-07-21, Rik Faith <faith@cs.unc.edu>27.\" Modified 1993-07-21, Rik Faith <faith@cs.unc.edu>
28.\" Modified 1994-08-21, Michael Chastain <mec@shell.portal.com>:28.\" Modified 1994-08-21, Michael Chastain <mec@shell.portal.com>:
@@ -117,7 +117,7 @@
117.BR dup3 ()117.BR dup3 ()
118fails with the error118fails with the error
119.BR EINVAL .119.BR EINVAL .
120.SH "RETURN VALUE"120.SH RETURN VALUE
121On success, these system calls121On success, these system calls
122return the new descriptor.122return the new descriptor.
123On error, \-1 is returned, and123On error, \-1 is returned, and
@@ -167,7 +167,7 @@
167was added to Linux in version 2.6.27;167was added to Linux in version 2.6.27;
168glibc support is available starting with168glibc support is available starting with
169version 2.9.169version 2.9.
170.SH "CONFORMING TO"170.SH CONFORMING TO
171.BR dup (),171.BR dup (),
172.BR dup2 ():172.BR dup2 ():
The diff has been truncated for viewing.

Subscribers

People subscribed via source and target branches

to all changes: