Commit Graph

138 Commits

Author SHA1 Message Date
Michael Kerrisk 726663fd9d bind.2, connect.2, create_module.2, delete_module.2, execve.2, get_robust_list.2, getpriority.2, getrusage.2, init_module.2, link.2, listen.2, mbind.2, open.2, poll.2, query_module.2, readlink.2, recv.2, remap_file_pages.2, sched_setaffinity.2, semop.2, send.2, stat.2, stime.2, syscall.2, pthread_attr_setstackaddr.3, pthread_attr_setstacksize.3, remquo.3, rtime.3, sched_getcpu.3, stpcpy.3, stpncpy.3, strcasecmp.3, system.3, fd.4, proc.5, ip.7: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-08 11:31:12 +02:00
Michael Kerrisk e39a52dbba ip.7: BUGS: ephemeral port range exhaustion is diagnosed inconsistently
Different system calls use different 'errno' values to diagnose
exhaustion of the ephemeral port range.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-08 11:26:55 +02:00
Michael Kerrisk 630459c88b ip.7: Remove BUGS text on glibc failing to declare in_pktinfo
That was long ago....

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-08 11:26:55 +02:00
Michael Kerrisk bd8838ad29 ip.7: Note some more details about assignment of ephemeral ports
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-08 11:26:55 +02:00
Michael Kerrisk 509c1c26f0 ip.7: Note cases where an ephemeral port is used
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-08 11:26:55 +02:00
Michael Kerrisk bb180c6283 ip.7: Clarify 'ip_local_port_range' and mention the term "ephemeral ports"
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-08 11:26:55 +02:00
Michael Kerrisk 33964ed992 ip.7: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-08 11:26:55 +02:00
Michael Kerrisk 99a230468c ip.7: Minor clarification for IP_TRANSPARENT
Based on an old email exchange with Balazs Scheidler.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-08 11:26:53 +02:00
Michael Kerrisk 2b9b829d52 time.1, get_kernel_syms.2, getitimer.2, open.2, perf_event_open.2, wait.2, alloca.3, bcmp.3, catopen.3, fputwc.3, iconv.3, iswalnum.3, iswalpha.3, iswblank.3, iswcntrl.3, iswctype.3, iswdigit.3, iswgraph.3, iswlower.3, iswprint.3, iswpunct.3, iswspace.3, iswupper.3, iswxdigit.3, mbsinit.3, putwchar.3, rcmd.3, rexec.3, sigqueue.3, strverscmp.3, wctrans.3, wctype.3, wcwidth.3, console_codes.4, initrd.4, st.4, elf.5, nss.5, ip.7, netdevice.7, path_resolution.7, socket.7, udp.7, ld.so.8: grfix: s/Otherwise /Otherwise, /
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-28 10:15:47 +02:00
Michael Kerrisk c284192003 ip.7: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-26 14:01:44 +01:00
Michael Kerrisk 0a9fd8a4b9 ip.7: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-26 07:33:17 +01:00
Michael Kerrisk 48b6f08669 ioctl_list.2, kill.2, nfsservctl.2, sched_setaffinity.2, sched_setparam.2, sched_setscheduler.2, syscall.2, fma.3, fmax.3, fmin.3, ip.7: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-09-17 08:27:30 +02:00
Simon Paillard 2f3365bd5d ip.7: IP_MULTICAST_IF setsockopt recognizes struct mreq (compatibility)
Kernel added compatibility only recently in
3a084ddb4bf299a6e898a9a07c89f3917f0713f7
See: http://bugs.debian.org/607979

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-08-09 10:16:47 +02:00
Michael Kerrisk ce7a8309b5 ip.7: Minor fixes for Radek Pazdera's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-04-16 07:26:27 +02:00
Radek Pazdera 95e1ffd564 ip.7: Document IP_MULTICAST_ALL
This commit adds documentation for the IP_MULTICAST_ALL socket
option.

The option was added to the Linux kernel in 2.6.31:

    Author Nivedita Singhvi <niv@us.ibm.com>
    Commit f771bef98004d9d141b085d987a77d06669d4f4f

The description is based on a previous one [3] posted by the
original author of the code -- Nivedita, but it is slightly
re-worded.

I tested it myself and it works as described.

References:
    [1] http://lxr.free-electrons.com/source/net/ipv4/ip_sockglue.c#L972
    [2] http://lxr.free-electrons.com/source/net/ipv4/igmp.c#L2267
    [3] http://patchwork.ozlabs.org/patch/28902/

Signed-off-by: Radek Pazdera <rpazdera@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-04-16 07:26:27 +02:00
Michael Kerrisk 33a0ccb293 intro.1, _syscall.2, access.2, arch_prctl.2, cacheflush.2, chown.2, clock_getres.2, clone.2, create_module.2, fcntl.2, flock.2, get_kernel_syms.2, get_robust_list.2, get_thread_area.2, getcpu.2, getpriority.2, getrlimit.2, getrusage.2, ioprio_set.2, kexec_load.2, madvise.2, mbind.2, migrate_pages.2, mknod.2, mmap.2, mount.2, move_pages.2, mprotect.2, open.2, pause.2, pciconfig_read.2, perf_event_open.2, prctl.2, ptrace.2, query_module.2, read.2, reboot.2, recv.2, s390_runtime_instr.2, sched_setscheduler.2, select_tut.2, send.2, set_mempolicy.2, setfsgid.2, setfsuid.2, sigaction.2, spu_create.2, spu_run.2, stime.2, swapon.2, syslog.2, timer_create.2, timer_getoverrun.2, times.2, tkill.2, umount.2, unimplemented.2, ustat.2, vm86.2, wait.2, abs.3, aio_read.3, aio_write.3, bsd_signal.3, catgets.3, clearenv.3, cmsg.3, dbopen.3, dirfd.3, dlopen.3, exec.3, fenv.3, ferror.3, fmemopen.3, fnmatch.3, fopen.3, futimes.3, getaddrinfo.3, getifaddrs.3, getipnodebyname.3, hsearch.3, if_nameindex.3, inet_pton.3, mblen.3, mbrlen.3, mbsrtowcs.3, mbtowc.3, mcheck.3, memfrob.3, mq_notify.3, netlink.3, posix_memalign.3, printf.3, pthread_attr_setscope.3, pthread_cleanup_push.3, pthread_kill_other_threads_np.3, pthread_self.3, pthread_setcancelstate.3, pthread_setconcurrency.3, raise.3, resolver.3, rpc.3, rtime.3, rtnetlink.3, scanf.3, setbuf.3, setnetgrent.3, shm_open.3, sigpause.3, sigset.3, sigwait.3, sockatmark.3, strcasecmp.3, strcmp.3, strdup.3, strftime.3, strptime.3, strsignal.3, strverscmp.3, sysv_signal.3, termios.3, wcrtomb.3, wcsnlen.3, wcsnrtombs.3, wcsrtombs.3, wctomb.3, wprintf.3, console_codes.4, cpuid.4, msr.4, rtc.4, sk98lin.4, st.4, tty.4, charmap.5, core.5, elf.5, hosts.equiv.5, proc.5, resolv.conf.5, services.5, slabinfo.5, arp.7, bootparam.7, capabilities.7, charsets.7, cpuset.7, ddp.7, epoll.7, feature_test_macros.7, futex.7, hier.7, icmp.7, inotify.7, ip.7, ipv6.7, man-pages.7, mdoc.7, mdoc.samples.7, netdevice.7, netlink.7, numa.7, packet.7, path_resolution.7, posixoptions.7, pthreads.7, raw.7, rtld-audit.7, rtnetlink.7, sem_overview.7, sigevent.7, socket.7, spufs.7, tcp.7, udp.7, unicode.7, uri.7, utf-8.7, intro.8, ldconfig.8, sync.8: Global fix: fix placement of word "only"
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-04-01 14:53:46 +02:00
Michael Kerrisk 6a717e5e3f networks.5, arp.7, cp1251.7, ddp.7, icmp.7, ip.7, ipv6.7, iso_8859-10.7, iso_8859-13.7, iso_8859-14.7, iso_8859-15.7, iso_8859-3.7, iso_8859-4.7, iso_8859-5.7, iso_8859-6.7, iso_8859-7.7, iso_8859-9.7, koi8-r.7, netdevice.7, netlink.7, packet.7, raw.7, rtnetlink.7, udp.7, x25.7, ld.so.8, sln.8, sync.8: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-03-12 12:28:50 +01:00
Michael Kerrisk 8ff7380d6f epoll_create.2, epoll_ctl.2, epoll_wait.2, eventfd.2, fallocate.2, futex.2, getcpu.2, getitimer.2, ioctl_list.2, ioprio_set.2, migrate_pages.2, move_pages.2, pciconfig_read.2, sendfile.2, setns.2, signalfd.2, spu_create.2, spu_run.2, sysinfo.2, timerfd_create.2, backtrace.3, cmsg.3, error.3, getpt.3, getrpcent.3, getrpcport.3, getsubopt.3, offsetof.3, program_invocation_name.3, rpc.3, rpmatch.3, rtnetlink.3, xdr.3, cciss.4, hpsa.4, pts.4, charmap.5, dir_colors.5, elf.5, gai.conf.5, locale.5, nscd.conf.5, nss.5, resolv.conf.5, rpc.5, arp.7, cpuset.7, ddp.7, epoll.7, fifo.7, futex.7, icmp.7, ip.7, ipv6.7, mailaddr.7, netdevice.7, packet.7, raw.7, regex.7, rtnetlink.7, socket.7, spufs.7, tcp.7, udp.7, unix.7, x25.7, ldconfig.8, nscd.8: Global fix: s/END_LICENSE/LICENSE_END/
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-03-12 10:31:09 +01:00
Michael Kerrisk e9e3c82b0f ip.7, netdevice.7, netlink.7, raw.7, rtnetlink.7, socket.7: srcfix: Remove redundant comment about /^.\" t/ line at top of page
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-03-10 10:57:12 +01:00
Michael Kerrisk 2297bf0ef5 ldd.1, capget.2, clone.2, create_module.2, fallocate.2, futex.2, get_kernel_syms.2, get_thread_area.2, getcpu.2, getitimer.2, getpid.2, io_cancel.2, io_destroy.2, io_getevents.2, io_setup.2, io_submit.2, ioctl_list.2, mkdir.2, mknod.2, pciconfig_read.2, pivot_root.2, posix_fadvise.2, query_module.2, sendfile.2, set_thread_area.2, setns.2, unshare.2, __setfpucw.3, a64l.3, addseverity.3, argz_add.3, bindresvport.3, cabs.3, cacos.3, cacosh.3, canonicalize_file_name.3, carg.3, casin.3, casinh.3, catan.3, catanh.3, ccos.3, ccosh.3, cerf.3, cexp.3, cexp2.3, cimag.3, clog.3, clog10.3, clog2.3, cmsg.3, conj.3, cpow.3, cproj.3, creal.3, csin.3, csinh.3, csqrt.3, ctan.3, ctanh.3, des_crypt.3, envz_add.3, fdim.3, fma.3, fmax.3, fmemopen.3, fmin.3, fmtmsg.3, fpclassify.3, gamma.3, getpt.3, getrpcent.3, getrpcport.3, getttyent.3, isgreater.3, key_setsecret.3, lgamma.3, malloc_hook.3, mempcpy.3, nan.3, netlink.3, nextafter.3, putgrent.3, remove.3, remquo.3, rpc.3, rtime.3, rtnetlink.3, setaliasent.3, setnetgrent.3, signbit.3, significand.3, sincos.3, stdin.3, tgamma.3, xcrypt.3, xdr.3, cciss.4, hpsa.4, mouse.4, pts.4, sk98lin.4, tty_ioctl.4, wavelan.4, hosts.equiv.5, rpc.5, tzfile.5, boot.7, complex.7, ddp.7, fifo.7, futex.7, icmp.7, ip.7, ipv6.7, netdevice.7, netlink.7, packet.7, raw.7, rtnetlink.7, socket.7, tcp.7, udp.7, unix.7, x25.7, sync.8: Global fix: Put copyright info at top of page, followed by blank line and LICENSE
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-03-10 10:57:11 +01:00
Michael Kerrisk 00acdba18c getcpu.2, sendfile.2, cmsg.3, rtnetlink.3, arp.7, ddp.7, fifo.7, icmp.7, ip.7, ipv6.7, netdevice.7, packet.7, raw.7, rtnetlink.7, socket.7, tcp.7, udp.7, unix.7, x25.7: LICENSE_START(VERBATIM_ONE_PARA)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-03-10 10:57:10 +01:00
Michael Kerrisk 7fc9de91dd fsync.2, getcpu.2, io_getevents.2, kcmp.2, killpg.2, outb.2, perf_event_open.2, setns.2, getaddrinfo_a.3, makedev.3, mcheck.3, perror.3, posix_memalign.3, xdr.3, cciss.4, fd.4, hpsa.4, st.4, acct.5, gai.conf.5, nss.5, proc.5, ip.7, koi8-r.7, netdevice.7, netlink.7, ld.so.8: Remove double blank lines in output
Found using this script from Denys Vlasenko (with some mods
by mtk):

    find man? -type f -name '*.[123456789]' -size +200c | sort \
    | while read name; do
            m1="`man $name | tail -n +5 | head -n-1`"
            m2="`
            printf "%s\n" "$m1" \
            | tr $'\n' '@' \
            | sed 's/@@@/@@HERE>>>>@/g' \
            | tr '@' $'\n' \
            | sed 's/^/\t/' \
            | sed 's/^\tHERE>>>>/    HERE>>>>/' \
            | grep -C2 -e $'^[^\t]' \
            | sed 's/^\t$//'
            `"
            test "$m2" || continue
            printf "%s\n%s\n" "${name#./}" "$m2"
    done

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

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-02-24 15:08:38 +01:00
Michael Kerrisk b0a6a72e8d ip.7: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-02-14 01:24:47 +01:00
Michael Kerrisk c534b25d95 ip.7: Minor fixes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-02-12 22:50:57 +01:00
Flavio Leitner 0a03fceb09 ip.7: Improve explanation about calling listen() or connect()
Problem:
When connect(2) is executed, the local port number may duplicate.

How reproducible:
When using parameter "net.ipv4.ip_local_port_range", a client may use
the same port to connect to the different sessions on the localhost.

Steps to Reproduce:
1.Change "net.ipv4.ip_local_port_range".
  [Example]
  net.ipv4.ip_local_port_range = 32768 32770

2.Connect to any two ports of LISTEN by telnet command.
  [Example]
  # netstat -antp | grep LISTEN
  tcp        0      0 0.0.0.0:139                 0.0.0.0:*                   LISTEN      2828/smbd
  tcp        0      0 0.0.0.0:21                  0.0.0.0:*                   LISTEN      2800/vsftpd
  #
  # telnet 127.0.0.1 139
  # telnet 127.0.0.1 21
  # telnet 127.0.0.1 21

3.Duplication of a local transmission port.
  [Example]
  # netstat -antp
  tcp        0      0 127.0.0.1:32769      127.0.0.1:139      ESTABLISHED 18147/telnet
  tcp        0      0 127.0.0.1:32769      127.0.0.1:21       ESTABLISHED 18157/telnet

Actual results:
The local port number may duplicate.

Expected results:
The local port number doesn't duplicate.

Additional info:
[Investigation]
"man 7 ip" contains following text:
-----------------------------------------------------------------
When listen(2) or connect(2) are called on an unbound socket, it
is automatically bound to a random  free  port  with the local
address set to INADDR_ANY.
-----------------------------------------------------------------

Although indicated as "it is automatically bound to a random free
port", the port number which is not free like in a reproduce
procedure may be bound.  Therefore, based on the description of
this "man 7 ip", it can be judged that it is bug to use the local
port where the process duplicated.

--- Comment by Leitner, Flavio on 2/7/2012 2:55 PM ---

It's allowed to have multiple tasks using the same port (as a
result of calling connect(2)) as long as the other connection
information (4-tuple) differs to resolve the conflict.  Thus,
it must be an unique 4-tuple consisting of source and
destination IP addresses and port numbers to not conflict.

In the example, the dest port is different.
          tcp        0      0 127.0.0.1:32769      127.0.0.1:139      ESTABLISHED 18147/telnet
          tcp        0      0 127.0.0.1:32769      127.0.0.1:21       ESTABLISHED 18157/telnet

Reported-by: Peter Schiffer <pschiffe@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-02-12 22:50:57 +01:00
Michael Kerrisk 96d1766a79 fork.2, getpriority.2, ioprio_set.2, sched_setparam.2, sched_setscheduler.2, shmop.2, sigaction.2, unimplemented.2, makecontext.3, sysconf.3, resolv.conf.5, cpuset.7, ip.7, svipc.7, termio.7, zdump.8: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-02-12 03:51:12 +01:00
Michael Kerrisk 343606a031 ip.7: Minor fixes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-02-10 04:34:36 +01:00
Radek Pazdera 2a98c8e66d ip.7: Add source-specific multicast sockopts
This patch adds documentation of several source-specific multicast
socket options that were added to kernel with implementation
of IGMPv3 in 2.5.68.

The following socket options were added:
  IP_ADD_SOURCE_MEMBERSHIP
  IP_DROP_SOURCE_MEMBERSHIP
  IP_BLOCK_SOURCE
  IP_UNBLOCK_SOURCE
  IP_MSFILTER

Information Sources:
  * RFC 3376 - Internet Group Management Protocol, Version 3
      http://tools.ietf.org/html/rfc3376
  * RFC 3678 - Socket Interface Extensions for Multicast Source
    Filters
      http://tools.ietf.org/html/rfc3678
  * Kernel source tree
      net/ipv4/ip_sockglue.c
      net/ipv4/igmp.c
  * Test programs used in Linux Network Stack Test
      http://git.fedorahosted.org/git/?p=lnst.git
      test_tools/multicast/

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-02-10 04:34:36 +01:00
Michael Kerrisk f645fea8c0 ip.7: srcfix: Added/updated FIXMEs
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-12-15 19:18:26 +01:00
Michael Kerrisk f567c52d80 ip.7: SEE ALSO: Add icmp(7)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-10 11:10:45 +02:00
Michael Kerrisk e28830e42e ip.7: SEE ALSO: Add ipv6(7)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-10 11:10:05 +02:00
David Prévot 173fe7e792 arch_prctl.2, fcntl.2, flock.2, get_robust_list.2, getpriority.2, ioprio_set.2, migrate_pages.2, mmap.2, mremap.2, msync.2, sched_get_priority_max.2, sched_rr_get_interval.2, sched_setparam.2, sched_setscheduler.2, sched_yield.2, select.2, socket.2, subpage_prot.2, unshare.2, btree.3, dbopen.3, dl_iterate_phdr.3, dlopen.3, getnameinfo.3, hash.3, lockf.3, netlink.3, recno.3, rpc.3, xdr.3, cciss.4, console_ioctl.4, hpsa.4, initrd.4, msr.4, rtc.4, st.4, hosts.5, services.5, tzfile.5, aio.7, arp.7, capabilities.7, cpuset.7, feature_test_macros.7, futex.7, inotify.7, ip.7, ipv6.7, iso_8859-16.7, iso_8859-2.7, koi8-r.7, math_error.7, netlink.7, packet.7, pthreads.7, raw.7, spufs.7, udplite.7, uri.7, x25.7: Global fix: Various consistency fixes for SEE ALSO
Coauthored-by: Michael Kerrisk <mtk.manpages@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-09-24 09:53:22 +02:00
Michael Kerrisk 776b81f6cb ip.7: Mnor fixes
Reported-by: Benjamin Poirier <benjamin.poirier@gmail.com>
Reported-by: Neil Horman <nhorman@tuxdriver.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-23 07:25:34 +02:00
Benjamin Poirier 8341e3a766 ip.7: Improve description of IP_MTU_DISCOVER
I noticed what appears to be a discrepancy between the ip(7)
man page and the kernel code with regards to the IP DF flag
for UDP sockets.

The man page says that "The don't-fragment flag is set on all
outgoing datagrams" and that the ip_no_pmtu_disc sysctl affects
only SOCK_STREAM sockets. This is quickly disproved by doing:

    echo 1 > /proc/sys/net/ipv4/ip_no_pmtu_disc

firing up netcat and looking at a few outgoing UDP packets in
wireshark (they don't have the DF flag set).

1) in the words of `man 7 ip`:
IP_MTU_DISCOVER (since Linux 2.2)
     Set or receive the Path MTU Discovery  setting  for  a  socket.
     When  enabled, Linux will perform Path MTU Discovery as defined
     in RFC 1191 on this socket.  The don't-fragment flag is set  on
     all  outgoing datagrams.  The system-wide default is controlled
     by the /proc/sys/net/ipv4/ip_no_pmtu_disc file for  SOCK_STREAM
     sockets, and disabled on all others.

2) in net/ipv4/af_inet.c:inet_create():
       if (ipv4_config.no_pmtu_disc)
               inet->pmtudisc = IP_PMTUDISC_DONT;
       else
               inet->pmtudisc = IP_PMTUDISC_WANT;

and pmtudisc is left alone from there on for UDP sockets.

Reviewed-by: Neil Horman <nhorman@tuxdriver.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-22 06:08:30 +02:00
Michael Kerrisk 9458d0daac ip.7: Minor fixes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-22 05:42:02 +02:00
David Prevot 00f964819b ip.7: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-11-04 07:32:23 +01:00
David Prevot 0420475dee ip.7: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-10-24 08:20:28 +02:00
David Prevot 299fc00dbf ip.7: Place socket options in alphabetical order
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-10-24 08:16:40 +02:00
David Prevot e89c891162 ip.7: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-10-24 08:14:37 +02:00
David Prevot 1243ef4e2d ip.7: Fix name of socket option: s/IP_TTL/IP_TRANSPARENT/
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-10-24 08:10:25 +02:00
Balazs Scheidler 48029bbfa2 ip.7: Document IP_RECVORIGDSTADDR
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-10-13 07:16:28 +02:00
Balazs Scheidler e85dc06262 ip.7: Document IP_TRANSPARENT
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-10-13 06:52:59 +02:00
Michael Kerrisk 7199373b28 ip.7: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-10-13 06:41:36 +02:00
Michael Kerrisk 0ea50d8392 ip.7: Reword NOTES on Linux-specific options
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-10-13 06:41:08 +02:00
Michael Kerrisk be8fba4754 ip.7: Document IP_FREEBIND
Text based on input from Lennart Poettering and Balazs Scheidler.
See https://bugzilla.kernel.org/show_bug.cgi?id=20082

Reported-by: Lennart Poettering <zxreary@0pointer.de>
Reported-by: Balazs Scheidler <bazsi@balabit.hu>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-10-13 06:28:58 +02:00
Michael Kerrisk f7401723ce ip.7: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-10-13 05:52:51 +02:00
Michael Kerrisk 452f76294e ip.7: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-10-13 05:46:00 +02:00
Michael Kerrisk 9b042ccb88 ip.7: srcfix: update FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-10-13 05:44:21 +02:00