From 79e1601bf564b813de644f73027630374f8175b0 Mon Sep 17 00:00:00 2001 From: eadler Date: Mon, 18 Jun 2012 04:55:07 +0000 Subject: [PATCH] MFC r233648: Remove trailing whitespace per mdoc lint warning Approved by: cperciva (implicit) git-svn-id: svn://svn.freebsd.org/base/stable/9@237216 ccf9f872-aa2e-dd11-9fc8-001c23d0bc1f --- bin/pwait/pwait.1 | 2 +- bin/setfacl/setfacl.1 | 2 +- bin/sh/sh.1 | 2 +- games/pom/pom.6 | 2 +- lib/libbluetooth/bluetooth.3 | 4 +- lib/libc/gen/fts.3 | 6 +- lib/libc/gen/getpagesizes.3 | 2 +- lib/libc/gen/sysconf.3 | 2 +- lib/libc/locale/ctype.3 | 2 +- lib/libc/locale/ctype_l.3 | 4 +- lib/libc/locale/digittoint.3 | 2 +- lib/libc/locale/isalnum.3 | 2 +- lib/libc/locale/isalpha.3 | 2 +- lib/libc/locale/isblank.3 | 2 +- lib/libc/locale/iscntrl.3 | 2 +- lib/libc/net/sctp_bindx.3 | 4 +- lib/libc/net/sctp_connectx.3 | 8 +- lib/libc/net/sctp_freepaddrs.3 | 4 +- lib/libc/net/sctp_getaddrlen.3 | 2 +- lib/libc/net/sctp_getassocid.3 | 2 +- lib/libc/net/sctp_getpaddrs.3 | 2 +- lib/libc/net/sctp_opt_info.3 | 4 +- lib/libc/net/sctp_recvmsg.3 | 34 +++--- lib/libc/net/sctp_send.3 | 38 +++---- lib/libc/net/sctp_sendmsg.3 | 34 +++--- lib/libc/net/sourcefilter.3 | 4 +- lib/libc/posix1e/acl_add_flag_np.3 | 2 +- lib/libc/posix1e/acl_create_entry.3 | 2 +- lib/libc/stdio/getline.3 | 2 +- lib/libc/stdlib/at_quick_exit.3 | 12 +-- lib/libc/stdlib/getenv.3 | 2 +- lib/libc/string/memchr.3 | 2 +- lib/libc/sys/cap_new.2 | 10 +- lib/libc/sys/cpuset.2 | 8 +- lib/libc/sys/cpuset_getaffinity.2 | 2 +- lib/libc/sys/kqueue.2 | 8 +- lib/libc/sys/pathconf.2 | 2 +- lib/libc/sys/ptrace.2 | 2 +- lib/libc/sys/quotactl.2 | 4 +- lib/libc/sys/sctp_generic_sendmsg.2 | 4 +- lib/libc/sys/sctp_peeloff.2 | 2 +- lib/libc/sys/select.2 | 2 +- lib/libc/sys/sendfile.2 | 2 +- lib/libelf/elf.3 | 2 +- lib/libelf/elf_getdata.3 | 2 +- lib/libgssapi/gss_release_buffer.3 | 2 +- lib/libgssapi/gss_release_oid_set.3 | 2 +- lib/libgssapi/mech.5 | 4 +- lib/libpam/modules/pam_nologin/pam_nologin.8 | 2 +- lib/librpcsec_gss/rpc_gss_seccreate.3 | 2 +- lib/libtacplus/libtacplus.3 | 3 +- lib/libulog/utempter_add_record.3 | 2 +- lib/libusb/libusb20.3 | 2 +- lib/libutil/login_cap.3 | 4 +- lib/libutil/quotafile.3 | 4 +- libexec/tftpd/tftpd.8 | 6 +- sbin/camcontrol/camcontrol.8 | 4 +- sbin/devfs/devfs.8 | 4 +- sbin/gvinum/gvinum.8 | 10 +- sbin/ifconfig/ifconfig.8 | 26 ++--- sbin/ipfw/ipfw.8 | 102 +++++++++--------- sbin/mdmfs/mdmfs.8 | 8 +- sbin/mount_unionfs/mount_unionfs.8 | 2 +- sbin/ping6/ping6.8 | 4 +- sbin/quotacheck/quotacheck.8 | 2 +- sbin/rcorder/rcorder.8 | 2 +- share/man/man3/pthread_attr_affinity_np.3 | 2 +- share/man/man3/pthread_cond_timedwait.3 | 4 +- share/man/man3/pthread_cond_wait.3 | 4 +- share/man/man4/acpi_hp.4 | 24 ++--- share/man/man4/acpi_wmi.4 | 2 +- share/man/man4/carp.4 | 2 +- share/man/man4/ipmi.4 | 2 +- share/man/man4/iwn.4 | 2 +- share/man/man4/iwnfw.4 | 2 +- share/man/man4/ktr.4 | 2 +- share/man/man4/man4.powerpc/abtn.4 | 2 +- share/man/man4/man4.powerpc/akbd.4 | 8 +- share/man/man4/man4.powerpc/bm.4 | 4 +- share/man/man4/man4.powerpc/cuda.4 | 2 +- share/man/man4/man4.powerpc/smu.4 | 2 +- share/man/man4/man4.powerpc/snd_ai2s.4 | 2 +- share/man/man4/md.4 | 2 +- share/man/man4/mos.4 | 2 +- share/man/man4/mps.4 | 12 +-- share/man/man4/netmap.4 | 6 +- share/man/man4/ng_patch.4 | 2 +- share/man/man4/nvram2env.4 | 4 +- share/man/man4/nxge.4 | 4 +- share/man/man4/ufoma.4 | 2 +- share/man/man4/upgt.4 | 10 +- share/man/man4/wbwd.4 | 2 +- share/man/man4/xen.4 | 4 +- share/man/man5/ar.5 | 2 +- share/man/man5/fdescfs.5 | 2 +- share/man/man5/fs.5 | 4 +- share/man/man5/fstab.5 | 6 +- share/man/man5/nsmb.conf.5 | 4 +- share/man/man5/quota.user.5 | 10 +- share/man/man5/services.5 | 2 +- share/man/man7/release.7 | 29 ++--- share/man/man8/picobsd.8 | 2 +- share/man/man9/BUS_DESCRIBE_INTR.9 | 2 +- share/man/man9/BUS_SETUP_INTR.9 | 4 +- share/man/man9/DB_COMMAND.9 | 14 +-- share/man/man9/DEVICE_PROBE.9 | 6 +- share/man/man9/SYSINIT.9 | 2 +- share/man/man9/buf_ring.9 | 2 +- share/man/man9/condvar.9 | 4 +- share/man/man9/devclass_get_maxunit.9 | 2 +- share/man/man9/device_get_children.9 | 4 +- share/man/man9/drbr.9 | 8 +- share/man/man9/eventtimers.9 | 2 +- share/man/man9/firmware.9 | 2 +- share/man/man9/ieee80211.9 | 20 ++-- share/man/man9/ieee80211_amrr.9 | 6 +- share/man/man9/ieee80211_bmiss.9 | 4 +- share/man/man9/ieee80211_input.9 | 2 +- share/man/man9/ieee80211_node.9 | 12 +-- share/man/man9/ieee80211_output.9 | 8 +- share/man/man9/ieee80211_proto.9 | 12 +-- share/man/man9/ieee80211_radiotap.9 | 4 +- share/man/man9/ieee80211_regdomain.9 | 4 +- share/man/man9/ieee80211_scan.9 | 2 +- share/man/man9/ieee80211_vap.9 | 4 +- share/man/man9/kproc.9 | 6 +- share/man/man9/kthread.9 | 8 +- share/man/man9/lock.9 | 2 +- share/man/man9/locking.9 | 14 +-- share/man/man9/malloc.9 | 5 +- share/man/man9/mi_switch.9 | 2 +- share/man/man9/osd.9 | 2 +- share/man/man9/rmlock.9 | 10 +- share/man/man9/shm_map.9 | 2 +- share/man/man9/sleep.9 | 4 +- share/man/man9/spl.9 | 4 +- share/man/man9/sysctl_ctx_init.9 | 2 +- share/man/man9/taskqueue.9 | 8 +- share/man/man9/timeout.9 | 4 +- share/man/man9/usbdi.9 | 18 ++-- share/man/man9/vm_map_find.9 | 2 +- share/man/man9/watchdog.9 | 2 +- sys/boot/common/loader.8 | 2 +- sys/boot/forth/loader.conf.5 | 2 +- tools/tools/ath/athrd/athrd.1 | 10 +- tools/tools/ether_reflect/ether_reflect.1 | 2 +- tools/tools/vimage/vimage.8 | 6 +- usr.bin/bsdiff/bsdiff/bsdiff.1 | 2 +- usr.bin/calendar/calendar.1 | 34 +++--- usr.bin/comm/comm.1 | 8 +- usr.bin/csup/cpasswd.1 | 2 +- usr.bin/csup/csup.1 | 24 ++--- usr.bin/find/find.1 | 24 ++--- usr.bin/fstat/fuser.1 | 2 +- usr.bin/ipcrm/ipcrm.1 | 2 +- usr.bin/locale/locale.1 | 4 +- usr.bin/lockf/lockf.1 | 2 +- usr.bin/ministat/ministat.1 | 4 +- usr.bin/printf/printf.1 | 2 +- usr.bin/procstat/procstat.1 | 2 +- usr.bin/sed/sed.1 | 4 +- usr.bin/tftp/tftp.1 | 25 ++--- usr.bin/top/top.local.1 | 20 ++-- usr.bin/touch/touch.1 | 12 +-- usr.sbin/adduser/adduser.conf.5 | 2 +- usr.sbin/bluetooth/ath3kfw/ath3kfw.8 | 2 +- usr.sbin/bsdinstall/bsdinstall.8 | 2 +- usr.sbin/bsnmpd/modules/snmp_wlan/snmp_wlan.3 | 12 +-- usr.sbin/bsnmpd/tools/bsnmptools/bsnmpget.1 | 26 +++-- usr.sbin/cdcontrol/cdcontrol.1 | 2 +- usr.sbin/config/config.8 | 6 +- usr.sbin/ctladm/ctladm.8 | 28 ++--- usr.sbin/edquota/edquota.8 | 2 +- usr.sbin/freebsd-update/freebsd-update.8 | 2 +- usr.sbin/gpioctl/gpioctl.8 | 10 +- usr.sbin/i2c/i2c.8 | 10 +- usr.sbin/mountd/exports.5 | 4 +- usr.sbin/mptutil/mptutil.8 | 4 +- usr.sbin/newsyslog/newsyslog.conf.5 | 2 +- usr.sbin/pciconf/pciconf.8 | 2 +- usr.sbin/pkg_install/updating/pkg_updating.1 | 6 +- usr.sbin/rtadvd/rtadvd.8 | 2 +- usr.sbin/setfib/setfib.1 | 2 +- usr.sbin/timed/timed/timed.8 | 6 +- usr.sbin/wlandebug/wlandebug.8 | 2 +- 185 files changed, 596 insertions(+), 578 deletions(-) diff --git a/bin/pwait/pwait.1 b/bin/pwait/pwait.1 index f36090d1e..bf421c4d8 100644 --- a/bin/pwait/pwait.1 +++ b/bin/pwait/pwait.1 @@ -46,7 +46,7 @@ .Sh DESCRIPTION The .Nm -utility will wait until each of the given processes has terminated. +utility will wait until each of the given processes has terminated. .Pp The following option is available: .Bl -tag -width indent diff --git a/bin/setfacl/setfacl.1 b/bin/setfacl/setfacl.1 index bf505ca2a..f501c2c51 100644 --- a/bin/setfacl/setfacl.1 +++ b/bin/setfacl/setfacl.1 @@ -295,7 +295,7 @@ The ACL qualifier field describes the user or group associated with the ACL entry. It may consist of one of the following: uid or user name, or gid or group name. In entries whose tag type is -one of +one of .Dq Li owner@ , .Dq Li group@ , or diff --git a/bin/sh/sh.1 b/bin/sh/sh.1 index 937684203..3809cf5c3 100644 --- a/bin/sh/sh.1 +++ b/bin/sh/sh.1 @@ -1632,7 +1632,7 @@ All values are of type .It Constants Decimal, octal (starting with .Li 0 ) -and hexadecimal (starting with +and hexadecimal (starting with .Li 0x ) integer constants. .It Variables diff --git a/games/pom/pom.6 b/games/pom/pom.6 index bb8943680..a38a92081 100644 --- a/games/pom/pom.6 +++ b/games/pom/pom.6 @@ -35,7 +35,7 @@ .Nm pom .Nd display the phase of the moon .Sh SYNOPSIS -.Nm +.Nm .Op Fl p .Op Fl d Ar yyyy.mm.dd .Op Fl t Ar hh:mm:ss diff --git a/lib/libbluetooth/bluetooth.3 b/lib/libbluetooth/bluetooth.3 index 49f14c453..e011094a1 100644 --- a/lib/libbluetooth/bluetooth.3 +++ b/lib/libbluetooth/bluetooth.3 @@ -512,7 +512,7 @@ The function returns 0 on success, or -1 if an error occurred. .Pp The .Fn bt_devfilter_pkt_set , -.Fn bt_devfilter_pkt_clr +.Fn bt_devfilter_pkt_clr and .Fn bt_devfilter_pkt_tst functions can be used to modify and test the @@ -527,7 +527,7 @@ packet type. .Pp The .Fn bt_devfilter_evt_set , -.Fn bt_devfilter_evt_clr +.Fn bt_devfilter_evt_clr and .Fn bt_devfilter_evt_tst functions can be used to modify and test the diff --git a/lib/libc/gen/fts.3 b/lib/libc/gen/fts.3 index 193e60efb..35e4d4592 100644 --- a/lib/libc/gen/fts.3 +++ b/lib/libc/gen/fts.3 @@ -802,12 +802,12 @@ principally to provide for alternative interfaces to the .Nm functionality using different data structures. .Sh BUGS -The +The .Fn fts_open function will automatically set the .Dv FTS_NOCHDIR -option if the +option if the .Dv FTS_LOGICAL -option is provided, or if it cannot +option is provided, or if it cannot .Xr open 2 the current directory. diff --git a/lib/libc/gen/getpagesizes.3 b/lib/libc/gen/getpagesizes.3 index 959df8155..854e2f785 100644 --- a/lib/libc/gen/getpagesizes.3 +++ b/lib/libc/gen/getpagesizes.3 @@ -56,7 +56,7 @@ array referenced by These page sizes are expressed in bytes. In this case, .Fn getpagesizes -returns the number of such page sizes that it assigned to the array. +returns the number of such page sizes that it assigned to the array. .Sh RETURN VALUES If successful, the .Fn getpagesizes diff --git a/lib/libc/gen/sysconf.3 b/lib/libc/gen/sysconf.3 index 51f7eebb3..4af6f821f 100644 --- a/lib/libc/gen/sysconf.3 +++ b/lib/libc/gen/sysconf.3 @@ -211,7 +211,7 @@ Maximum number of functions that may be registered with .It Li _SC_XOPEN_VERSION An integer value greater than or equal to 4, indicating the version of the X/Open Portability Guide to which this -system conforms. +system conforms. .It Li _SC_XOPEN_XCU_VERSION An integer value indicating the version of the XCU Specification to which this system conforms. diff --git a/lib/libc/locale/ctype.3 b/lib/libc/locale/ctype.3 index 49a390258..62ec05fbb 100644 --- a/lib/libc/locale/ctype.3 +++ b/lib/libc/locale/ctype.3 @@ -55,7 +55,7 @@ .Nm toascii , .Nm tolower , .Nm toupper -.Nd character classification functions +.Nd character classification functions .Sh LIBRARY .Lb libc .Sh SYNOPSIS diff --git a/lib/libc/locale/ctype_l.3 b/lib/libc/locale/ctype_l.3 index 182e7cfe0..385125ec8 100644 --- a/lib/libc/locale/ctype_l.3 +++ b/lib/libc/locale/ctype_l.3 @@ -102,11 +102,11 @@ .Fn toupper_l "int c" "locale_t loc" .Sh DESCRIPTION The above functions perform character tests and conversions on the integer -.Fa c +.Fa c in the locale .Fa loc . They behave in the same way as the versions without the _l suffix, but use the -specified locale rather than the global or per-thread locale. +specified locale rather than the global or per-thread locale. .In ctype.h , or as true functions in the C library. See the specific manual pages for more information. diff --git a/lib/libc/locale/digittoint.3 b/lib/libc/locale/digittoint.3 index eebd064de..4a7f2e210 100644 --- a/lib/libc/locale/digittoint.3 +++ b/lib/libc/locale/digittoint.3 @@ -49,7 +49,7 @@ function converts a numeric character to its corresponding integer value. The character can be any decimal digit or hexadecimal digit. With hexadecimal characters, the case of the values does not matter. .Pp -The +The .Fn digittoint_l function takes an explicit locale argument, whereas the .Fn digittoint diff --git a/lib/libc/locale/isalnum.3 b/lib/libc/locale/isalnum.3 index c9042b5de..b418643ae 100644 --- a/lib/libc/locale/isalnum.3 +++ b/lib/libc/locale/isalnum.3 @@ -77,7 +77,7 @@ In the ASCII character set, this includes the following characters .It "\&171\ ``y'' \t172\ ``z''" .El .Pp -The +The .Fn isalnum_l function takes an explicit locale argument, whereas the .Fn isalnum diff --git a/lib/libc/locale/isalpha.3 b/lib/libc/locale/isalpha.3 index 4e4dfb55e..4a6e30fd2 100644 --- a/lib/libc/locale/isalpha.3 +++ b/lib/libc/locale/isalpha.3 @@ -74,7 +74,7 @@ In the ASCII character set, this includes the following characters .It "\&164\ ``t'' \t165\ ``u'' \t166\ ``v'' \t167\ ``w'' \t170\ ``x''" .It "\&171\ ``y'' \t172\ ``z''" .El -The +The .Fn isalpha_l function takes an explicit locale argument, whereas the .Fn isalpha diff --git a/lib/libc/locale/isblank.3 b/lib/libc/locale/isblank.3 index 8ef5c8d96..5542280eb 100644 --- a/lib/libc/locale/isblank.3 +++ b/lib/libc/locale/isblank.3 @@ -59,7 +59,7 @@ The value of the argument must be representable as an or the value of .Dv EOF . .Pp -The +The .Fn isblank_l function takes an explicit locale argument, whereas the .Fn isblank diff --git a/lib/libc/locale/iscntrl.3 b/lib/libc/locale/iscntrl.3 index 21b98a77d..1db5c89b2 100644 --- a/lib/libc/locale/iscntrl.3 +++ b/lib/libc/locale/iscntrl.3 @@ -68,7 +68,7 @@ In the ASCII character set, this includes the following characters .It "\&036\ RS \t037\ US \t177\ DEL" .El .Pp -The +The .Fn iscntrl_l function takes an explicit locale argument, whereas the .Fn iscntrl diff --git a/lib/libc/net/sctp_bindx.3 b/lib/libc/net/sctp_bindx.3 index d0471267f..403cf7d1e 100644 --- a/lib/libc/net/sctp_bindx.3 +++ b/lib/libc/net/sctp_bindx.3 @@ -55,7 +55,7 @@ This allows a user to bind a subset of addresses. The .Fn sctp_bindx -call operates similarly to +call operates similarly to .Fn bind but allows a list of addresses and also allows a bind or an unbind. @@ -98,7 +98,7 @@ This value is returned if the field is not one of the allowed values (see above). .It Bq Er ENOMEM This value is returned if the number of addresses -being added causes a memory allocation failure in +being added causes a memory allocation failure in the call. .It Bq Er EBADF The argument diff --git a/lib/libc/net/sctp_connectx.3 b/lib/libc/net/sctp_connectx.3 index 2d11d8ff3..6ea1bb622 100644 --- a/lib/libc/net/sctp_connectx.3 +++ b/lib/libc/net/sctp_connectx.3 @@ -58,18 +58,18 @@ This allows a fault tolerant method of initiating an association. When one of the peers addresses is unreachable, the subsequent listed addresses will also be used -to set up the association with the peer. +to set up the association with the peer. .Pp -The user also needs to consider that any address listed in an +The user also needs to consider that any address listed in an .Fn sctp_connectx call is also considered "confirmed". A confirmed address is one in which the SCTP transport will trust is a part of the association and it will not send a confirmation heartbeat to it with -a random nonce. +a random nonce. .Pp If the peer SCTP stack does not list one or more of -the provided addresses in its response message then +the provided addresses in its response message then the extra addresses sent in the .Fn sctp_connectx call will be silently discarded from the association. diff --git a/lib/libc/net/sctp_freepaddrs.3 b/lib/libc/net/sctp_freepaddrs.3 index a6815f4c4..77a848817 100644 --- a/lib/libc/net/sctp_freepaddrs.3 +++ b/lib/libc/net/sctp_freepaddrs.3 @@ -46,9 +46,9 @@ .In sys/socket.h .In netinet/sctp.h .Ft void -.Fn sctp_freepaddrs "struct sockaddr *" +.Fn sctp_freepaddrs "struct sockaddr *" .Ft void -.Fn sctp_freeladdrs "struct sockaddr *" +.Fn sctp_freeladdrs "struct sockaddr *" .Sh DESCRIPTION The .Fn sctp_freepaddrs diff --git a/lib/libc/net/sctp_getaddrlen.3 b/lib/libc/net/sctp_getaddrlen.3 index 762e32dc9..7259635f7 100644 --- a/lib/libc/net/sctp_getaddrlen.3 +++ b/lib/libc/net/sctp_getaddrlen.3 @@ -62,7 +62,7 @@ system calls. If for some reason a SCTP socket cannot be created or the .Fn getsockopt -call fails, an error will be returned +call fails, an error will be returned with .Va errno set as specified in the diff --git a/lib/libc/net/sctp_getassocid.3 b/lib/libc/net/sctp_getassocid.3 index 909b9c773..d86217c3b 100644 --- a/lib/libc/net/sctp_getassocid.3 +++ b/lib/libc/net/sctp_getassocid.3 @@ -50,7 +50,7 @@ The .Fn sctp_getassocid call attempts to look up the specified socket address .Fa addr -and find the respective association identification. +and find the respective association identification. .Pp .Sh RETURN VALUES The call returns the association id upon success and diff --git a/lib/libc/net/sctp_getpaddrs.3 b/lib/libc/net/sctp_getpaddrs.3 index 6ad5ea031..8bdf2ccf3 100644 --- a/lib/libc/net/sctp_getpaddrs.3 +++ b/lib/libc/net/sctp_getpaddrs.3 @@ -53,7 +53,7 @@ The .Fn sctp_getpaddrs function is used to get the list of the peers addresses. -The +The .Fn sctp_getladdrs function is used to get the list of the local addresses. The association of interest is identified by the diff --git a/lib/libc/net/sctp_opt_info.3 b/lib/libc/net/sctp_opt_info.3 index df8faa67f..02b0f8521 100644 --- a/lib/libc/net/sctp_opt_info.3 +++ b/lib/libc/net/sctp_opt_info.3 @@ -50,7 +50,7 @@ The .Fn sctp_opt_info call provides a multi-os compatible method for getting -specific +specific .Fn getsockopt data where an association identification needs to be passed into the operating system. @@ -70,7 +70,7 @@ who wish to write portable code amongst multiple operating systems this call should be used for the following SCTP socket options. .Pp -.Dv SCTP_RTOINFO +.Dv SCTP_RTOINFO .Pp .Dv SCTP_ASSOCINFO .Pp diff --git a/lib/libc/net/sctp_recvmsg.3 b/lib/libc/net/sctp_recvmsg.3 index e8ac4d24e..eda3e5cc3 100644 --- a/lib/libc/net/sctp_recvmsg.3 +++ b/lib/libc/net/sctp_recvmsg.3 @@ -56,11 +56,11 @@ is used to receive a message from another SCTP endpoint. The .Fn sctp_recvmsg call is used by one-to-one (SOCK_STREAM) type sockets after a -successful +successful .Fn connect -call or after the application has performed a -.Fn listen -followed by a successful +call or after the application has performed a +.Fn listen +followed by a successful .Fn accept . For a one-to-many (SOCK_SEQPACKET) type socket, an endpoint may call .Fn sctp_recvmsg @@ -77,7 +77,7 @@ with a positive backlog to enable the reception of new associations. .Pp The address of the sender is held in the .Fa from -argument with +argument with .Fa fromlen specifying its size. At the completion of a successful @@ -88,16 +88,16 @@ will hold the address of the peer and .Fa fromlen will hold the length of that address. Note that -the address is bounded by the initial value of +the address is bounded by the initial value of .Fa fromlen which is used as an in/out variable. .Pp -The length of the message +The length of the message .Fa msg to be received is bounded by .Fa len . If the message is too long to fit in the users -receive buffer, then the +receive buffer, then the .Fa flags argument will .Em not @@ -105,16 +105,16 @@ have the .Dv MSG_EOF flag applied. If the message is a complete message then -the +the .Fa flags argument will have .Dv MSG_EOF set. -Locally detected errors are +Locally detected errors are indicated by a return value of -1 with .Va errno set accordingly. -The +The .Fa flags argument may also hold the value .Dv MSG_NOTIFICATION . @@ -141,7 +141,7 @@ The system call may be used to determine when it is possible to receive a message. .Pp -The +The .Fa sinfo argument is defined as follows. .Bd -literal @@ -161,7 +161,7 @@ struct sctp_sndrcvinfo { The .Fa sinfo->sinfo_ppid field is an opaque 32 bit value that is passed transparently -through the stack from the peer endpoint. +through the stack from the peer endpoint. Note that the stack passes this value without regard to byte order. .Pp @@ -182,7 +182,7 @@ was delivered in order within the stream it was received. .Pp The .Fa sinfo->sinfo_stream -field is the SCTP stream that the message was received on. +field is the SCTP stream that the message was received on. Streams in SCTP are reliable (or partially reliable) flows of ordered messages. .Pp @@ -194,7 +194,7 @@ context with the socket option. Optionally a user process can use this value to index some application specific data structure for all data coming from a specific -association. +association. .Pp The .Fa sinfo->sinfo_ssn @@ -230,12 +230,12 @@ sockets this value can be used to send data to the peer without the use of an address field. It is also quite useful in setting various socket options on the specific association -(see +(see .Xr sctp 4 ) . .Pp The .Fa sinfo->info_timetolive -field is not used by +field is not used by .Fn sctp_recvmsg . .Sh RETURN VALUES The call returns the number of bytes received, or -1 diff --git a/lib/libc/net/sctp_send.3 b/lib/libc/net/sctp_send.3 index 9acb616be..d195b7ab4 100644 --- a/lib/libc/net/sctp_send.3 +++ b/lib/libc/net/sctp_send.3 @@ -62,14 +62,14 @@ is used to transmit a message to another SCTP endpoint. .Fn sctp_send may be used to send data to an existing association for both one-to-many (SOCK_SEQPACKET) and one-to-one (SOCK_STREAM) socket types. -The length of the message +The length of the message .Fa msg is given by .Fa len . If the message is too long to pass atomically through the underlying protocol, .Va errno -is set to +is set to .Er EMSGSIZE , -1 is returned, and the message is not transmitted. @@ -88,7 +88,7 @@ The system call may be used to determine when it is possible to send more data on one-to-one type (SOCK_STREAM) sockets. .Pp -The +The .Fa sinfo structure is used to control various SCTP features and has the following format: @@ -106,7 +106,7 @@ struct sctp_sndrcvinfo { }; .Ed .Pp -The +The .Fa sinfo->sinfo_ppid argument is an opaque 32 bit value that is passed transparently through the stack to the peer endpoint. It will be available on @@ -131,7 +131,7 @@ argument may include one or more of the following: #define SCTP_PR_SCTP_RTX 0x0003 /* Number of retransmissions based PR-SCTP */ .Ed .Pp -The flag +The flag .Dv SCTP_EOF is used to instruct the SCTP stack to queue this message and then start a graceful shutdown of the association. @@ -158,7 +158,7 @@ is used to specify that a specific address should be used. Normally SCTP will use only one of a multi-homed peers addresses as the primary address to send to. -By default, no matter what the +By default, no matter what the .Fa to argument is, this primary address is used to send data. By specifying @@ -193,14 +193,14 @@ skipped and no longer transmitted. Note that this policy does not even assure that the data will ever be sent. In times of a congestion -with large amounts of data being queued, the +with large amounts of data being queued, the .Fa sinfo->sinfo_timetolive may expire before the first transmission is ever made. .Pp The .Dv SCTP_PR_SCTP_BUF based policy transforms the -.Fa sinfo->sinfo_timetolive +.Fa sinfo->sinfo_timetolive field into a total number of bytes allowed on the outbound send queue. If that number or more bytes are in queue, then @@ -208,19 +208,19 @@ other buffer-based sends are looked to be removed and skipped. Note that this policy may also result in the data never being sent if no buffer based sends are in queue and -the maximum specified by -.Fa timetolive +the maximum specified by +.Fa timetolive bytes is in queue. .Pp The .Dv SCTP_PR_SCTP_RTX policy transforms the -.Fa sinfo->sinfo_timetolive +.Fa sinfo->sinfo_timetolive into a number of retransmissions to allow. This policy always assures that at a minimum one send attempt is made of the data. -After which no more than +After which no more than .Fa sinfo->sinfo_timetolive retransmissions will be made before the data is skipped. .Pp @@ -228,11 +228,11 @@ retransmissions will be made before the data is skipped. is the SCTP stream that you wish to send the message on. Streams in SCTP are reliable (or partially reliable) flows of ordered -messages. +messages. .Pp The .Fa sinfo->sinfo_assoc_id -field is used to +field is used to select the association to send to on a one-to-many socket. For a one-to-one socket, this field is ignored. .Pp @@ -256,16 +256,16 @@ The fields .Fa sinfo->sinfo_ssn , .Fa sinfo->sinfo_tsn , and -.Fa sinfo->sinfo_cumtsn +.Fa sinfo->sinfo_cumtsn are used only when receiving messages and are thus ignored by .Fn sctp_send . The function -.Fn sctp_sendx -has the same properties as +.Fn sctp_sendx +has the same properties as .Fn sctp_send with the additional arguments of an array of sockaddr structures passed in. -With the +With the .Fa addrs argument being given as an array of addresses to be sent to and the @@ -277,7 +277,7 @@ when an implicit association is being set up. This allows the user the equivalent behavior as doing a .Fn sctp_connectx -followed by a +followed by a .Fn sctp_send to the association. Note that if the diff --git a/lib/libc/net/sctp_sendmsg.3 b/lib/libc/net/sctp_sendmsg.3 index ddd88b43c..4158932eb 100644 --- a/lib/libc/net/sctp_sendmsg.3 +++ b/lib/libc/net/sctp_sendmsg.3 @@ -72,10 +72,10 @@ Data sent in such an instance will result in the data being sent on the third leg of the SCTP four-way handshake. Note that if the socket is a one-to-one type (SOCK_STREAM) socket then an association must -be in existence (by use of the +be in existence (by use of the .Xr connect 2 system call). -Calling +Calling .Fn sctp_sendmsg or .Fn sctp_sendmsgx @@ -90,14 +90,14 @@ The address of the target is given by with .Fa tolen specifying its size. -The length of the message +The length of the message .Fa msg is given by .Fa len . If the message is too long to pass atomically through the underlying protocol, .Va errno -is set to +is set to .Er EMSGSIZE , -1 is returned, and the message is not transmitted. @@ -117,7 +117,7 @@ The system call may be used to determine when it is possible to send more data on one-to-one type (SOCK_STREAM) sockets. .Pp -The +The .Fa ppid argument is an opaque 32 bit value that is passed transparently through the stack to the peer endpoint. @@ -143,7 +143,7 @@ argument may include one or more of the following: #define SCTP_PR_SCTP_RTX 0x0003 /* Number of retransmissions based PR-SCTP */ .Ed .Pp -The flag +The flag .Dv SCTP_EOF is used to instruct the SCTP stack to queue this message and then start a graceful shutdown of the association. @@ -170,7 +170,7 @@ is used to specify that an specific address should be used. Normally SCTP will use only one of a multi-homed peers addresses as the primary address to send to. -By default, no matter what the +By default, no matter what the .Fa to argument is, this primary address is used to send data. By specifying @@ -205,14 +205,14 @@ skipped and no longer transmitted. Note that this policy does not even assure that the data will ever be sent. In times of a congestion -with large amounts of data being queued, the +with large amounts of data being queued, the .Fa timetolive may expire before the first transmission is ever made. .Pp The .Dv SCTP_PR_SCTP_BUF based policy transforms the -.Fa timetolive +.Fa timetolive field into a total number of bytes allowed on the outbound send queue. If that number or more bytes are in queue, then @@ -220,19 +220,19 @@ other buffer based sends are looked to be removed and skipped. Note that this policy may also result in the data never being sent if no buffer based sends are in queue and -the maximum specified by -.Fa timetolive +the maximum specified by +.Fa timetolive bytes is in queue. .Pp The .Dv SCTP_PR_SCTP_RTX policy transforms the -.Fa timetolive +.Fa timetolive into a number of retransmissions to allow. This policy always assures that at a minimum one send attempt is made of the data. -After which no more than +After which no more than .Fa timetolive retransmissions will be made before the data is skipped. .Pp @@ -241,7 +241,7 @@ is the SCTP stream that you wish to send the message on. Streams in SCTP are reliable (or partially reliable) flows of ordered messages. -The +The .Fa context field is used only in the event the message cannot be sent. This is an opaque @@ -251,7 +251,7 @@ is given if that notification is enabled (see Normally a user process can use this value to index some application specific data structure when a send cannot be fulfilled. .Fn sctp_sendmsgx -is identical to +is identical to .Fn sctp_sendmsg with the exception that it takes an array of sockaddr structures in the argument @@ -262,7 +262,7 @@ which specifies how many addresses are in the array. This allows a caller to implicitly set up an association passing multiple addresses as if -.Fn sctp_connectx +.Fn sctp_connectx had been called to set up the association. .Sh RETURN VALUES The call returns the number of characters sent, or -1 @@ -325,7 +325,7 @@ is not connected and is a one-to-one style socket. .Xr sctp 4 .Sh BUGS Because in the one-to-many style socket -.Fn sctp_sendmsg +.Fn sctp_sendmsg or .Fn sctp_sendmsgx may have multiple associations under one endpoint, a diff --git a/lib/libc/net/sourcefilter.3 b/lib/libc/net/sourcefilter.3 index 225b0209b..c7293e05b 100644 --- a/lib/libc/net/sourcefilter.3 +++ b/lib/libc/net/sourcefilter.3 @@ -158,7 +158,7 @@ For the protocol-independent functions .Fn getsourcefilter and .Fn setsourcefilter , -the +the argument .Fa grouplen argument specifies the size of the structure pointed to by .Fa group . @@ -220,7 +220,7 @@ operation. .Sh SEE ALSO .Xr ip 4 , .Xr ip6 4 , -.Xr multicast 4 , +.Xr multicast 4, .Xr ifmcstat 8 .Rs .%A D. Thaler diff --git a/lib/libc/posix1e/acl_add_flag_np.3 b/lib/libc/posix1e/acl_add_flag_np.3 index 7ae83e28c..cf4890ba8 100644 --- a/lib/libc/posix1e/acl_add_flag_np.3 +++ b/lib/libc/posix1e/acl_add_flag_np.3 @@ -30,7 +30,7 @@ .Os .Sh NAME .Nm acl_add_flag_np -.Nd add flags to a flagset +.Nd add flags to a flagset .Sh LIBRARY .Lb libc .Sh SYNOPSIS diff --git a/lib/libc/posix1e/acl_create_entry.3 b/lib/libc/posix1e/acl_create_entry.3 index 24427831a..784f6875c 100644 --- a/lib/libc/posix1e/acl_create_entry.3 +++ b/lib/libc/posix1e/acl_create_entry.3 @@ -39,7 +39,7 @@ .In sys/acl.h .Ft int .Fn acl_create_entry "acl_t *acl_p" "acl_entry_t *entry_p" -.Ft int +.Ft int .Fn acl_create_entry_np "acl_t *acl_p" "acl_entry_t *entry_p" "int index" .Sh DESCRIPTION The diff --git a/lib/libc/stdio/getline.3 b/lib/libc/stdio/getline.3 index e0dda082e..6061bfcd1 100644 --- a/lib/libc/stdio/getline.3 +++ b/lib/libc/stdio/getline.3 @@ -78,7 +78,7 @@ and .Fn getline functions return the number of characters written, excluding the terminating -.Dv NUL +.Dv NUL character. The value \-1 is returned if an error occurs, or if end-of-file is reached. .Sh EXAMPLES diff --git a/lib/libc/stdlib/at_quick_exit.3 b/lib/libc/stdlib/at_quick_exit.3 index 7f989637a..a75c0c0a3 100644 --- a/lib/libc/stdlib/at_quick_exit.3 +++ b/lib/libc/stdlib/at_quick_exit.3 @@ -1,6 +1,6 @@ .\" Copyright (c) 2011 David Chisnall .\" All rights reserved. -.\" +.\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: @@ -9,7 +9,7 @@ .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. -.\" +.\" .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE @@ -21,7 +21,7 @@ .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. -.\" +.\" .\" $FreeBSD$ .\" .Dd December 7, 2011 @@ -40,16 +40,16 @@ The .Fn at_quick_exit function registers a cleanup function to be called when the program exits as a -result of calling +result of calling .Xr quick_exit 3 . The cleanup functions are called in the reverse order and will not be called if -the program exits by calling +the program exits by calling .Xr exit 3 , .Xr _Exit 3 , or .Xr abort 3 . .Sh RETURN VALUES -The +The .Fn at_quick_exit function returns the value 0 if successful and a non-zero value on failure. .Sh SEE ALSO diff --git a/lib/libc/stdlib/getenv.3 b/lib/libc/stdlib/getenv.3 index 669cd5db5..194964894 100644 --- a/lib/libc/stdlib/getenv.3 +++ b/lib/libc/stdlib/getenv.3 @@ -202,7 +202,7 @@ function appeared in Until .Fx 7.0 , .Fn putenv -would make a copy of +would make a copy of .Fa string and insert it into the environment using .Fn setenv . diff --git a/lib/libc/string/memchr.3 b/lib/libc/string/memchr.3 index 6e33aef98..9f31fd156 100644 --- a/lib/libc/string/memchr.3 +++ b/lib/libc/string/memchr.3 @@ -94,7 +94,7 @@ conforms to .St -isoC . .Pp The -.Fn memrchr +.Fn memrchr function is a GNU extension and conforms to no standard. .Sh HISTORY The diff --git a/lib/libc/sys/cap_new.2 b/lib/libc/sys/cap_new.2 index 362be5c15..a18fd3bf6 100644 --- a/lib/libc/sys/cap_new.2 +++ b/lib/libc/sys/cap_new.2 @@ -462,14 +462,14 @@ argument is not a capability. Support for capabilities and capabilities mode was developed as part of the .Tn TrustedBSD Project. +.Sh AUTHORS +These functions and the capability facility were created by +.An "Robert N. M. Watson" +at the University of Cambridge Computer Laboratory with support from a grant +from Google, Inc. .Sh BUGS This man page should list the set of permitted system calls more specifically for each capability right. .Pp Capability rights sometimes have unclear indirect impacts, which should be documented, or at least hinted at. -.Sh AUTHORS -These functions and the capability facility were created by -.An "Robert N. M. Watson" -at the University of Cambridge Computer Laboratory with support from a grant -from Google, Inc. diff --git a/lib/libc/sys/cpuset.2 b/lib/libc/sys/cpuset.2 index 1cdff680f..652d3aea7 100644 --- a/lib/libc/sys/cpuset.2 +++ b/lib/libc/sys/cpuset.2 @@ -77,7 +77,7 @@ while application developers will manipulate anonymous sets using To select the correct set a value of type .Ft cpulevel_t is used. -The following values for +The following values for .Fa level are supported: .Bl -column CPU_LEVEL_CPUSET -offset indent @@ -137,7 +137,7 @@ Children inherit this set after a call to .Xr fork 2 . .Pp .Fn cpuset_setid -attempts to set the id of the object specified by the +attempts to set the id of the object specified by the .Fa which argument. Currently @@ -149,12 +149,12 @@ Upon successful completion all of the threads in the target process will be running on CPUs permitted by the set. .Pp .Fn cpuset_getid -retrieves a set id from the object indicated by +retrieves a set id from the object indicated by .Fa which and stores it in the space pointed to by .Fa setid . The retrieved id may be that of either the root or assigned set -depending on the value of +depending on the value of .Fa level . .Fa level should be diff --git a/lib/libc/sys/cpuset_getaffinity.2 b/lib/libc/sys/cpuset_getaffinity.2 index 5c75b92a7..7bd90ab4e 100644 --- a/lib/libc/sys/cpuset_getaffinity.2 +++ b/lib/libc/sys/cpuset_getaffinity.2 @@ -45,7 +45,7 @@ .Fn cpuset_getaffinity and .Fn cpuset_setaffinity -allow the manipulation of sets of CPUs available to processes, threads, +allow the manipulation of sets of CPUs available to processes, threads, interrupts, jails and other resources. These functions may manipulate sets of CPUs that contain many processes or per-object anonymous masks that effect only a single object. diff --git a/lib/libc/sys/kqueue.2 b/lib/libc/sys/kqueue.2 index 5139e1cce..92b480ca3 100644 --- a/lib/libc/sys/kqueue.2 +++ b/lib/libc/sys/kqueue.2 @@ -203,7 +203,7 @@ will not return it. The filter itself is not disabled. .It EV_DISPATCH Disable the event source immediately after delivery of an event. -See +See .Dv EV_DISABLE above. .It EV_DELETE @@ -217,7 +217,7 @@ any pending events. When passed as input, it forces .Dv EV_ERROR to always be returned. -When a filter is successfully added the +When a filter is successfully added the .Va data field will be zero. .It EV_ONESHOT @@ -449,10 +449,10 @@ Establishes a user event identified by .Va ident which is not associated with any kernel mechanism but is triggered by user level code. -The lower 24 bits of the +The lower 24 bits of the .Va fflags may be used for user defined flags and manipulated using the following: -.Bl -tag -width XXNOTE_FFLAGSMASK +.Bl -tag -width XXNOTE_FFLAGSMASK .It Dv NOTE_FFNOP Ignore the input .Va fflags . diff --git a/lib/libc/sys/pathconf.2 b/lib/libc/sys/pathconf.2 index a515e3bc1..ad35d0181 100644 --- a/lib/libc/sys/pathconf.2 +++ b/lib/libc/sys/pathconf.2 @@ -174,7 +174,7 @@ return a positive number that represents the minimum hole size returned in bytes. The offsets of holes returned will be aligned to this same value. A special value of 1 is returned if the file system does not specify the minimum -hole size but still reports holes. +hole size but still reports holes. .El .Sh RETURN VALUES If the call to diff --git a/lib/libc/sys/ptrace.2 b/lib/libc/sys/ptrace.2 index 4f1afda1d..9dda8ee1b 100644 --- a/lib/libc/sys/ptrace.2 +++ b/lib/libc/sys/ptrace.2 @@ -441,7 +441,7 @@ This request is used to iterate over the entries of the VM map of the traced process. The .Fa addr -argument specifies a pointer to a +argument specifies a pointer to a .Vt "struct ptrace_vm_entry" , which is defined as follows: .Bd -literal diff --git a/lib/libc/sys/quotactl.2 b/lib/libc/sys/quotactl.2 index ff3cb4b17..6dabff0ec 100644 --- a/lib/libc/sys/quotactl.2 +++ b/lib/libc/sys/quotactl.2 @@ -113,7 +113,7 @@ Only the super-user may turn quotas off. .It Dv Q_GETQUOTASIZE Get the wordsize used to represent the quotas for the user or group (as determined by the command type). -Possible values are 32 for the old-style quota file +Possible values are 32 for the old-style quota file and 64 for the new-style quota file. The .Fa addr @@ -199,7 +199,7 @@ The .Fa id argument to .Dv Q_GETQUOTA , -.Dv Q_SETQUOTA +.Dv Q_SETQUOTA or .Dv Q_SETUSE is a negative value. diff --git a/lib/libc/sys/sctp_generic_sendmsg.2 b/lib/libc/sys/sctp_generic_sendmsg.2 index fee4211a9..1a2b12866 100644 --- a/lib/libc/sys/sctp_generic_sendmsg.2 +++ b/lib/libc/sys/sctp_generic_sendmsg.2 @@ -54,7 +54,7 @@ and .Fn sctp_generic_sendmsg_iov are the true system calls used by the .Xr sctp_sendmsg 3 -and +and .Xr sctp_send 3 function calls. These are more efficient since they are @@ -68,7 +68,7 @@ For detailed usage please see either the .Xr sctp_send 3 or .Xr sctp_sendmsg 3 -function calls. +function calls. .Sh RETURN VALUES The call returns the number of bytes written on success and -1 upon failure. .Sh ERRORS diff --git a/lib/libc/sys/sctp_peeloff.2 b/lib/libc/sys/sctp_peeloff.2 index d94f2800c..cffccfeb9 100644 --- a/lib/libc/sys/sctp_peeloff.2 +++ b/lib/libc/sys/sctp_peeloff.2 @@ -61,7 +61,7 @@ The system call can return the following errors: .Bl -tag -width Er .It Bq Er ENOTCONN -The +The .Fa id given to the call does not map to a valid association. diff --git a/lib/libc/sys/select.2 b/lib/libc/sys/select.2 index 2435e3701..59a79984f 100644 --- a/lib/libc/sys/select.2 +++ b/lib/libc/sys/select.2 @@ -222,6 +222,6 @@ Thus, it is unwise to assume that the timeout value will be unmodified by the .Fn select system call. -.Fx +.Fx does not modify the return value, which can cause problems for applications ported from other systems. diff --git a/lib/libc/sys/sendfile.2 b/lib/libc/sys/sendfile.2 index d9f8cab56..9d1fba554 100644 --- a/lib/libc/sys/sendfile.2 +++ b/lib/libc/sys/sendfile.2 @@ -104,7 +104,7 @@ variable pointed to by The .Fa flags argument is a bitmap of these values: -.Bl -item -offset indent +.Bl -item -offset indent .It .Dv SF_NODISKIO . This flag causes any diff --git a/lib/libelf/elf.3 b/lib/libelf/elf.3 index e3e01bc7a..609fab60c 100644 --- a/lib/libelf/elf.3 +++ b/lib/libelf/elf.3 @@ -523,7 +523,7 @@ flag on an ELF descriptor using .Xr elf_flagelf 3 , following which the library will use the data offsets and alignments specified by the application when laying out the file. -Application control of file layout is described further in the +Application control of file layout is described further in the .Xr elf_update 3 manual page. .Pp diff --git a/lib/libelf/elf_getdata.3 b/lib/libelf/elf_getdata.3 index 847bedacc..97766d8e8 100644 --- a/lib/libelf/elf_getdata.3 +++ b/lib/libelf/elf_getdata.3 @@ -174,7 +174,7 @@ These functions return a valid pointer to a data descriptor if successful, or NULL if an error occurs. .Sh ERRORS These functions may fail with the following errors: -.Bl -tag -width "[ELF_E_RESOURCE]" +.Bl -tag -width "[ELF_E_RESOURCE]" .It Bq Er ELF_E_ARGUMENT Arguments .Ar scn diff --git a/lib/libgssapi/gss_release_buffer.3 b/lib/libgssapi/gss_release_buffer.3 index 259db3ba6..c4acf81fa 100644 --- a/lib/libgssapi/gss_release_buffer.3 +++ b/lib/libgssapi/gss_release_buffer.3 @@ -53,7 +53,7 @@ field in the descriptor to .Dv NULL . Any buffer object returned by a GSS-API routine may be passed to .Fn gss_release_buffer -(even if there is no storage associated with the buffer). +(even if there is no storage associated with the buffer). .Sh PARAMETERS .Bl -tag .It minor_status diff --git a/lib/libgssapi/gss_release_oid_set.3 b/lib/libgssapi/gss_release_oid_set.3 index 391ad283c..7de4e9ae1 100644 --- a/lib/libgssapi/gss_release_oid_set.3 +++ b/lib/libgssapi/gss_release_oid_set.3 @@ -53,7 +53,7 @@ and the gss_OID_set_desc itself. .Pp Implementations are encouraged to set the gss_OID_set parameter to .Dv GSS_C_NO_OID_SET -on successful completion of this routine. +on successful completion of this routine. .Sh PARAMETERS .Bl -tag .It minor_status diff --git a/lib/libgssapi/mech.5 b/lib/libgssapi/mech.5 index 6078828e9..b56565e3d 100644 --- a/lib/libgssapi/mech.5 +++ b/lib/libgssapi/mech.5 @@ -62,10 +62,10 @@ This mechanism will be used by .Xr gss_init_sec_context 3 if the user doesn't specify a specific mechanism. .Pp -The +The .Pa "/etc/gss/qop" file contains a list of Quality of Protection values for use with -GSS-API. +GSS-API. Each line of the file either contains a comment if the first character is '#' or it contains three fields with the following meanings: .Bl -tag diff --git a/lib/libpam/modules/pam_nologin/pam_nologin.8 b/lib/libpam/modules/pam_nologin/pam_nologin.8 index 9448bf245..cc94be555 100644 --- a/lib/libpam/modules/pam_nologin/pam_nologin.8 +++ b/lib/libpam/modules/pam_nologin/pam_nologin.8 @@ -48,7 +48,7 @@ parameter, this is the feature. .Ss NoLogin Account Management Module The NoLogin account management component, -.Fn pam_sm_acct_mgmt , +.Fn pam_sm_acct_mgmt , verifies whether logins are administratively disabled via .Xr nologin 5 . It returns success if the user's login class has an "ignorenologin" diff --git a/lib/librpcsec_gss/rpc_gss_seccreate.3 b/lib/librpcsec_gss/rpc_gss_seccreate.3 index 7a5a0cd73..63978a580 100644 --- a/lib/librpcsec_gss/rpc_gss_seccreate.3 +++ b/lib/librpcsec_gss/rpc_gss_seccreate.3 @@ -70,7 +70,7 @@ The default - typically the same as RPC headers only are integrity protected by a checksum. .It rpc_gss_svc_integrity RPC headers and data are integrity protected by a checksum. -.It rpc_gss_svc_privacy +.It rpc_gss_svc_privacy RPC headers are integrity protected by a checksum and data is encrypted. .El .It qop diff --git a/lib/libtacplus/libtacplus.3 b/lib/libtacplus/libtacplus.3 index fdd294d56..f247a280d 100644 --- a/lib/libtacplus/libtacplus.3 +++ b/lib/libtacplus/libtacplus.3 @@ -380,7 +380,7 @@ the request, and waits for a reply. On failure, .Fn tac_send_acct returns \-1. -Otherwise, it returns the TACACS+ status code. +Otherwise, it returns the TACACS+ status code Possible status codes, defined in .In taclib.h , include: @@ -393,7 +393,6 @@ include: .It .Dv TAC_ACCT_STATUS_FOLLOW .El -.Pp .Sh EXTRACTING INFORMATION FROM THE SERVER'S AUTHORIZATION RESPONSE Like an authentication response packet, an authorization response packet from the diff --git a/lib/libulog/utempter_add_record.3 b/lib/libulog/utempter_add_record.3 index cd8e8f1e6..948363eca 100644 --- a/lib/libulog/utempter_add_record.3 +++ b/lib/libulog/utempter_add_record.3 @@ -85,7 +85,7 @@ descriptor passed to the login functions. .Pp The .Fa pty -arguments of +arguments of .Fn addToUtmp and .Fn removeLineFromUtmp diff --git a/lib/libusb/libusb20.3 b/lib/libusb/libusb20.3 index 851d70230..2253ece27 100644 --- a/lib/libusb/libusb20.3 +++ b/lib/libusb/libusb20.3 @@ -540,7 +540,7 @@ returns a zero terminated string describing the backend used. .Pp . .Fn libusb20_dev_get_info -retrieves the BSD specific usb_device_info structure into the memory location given by +retrieves the BSD specific usb_device_info structure into the memory location given by .Fa pinfo . The USB device given by .Fa pdev diff --git a/lib/libutil/login_cap.3 b/lib/libutil/login_cap.3 index bdab56eba..942171868 100644 --- a/lib/libutil/login_cap.3 +++ b/lib/libutil/login_cap.3 @@ -509,7 +509,7 @@ applies these to determine the authorisation style that best suites these rules. .Bl -bullet .It -If +If .Fa auth is neither .Dv NULL @@ -524,7 +524,7 @@ default to .Ql passwd as the authorisation list. .It -If +If .Fa style is not .Dv NULL diff --git a/lib/libutil/quotafile.3 b/lib/libutil/quotafile.3 index 8a78cd33c..1e75e9a87 100644 --- a/lib/libutil/quotafile.3 +++ b/lib/libutil/quotafile.3 @@ -242,7 +242,7 @@ limit and usage values written to the quota file will be clipped to 32 bits. .Sh RETURN VALUES If the filesystem has quotas associated with it, .Fn quota_open -returns a pointer to a +returns a pointer to a .Vt quotafile structure used in subsequent quota access calls. If the filesystem has no quotas, or access permission is denied @@ -285,6 +285,6 @@ functions first appeared in The .Nm quotafile functions and this manual page were written by -.An Dag-Erling Sm\(/orgrav Aq des@FreeBSD.org +.An Dag-Erling Sm\(/orgrav Aq des@FreeBSD.org and .An Marshall Kirk McKusick Aq mckusick@mckusick.com . diff --git a/libexec/tftpd/tftpd.8 b/libexec/tftpd/tftpd.8 index 7c3da085b..6944f7b34 100644 --- a/libexec/tftpd/tftpd.8 +++ b/libexec/tftpd/tftpd.8 @@ -161,9 +161,9 @@ which is specified. .Pp If .Ar value -is specified, then the debug level is set to +is specified, then the debug level is set to .Ar value . -The debug level is a bitmask implemented in +The debug level is a bitmask implemented in .Pa src/libexec/tftpd/tftp-utils.h . Valid values are 0 (DEBUG_NONE), 1 (DEBUG_PACKETS), 2, (DEBUG_SIMPLE), 4 (DEBUG_OPTIONS), and 8 (DEBUG_ACCESS). Multiple debug values can be combined @@ -262,7 +262,7 @@ TFTP options are mentioned here: .Rs .%T Extending TFTP .%U http://www.compuphase.com/tftp.htm -.Re +.Re .Sh HISTORY The .Nm diff --git a/sbin/camcontrol/camcontrol.8 b/sbin/camcontrol/camcontrol.8 index ecd731f47..e8ca2d60f 100644 --- a/sbin/camcontrol/camcontrol.8 +++ b/sbin/camcontrol/camcontrol.8 @@ -592,7 +592,7 @@ If the format is 11 result registers will be written to standard output in hex. .El .It Ic smpcmd -Allows the user to send an arbitrary Serial +Allows the user to send an arbitrary Serial Management Protocol (SMP) command to a device. The .Ic smpcmd @@ -653,7 +653,7 @@ argument is required to specify the PHY to operate on. .Bl -tag -width 17n .It Fl p Ar phy Specify the PHY to operate on. -This argument is required. +This argument is required. .It Fl l Request the long request/response format. Not all SMP targets support the long response format. diff --git a/sbin/devfs/devfs.8 b/sbin/devfs/devfs.8 index 7a744d437..aa2f81abd 100644 --- a/sbin/devfs/devfs.8 +++ b/sbin/devfs/devfs.8 @@ -247,8 +247,8 @@ configuration file. Local .Nm configuration file. Rulesets in here override those in -.Pa /etc/defaults/devfs.rules -with the same ruleset number, otherwise the two files are effectively merged. +.Pa /etc/defaults/devfs.rules +with the same ruleset number, otherwise the two files are effectively merged. .It Pa /etc/devfs.conf Boot-time .Nm diff --git a/sbin/gvinum/gvinum.8 b/sbin/gvinum/gvinum.8 index c8e770926..f87860b1c 100644 --- a/sbin/gvinum/gvinum.8 +++ b/sbin/gvinum/gvinum.8 @@ -42,7 +42,7 @@ .Bl -tag -width indent .It Ic attach Ar plex volume Op Cm rename .It Ic attach Ar subdisk plex Oo Ar offset Oc Op Cm rename -Attach a plex to a volume, or a subdisk to a plex. +Attach a plex to a volume, or a subdisk to a plex. If offset is specified, the subdisk will be attached to the given offset within the plex. If rename is specified, the subdisk or plex will change name according to the @@ -103,10 +103,10 @@ and .Fl V flags provide progressively more detailed output. .It Ic mirror Oo Fl fsv Oc Oo Fl n Ar name Oc Ar drives -Create a mirrored volume from the specified drives. +Create a mirrored volume from the specified drives. It requires at least a multiple of 2 drives. If no name is specified, a unique name will be set by gvinum. -If the +If the .Fl s flag is specified, a striped mirror will be created, and thus requires a multiple of 4 drives. @@ -149,7 +149,7 @@ EOF character. .It Ic raid5 Oo Fl fv Oc Oo Fl s Ar stripesize Oc Oo Fl n Ar name Oc Ar drives Create a RAID-5 volume from the specified drives. If no name is specified,a unique name will be set by -.Ic gvinum. +.Ic gvinum. This organization requires at least three drives. .It Ic rename Oo Fl r Oc Ar drive | subdisk | plex | volume newname Change the name of the specified object. @@ -282,7 +282,7 @@ unmount and then stop Ic gvinum: .Pp .Dl "gvinum mirror /dev/ad1 /dev/ad2" .Dl "newfs /dev/gvinum/gvinumvolume0" -.Dl "mount /dev/gvinum/gvinumvolume0 /mnt" +.Dl "mount /dev/gvinum/gvinumvolume0 /mnt" .Dl "..." .Dl "unmount /mnt" .Dl "gvinum stop" diff --git a/sbin/ifconfig/ifconfig.8 b/sbin/ifconfig/ifconfig.8 index cad2f96ea..33a4d0ff1 100644 --- a/sbin/ifconfig/ifconfig.8 +++ b/sbin/ifconfig/ifconfig.8 @@ -675,7 +675,7 @@ and DAD will be performed when this flag is cleared. .It Cm -ifdisabled Clear a flag .Cm ifdisabled . -When this flag is cleared and +When this flag is cleared and .Cm auto_linklocal flag is enabled, automatic configuration of a link-local address is performed. @@ -706,7 +706,7 @@ Specify the operating mode for this cloned device. .Ar mode is one of .Cm sta , -.Cm ahdemo +.Cm ahdemo (or .Cm adhoc-demo ), .Cm ibss , @@ -744,7 +744,7 @@ the device (if supported). Mark a .Cm wds device as operating in ``legacy mode''. -Legacy +Legacy .Cm wds devices have a fixed peer relationship and do not, for example, roam if their peer stops communicating. @@ -760,9 +760,9 @@ Mark the cloned interface as depending on hardware support to track received beacons. To have beacons tracked in software use .Fl beacons . -For +For .Cm hostap -mode +mode .Fl beacons can also be used to indicate no beacons should be transmitted; this can be useful when creating a WDS configuration but @@ -897,7 +897,7 @@ The .Ar interval parameter is specified in seconds. By default a background scan is considered every 300 seconds (5 minutes). -The +The .Ar interval may not be set to less than 15 seconds. .It Cm bintval Ar interval @@ -998,19 +998,19 @@ and .Cm t (Atheros Dynamic Turbo mode, or appended to ``st'' and ``dt''). The full set of channel widths following a '/' are: -.Cm 5 +.Cm 5 (5MHz aka quarter-rate channel), -.Cm 10 +.Cm 10 (10MHz aka half-rate channel), -.Cm 20 +.Cm 20 (20MHz mostly for use in specifying ht20), and -.Cm 40 +.Cm 40 (40MHz mostly for use in specifying ht40). In addition, a 40MHz HT channel specification may include the location of the extension channel by appending ``+'' or ``-'' for above and below, -respectively; e.g. ``2437:ht/40+'' specifies 40MHz wide HT operation +respectively; e.g. ``2437:ht/40+'' specifies 40MHz wide HT operation with the center channel at frequency 2437 and the extension channel above. .It Cm country Ar name Set the country code to use in calculating the regulatory constraints @@ -1989,7 +1989,7 @@ Nodes on the mesh without a path to this root mesh station with try to discover a path to us. .El By default -.Cm hwmprootmode +.Cm hwmprootmode is set to .Ar DISABLED . .It Cm hwmpmaxhops Ar cnt @@ -2524,7 +2524,7 @@ For example, the values of 802.11 WEP keys will be printed, if accessible to the current user. This information is not printed by default, as it may be considered sensitive. -.Pp +.Pp If the network interface driver is not present in the kernel then .Nm will attempt to load it. diff --git a/sbin/ipfw/ipfw.8 b/sbin/ipfw/ipfw.8 index d2fd892d7..f03b53df4 100644 --- a/sbin/ipfw/ipfw.8 +++ b/sbin/ipfw/ipfw.8 @@ -566,7 +566,7 @@ is set to 0 (default), one can use .Xr bpf 4 attached to the .Li ipfw0 -pseudo interface. There is no overhead if no +pseudo interface. There is no overhead if no .Xr bpf 4 is attached to the pseudo interface. .Pp @@ -814,13 +814,13 @@ Skip all subsequent rules numbered less than The search continues with the first rule numbered .Ar number or higher. -It is possible to use the +It is possible to use the .Cm tablearg -keyword with a skipto for a +keyword with a skipto for a .Em computed skipto, but care should be used, as no destination caching is possible in this case so the rules are always walked to find it, -starting from the +starting from the .Cm skipto . .It Cm call Ar number | tablearg The current rule number is saved in the internal stack and @@ -950,7 +950,7 @@ in any subsequent forwarding decisions. Initially this is limited to the values 0 through 15, see .Xr setfib 1 . Processing continues at the next rule. -It is possible to use the +It is possible to use the .Cm tablearg keyword with a setfib. If tablearg value is not within compiled FIB range packet fib is set to 0. .It Cm reass @@ -971,7 +971,7 @@ the maximum number of fragments per packet (default: 16). NOTA BENE: since fragments do not contain port numbers, they should be avoided with the .Nm reass rule. -Alternatively, direction-based (like +Alternatively, direction-based (like .Nm in / .Nm out @@ -1806,7 +1806,7 @@ When used with the .Cm skipto action, the user should be aware that the code will walk the ruleset up to a rule equal to, or past, the given number, and should therefore try keep the -ruleset compact between the skipto and the target rules. +ruleset compact between the skipto and the target rules. .Sh SETS OF RULES Each rule belongs to one of 32 different .Em sets @@ -2479,9 +2479,9 @@ support in-kernel NAT using the kernel version of The nat configuration command is the following: .Bd -ragged -offset indent .Bk -words -.Cm nat -.Ar nat_number -.Cm config +.Cm nat +.Ar nat_number +.Cm config .Ar nat-configuration .Ek .Ed @@ -2533,7 +2533,7 @@ section below for more information on lookup tables. .El .Pp To let the packet continue after being (de)aliased, set the sysctl variable -.Va net.inet.ip.fw.one_pass +.Va net.inet.ip.fw.one_pass to 0. For more information about aliasing modes, refer to .Xr libalias 3 . @@ -2542,7 +2542,7 @@ See Section for some examples about nat usage. .Ss REDIRECT AND LSNAT SUPPORT IN IPFW Redirect and LSNAT support follow closely the syntax used in -.Xr natd 8 . +.Xr natd 8 . See Section .Sx EXAMPLES for some examples on how to do redirect and lsnat. @@ -2550,16 +2550,16 @@ for some examples on how to do redirect and lsnat. SCTP nat can be configured in a similar manner to TCP through the .Nm command line tool. -The main difference is that -.Nm sctp nat +The main difference is that +.Nm sctp nat does not do port translation. Since the local and global side ports will be the same, there is no need to specify both. Ports are redirected as follows: .Bd -ragged -offset indent .Bk -words -.Cm nat -.Ar nat_number +.Cm nat +.Ar nat_number .Cm config if .Ar nic .Cm redirect_port sctp @@ -2577,9 +2577,9 @@ change for new .Nm nat instances. See -.Sx SYSCTL VARIABLES +.Sx SYSCTL VARIABLES for more info. -.Sh LOADER TUNABLES +.Sh LOADER TUNABLES Tunables can be set in .Xr loader 8 prompt, @@ -2607,15 +2607,15 @@ These are shown below together with their default value command what value is actually in use) and meaning: .Bl -tag -width indent .It Va net.inet.ip.alias.sctp.accept_global_ootb_addip: No 0 -Defines how the -.Nm nat +Defines how the +.Nm nat responds to receipt of global OOTB ASCONF-AddIP: .Bl -tag -width indent .It Cm 0 No response (unless a partially matching association exists - ports and vtags match but global address does not) .It Cm 1 -.Nm nat +.Nm nat will accept and process all OOTB global AddIP messages. .El .Pp @@ -2625,18 +2625,18 @@ establish multiple fake associations by sending AddIP messages. .It Va net.inet.ip.alias.sctp.chunk_proc_limit: No 5 Defines the maximum number of chunks in an SCTP packet that will be parsed for a packet that matches an existing association. -This value is enforced to be greater or equal than -.Cm net.inet.ip.alias.sctp.initialising_chunk_proc_limit . +This value is enforced to be greater or equal than +.Cm net.inet.ip.alias.sctp.initialising_chunk_proc_limit . A high value is a DoS risk yet setting too low a value may result in important control chunks in the packet not being located and parsed. .It Va net.inet.ip.alias.sctp.error_on_ootb: No 1 Defines when the -.Nm nat +.Nm nat responds to any Out-of-the-Blue (OOTB) packets with ErrorM packets. An OOTB packet is a packet that arrives with no existing association registered in the -.Nm nat +.Nm nat and is not an INIT or ASCONF-AddIP packet: .Bl -tag -width indent .It Cm 0 @@ -2646,8 +2646,8 @@ ErrorM is only sent to OOTB packets received on the local side. .It Cm 2 ErrorM is sent to the local side and on the global side ONLY if there is a partial match (ports and vtags match but the source global IP does not). -This value is only useful if the -.Nm nat +This value is only useful if the +.Nm nat is tracking global IP addresses. .It Cm 3 ErrorM is sent in response to all OOTB packets on both the local and global side @@ -2658,24 +2658,24 @@ At the moment the default is 0, since the ErrorM packet is not yet supported by most SCTP stacks. When it is supported, and if not tracking global addresses, we recommend setting this value to 1 to allow -multi-homed local hosts to function with the +multi-homed local hosts to function with the .Nm nat . To track global addresses, we recommend setting this value to 2 to allow global hosts to be informed when they need to (re)send an ASCONF-AddIP. Value 3 should never be chosen (except for debugging) as the -.Nm nat +.Nm nat will respond to all OOTB global packets (a DoS risk). .It Va net.inet.ip.alias.sctp.hashtable_size: No 2003 -Size of hash tables used for -.Nm nat +Size of hash tables used for +.Nm nat lookups (100 < prime_number > 1000001). -This value sets the -.Nm hash table -size for any future created +This value sets the +.Nm hash table +size for any future created +.Nm nat +instance and therefore must be set prior to creating a .Nm nat -instance and therefore must be set prior to creating a -.Nm nat instance. The table sizes may be changed to suit specific needs. If there will be few @@ -2704,7 +2704,7 @@ risk as malformed packets can consume processing resources. Defines the maximum number of parameters within a chunk that will be parsed in a packet. As for other similar sysctl variables, larger values pose a DoS risk. -.It Va net.inet.ip.alias.sctp.log_level: No 0 +.It Va net.inet.ip.alias.sctp.log_level: No 0 Level of detail in the system log messages (0 \- minimal, 1 \- event, 2 \- info, 3 \- detail, 4 \- debug, 5 \- max debug). May be a good option in high loss environments. @@ -2712,8 +2712,8 @@ option in high loss environments. Timeout value while waiting for SHUTDOWN-COMPLETE. This value cannot be 0. .It Va net.inet.ip.alias.sctp.track_global_addresses: No 0 -Enables/disables global IP address tracking within the -.Nm nat +Enables/disables global IP address tracking within the +.Nm nat and places an upper limit on the number of addresses tracked for each association: .Bl -tag -width indent @@ -2726,16 +2726,16 @@ association is limited to this value .Pp This variable is fully dynamic, the new value will be adopted for all newly arriving associations, existing associations are treated as they were previously. -Global tracking will decrease the number of collisions within the -.Nm nat +Global tracking will decrease the number of collisions within the +.Nm nat at a cost -of increased processing load, memory usage, complexity, and possible -.Nm nat +of increased processing load, memory usage, complexity, and possible +.Nm nat state -problems in complex networks with multiple -.Nm nats . +problems in complex networks with multiple +.Nm nats . We recommend not tracking -global IP addresses, this will still result in a fully functional +global IP addresses, this will still result in a fully functional .Nm nat . .It Va net.inet.ip.alias.sctp.up_timer: No 300 Timeout value to keep an association up with no traffic. @@ -3183,7 +3183,7 @@ First redirect all the traffic to nat instance 123: .Pp Then to configure nat instance 123 to alias all the outgoing traffic with ip 192.168.0.123, blocking all incoming connections, trying to keep -same ports on both sides, clearing aliasing table on address change +same ports on both sides, clearing aliasing table on address change and keeping a log of traffic/link statistics: .Pp .Dl "ipfw nat 123 config ip 192.168.0.123 log deny_in reset same_ports" @@ -3212,7 +3212,7 @@ Or a redirect rule with mixed modes could looks like: .Dl " redirect_proto udp 192.168.1.43 192.168.1.1" .Dl " redirect_addr 192.168.0.10,192.168.0.11" .Dl " 10.0.0.100 # LSNAT" -.Dl " redirect_port tcp 192.168.0.1:80,192.168.0.10:22" +.Dl " redirect_port tcp 192.168.0.1:80,192.168.0.10:22" .Dl " 500 # LSNAT" .Pp or it could be split in: @@ -3220,7 +3220,7 @@ or it could be split in: .Dl "ipfw nat 1 config redirect_addr 10.0.0.1 10.0.0.66" .Dl "ipfw nat 2 config redirect_port tcp 192.168.0.1:80 500" .Dl "ipfw nat 3 config redirect_proto udp 192.168.1.43 192.168.1.1" -.Dl "ipfw nat 4 config redirect_addr 192.168.0.10,192.168.0.11,192.168.0.12" +.Dl "ipfw nat 4 config redirect_addr 192.168.0.10,192.168.0.11,192.168.0.12" .Dl " 10.0.0.100" .Dl "ipfw nat 5 config redirect_port tcp" .Dl " 192.168.0.1:80,192.168.0.10:22,192.168.0.20:25 500" @@ -3341,8 +3341,8 @@ Rule syntax is subject to the command line environment and some patterns may need to be escaped with the backslash character or quoted appropriately. .Pp -Due to the architecture of -.Xr libalias 3 , +Due to the architecture of +.Xr libalias 3 , ipfw nat is not compatible with the TCP segmentation offloading (TSO). Thus, to reliably nat your network traffic, please disable TSO on your NICs using diff --git a/sbin/mdmfs/mdmfs.8 b/sbin/mdmfs/mdmfs.8 index f2db7da5e..ab5e1be8d 100644 --- a/sbin/mdmfs/mdmfs.8 +++ b/sbin/mdmfs/mdmfs.8 @@ -40,7 +40,7 @@ driver .Op Fl a Ar maxcontig .Op Fl b Ar block-size .Op Fl c Ar blocks-per-cylinder-group -.Op Fl d Ar max-extent-size +.Op Fl d Ar max-extent-size .Op Fl E Ar path-mdconfig .Op Fl e Ar maxbpg .Op Fl F Ar file @@ -75,8 +75,8 @@ was specified) using .Xr newfs 8 , and mounts it using .Xr mount 8 . -It can handle -.Xr geom_uzip 4 +It can handle +.Xr geom_uzip 4 compressed disk images, as long as the kernel supports this GEOM class. All the command line options are passed to the appropriate program at the appropriate stage in order to achieve the desired effect. @@ -318,7 +318,7 @@ do not use soft-updates on it and mount it .Pp .Dl "mdmfs -M -S -o async -s 16m md1 /tmp" .Pp -Create and mount a +Create and mount a .Xr geom_uzip 4 based compressed disk image: .Pp diff --git a/sbin/mount_unionfs/mount_unionfs.8 b/sbin/mount_unionfs/mount_unionfs.8 index b3f38207d..b613a9441 100644 --- a/sbin/mount_unionfs/mount_unionfs.8 +++ b/sbin/mount_unionfs/mount_unionfs.8 @@ -366,7 +366,7 @@ there is no way that delete and rename operations on lower layer objects can be done. .Er EOPNOTSUPP is returned for this kind of operations as generated by VOP_WHITEOUT() -along with any others which would make modifications to the lower +along with any others which would make modifications to the lower layer, such as .Xr chmod 1 . .Pp diff --git a/sbin/ping6/ping6.8 b/sbin/ping6/ping6.8 index fd6e63a1a..b720aefe3 100644 --- a/sbin/ping6/ping6.8 +++ b/sbin/ping6/ping6.8 @@ -428,8 +428,8 @@ The .Nm utility returns 0 on success (the host is alive), 2 if the transmission was successful but no responses were received, -any other non-zero value if the arguments are incorrect or -another error has occurred. +any other non-zero value if the arguments are incorrect or +another error has occurred. .Sh EXAMPLES Normally, .Nm diff --git a/sbin/quotacheck/quotacheck.8 b/sbin/quotacheck/quotacheck.8 index 1c34cd388..0ca59ac50 100644 --- a/sbin/quotacheck/quotacheck.8 +++ b/sbin/quotacheck/quotacheck.8 @@ -158,7 +158,7 @@ with the variable .Ar enable_quotas in .Pa /etc/rc.conf . -The kernel must also be built with +The kernel must also be built with .Cd "options QUOTA" . .Pp The diff --git a/sbin/rcorder/rcorder.8 b/sbin/rcorder/rcorder.8 index 060f4ecb4..b43383a5b 100644 --- a/sbin/rcorder/rcorder.8 +++ b/sbin/rcorder/rcorder.8 @@ -181,7 +181,7 @@ if your script has a .Dq Li REQUIRE on .Dq Li named , -it means the script must be placed after the +it means the script must be placed after the .Dq Li named script in the dependency ordering, not necessarily that it requires diff --git a/share/man/man3/pthread_attr_affinity_np.3 b/share/man/man3/pthread_attr_affinity_np.3 index 592652b49..8813f1a07 100644 --- a/share/man/man3/pthread_attr_affinity_np.3 +++ b/share/man/man3/pthread_attr_affinity_np.3 @@ -119,7 +119,7 @@ or the attribute specified by it is .It Bq Er EINVAL The .Fa cpusetp -specified a CPU that was outside the set supported by the kernel. +specified a CPU that was outside the set supported by the kernel. .It Bq Er ERANGE The .Fa cpusetsize diff --git a/share/man/man3/pthread_cond_timedwait.3 b/share/man/man3/pthread_cond_timedwait.3 index 11a3c2fb1..071f690be 100644 --- a/share/man/man3/pthread_cond_timedwait.3 +++ b/share/man/man3/pthread_cond_timedwait.3 @@ -83,8 +83,8 @@ is invalid. The system time has reached or exceeded the time specified in .Fa abstime . .It Bq Er EPERM -The specified -.Fa mutex +The specified +.Fa mutex was not locked by the calling thread. .El .Sh SEE ALSO diff --git a/share/man/man3/pthread_cond_wait.3 b/share/man/man3/pthread_cond_wait.3 index 07276037e..c05709869 100644 --- a/share/man/man3/pthread_cond_wait.3 +++ b/share/man/man3/pthread_cond_wait.3 @@ -72,8 +72,8 @@ or the value specified by .Fa mutex is invalid. .It Bq Er EPERM -The specified -.Fa mutex +The specified +.Fa mutex was not locked by the calling thread. .El .Sh SEE ALSO diff --git a/share/man/man4/acpi_hp.4 b/share/man/man4/acpi_hp.4 index f23a0ab2a..5f66a4c56 100644 --- a/share/man/man4/acpi_hp.4 +++ b/share/man/man4/acpi_hp.4 @@ -93,7 +93,7 @@ WWAN on air status changed to 1 (on air) .El .Ss Xr devfs 8 Ss Device You can read /dev/hpcmi to see your current BIOS settings. -The detail level can be adjusted by setting the sysctl +The detail level can be adjusted by setting the sysctl .Va cmi_detail as described below. .Sh SYSCTL VARIABLES @@ -101,7 +101,7 @@ The following sysctls are currently implemented: .Ss WLAN: .Bl -tag -width indent .It Va dev.acpi_hp.0.wlan_enabled -Toggle WLAN chip activity. +Toggle WLAN chip activity. .It Va dev.acpi_hp.0.wlan_radio (read-only) WLAN radio status (controlled by hardware switch) @@ -116,7 +116,7 @@ If set to 1, the WLAN chip will be disabled if the radio is turned off .Ss Bluetooth: .Bl -tag -width indent .It Va dev.acpi_hp.0.bt_enabled -Toggle Bluetooth chip activity. +Toggle Bluetooth chip activity. .It Va dev.acpi_hp.0.bt_radio (read-only) Bluetooth radio status (controlled by hardware switch) @@ -131,7 +131,7 @@ If set to 1, the Bluetooth chip will be disabled if the radio is turned off .Ss WWAN: .Bl -tag -width indent .It Va dev.acpi_hp.0.wwan_enabled -Toggle WWAN chip activity. +Toggle WWAN chip activity. .It Va dev.acpi_hp.0.wwan_radio (read-only) WWAN radio status (controlled by hardware switch) @@ -229,14 +229,14 @@ Get BIOS settings: .Bd -literal -offset indent cat /dev/hpcmi -Serial Port Disable -Infrared Port Enable -Parallel Port Disable -Flash Media Reader Disable -USB Ports including Express Card slot Enable -1394 Port Enable -Cardbus Slot Disable -Express Card Slot Disable +Serial Port Disable +Infrared Port Enable +Parallel Port Disable +Flash Media Reader Disable +USB Ports including Express Card slot Enable +1394 Port Enable +Cardbus Slot Disable +Express Card Slot Disable (...) .Ed .Pp diff --git a/share/man/man4/acpi_wmi.4 b/share/man/man4/acpi_wmi.4 index 8ff3aceca..28bd0da2e 100644 --- a/share/man/man4/acpi_wmi.4 +++ b/share/man/man4/acpi_wmi.4 @@ -47,7 +47,7 @@ acpi_wmi_load="YES" .Sh DESCRIPTION The .Nm -driver provides an interface for vendor specific WMI implementations +driver provides an interface for vendor specific WMI implementations (e.g. HP and Acer laptops). It creates /dev/wmistat%d, which can be read to get information about GUIDs found in the system. diff --git a/share/man/man4/carp.4 b/share/man/man4/carp.4 index 4064c6c68..fe673896d 100644 --- a/share/man/man4/carp.4 +++ b/share/man/man4/carp.4 @@ -184,7 +184,7 @@ or event. Please see .Xr devd.conf 5 -and +and .Sx EXAMPLES section for more information. .Sh EXAMPLES diff --git a/share/man/man4/ipmi.4 b/share/man/man4/ipmi.4 index 481e22f56..25dc341ae 100644 --- a/share/man/man4/ipmi.4 +++ b/share/man/man4/ipmi.4 @@ -63,7 +63,7 @@ If the .Ar port and .Ar spacing -are not specified the interface type default will be used. Only specify +are not specified the interface type default will be used. Only specify either the .Ar port for I/O access or diff --git a/share/man/man4/iwn.4 b/share/man/man4/iwn.4 index 23a874dd0..5fe055e03 100644 --- a/share/man/man4/iwn.4 +++ b/share/man/man4/iwn.4 @@ -151,7 +151,7 @@ This should not happen. The driver failed to load the firmware image using the .Xr firmware 9 subsystem. -Verify the +Verify the .Xr iwnfw 4 firmware module is present. .It "iwn%d: could not load boot firmware" diff --git a/share/man/man4/iwnfw.4 b/share/man/man4/iwnfw.4 index 39752cf68..681d7284d 100644 --- a/share/man/man4/iwnfw.4 +++ b/share/man/man4/iwnfw.4 @@ -65,7 +65,7 @@ iwn6050fw_load="YES" .Ed .Sh DESCRIPTION This module provides access to firmware sets for the -Intel Wireless WiFi Link 4965, 1000, 5000 and 6000 series of +Intel Wireless WiFi Link 4965, 1000, 5000 and 6000 series of IEEE 802.11n adapters. It may be statically linked into the kernel, or loaded as a module. diff --git a/share/man/man4/ktr.4 b/share/man/man4/ktr.4 index 7da4e3730..b4039f058 100644 --- a/share/man/man4/ktr.4 +++ b/share/man/man4/ktr.4 @@ -171,7 +171,7 @@ the next invocation. enables logging of .Nm entries to disk if it is set to one. -Setting this to 0 will terminate logging to disk and revert to +Setting this to 0 will terminate logging to disk and revert to logging to the normal ktr ring buffer. Data is not sent to the ring buffer while logging to disk. .It Va debug.ktr.alq_max diff --git a/share/man/man4/man4.powerpc/abtn.4 b/share/man/man4/man4.powerpc/abtn.4 index 8aab9a704..c7b744fba 100644 --- a/share/man/man4/man4.powerpc/abtn.4 +++ b/share/man/man4/man4.powerpc/abtn.4 @@ -60,7 +60,7 @@ The .Nm driver sends events to .Xr devd 8 -for the following events under the +for the following events under the .Cd PMU system, and .Cd keys diff --git a/share/man/man4/man4.powerpc/akbd.4 b/share/man/man4/man4.powerpc/akbd.4 index d4f3aa167..e56676a76 100644 --- a/share/man/man4/man4.powerpc/akbd.4 +++ b/share/man/man4/man4.powerpc/akbd.4 @@ -63,15 +63,15 @@ The .Nm driver sends events to .Xr devd 8 -for the following events under the +for the following events under the .Cd PMU system: .Pp .Bl -bullet -compact .It -Power button - +Power button - .Cd "Button" -subsystem, +subsystem, .Cd "pressed" type. .El @@ -81,7 +81,7 @@ The driver supports the following sysctl variable for configuring the Fn keys: .Bl -tag -width indent .It Va dev.akbd.%d.fn_keys_function_as_primary -Set the Fn keys to be their F-key type as default. A value of 0 causes the +Set the Fn keys to be their F-key type as default. A value of 0 causes the F-keys keys to work as special keys by default ( .Xr abtn 4 ) and a value of 1 sets them to behave as F-keys by default. diff --git a/share/man/man4/man4.powerpc/bm.4 b/share/man/man4/man4.powerpc/bm.4 index a9e57e30e..01b7fa96b 100644 --- a/share/man/man4/man4.powerpc/bm.4 +++ b/share/man/man4/man4.powerpc/bm.4 @@ -50,8 +50,8 @@ if_bm_load="YES" The .Nm driver provides support for the BMac ethernet hardware found mostly in -G3-based Apple hardware. -It is a close relative of the Sun HME controller found in contemporary +G3-based Apple hardware. +It is a close relative of the Sun HME controller found in contemporary Sun workstations. .Sh HARDWARE .Pp diff --git a/share/man/man4/man4.powerpc/cuda.4 b/share/man/man4/man4.powerpc/cuda.4 index 4b4b2180c..f1faaf2d2 100644 --- a/share/man/man4/man4.powerpc/cuda.4 +++ b/share/man/man4/man4.powerpc/cuda.4 @@ -46,7 +46,7 @@ driver provides support for the CUDA VIA (Versatile Interface Attachment) chip found in pre-Core99 Apple hardware, such as the Power Macintosh G3. .Pp The Apple CUDA controller is a multi-purpose ASIC that provides power -control and an +control and an .Xr adb 4 interface. .Sh HARDWARE diff --git a/share/man/man4/man4.powerpc/smu.4 b/share/man/man4/man4.powerpc/smu.4 index 893522c9c..2550a0df6 100644 --- a/share/man/man4/man4.powerpc/smu.4 +++ b/share/man/man4/man4.powerpc/smu.4 @@ -103,7 +103,7 @@ sensors in millivolts, and power sensors in milliwatts. .Sh LED INTERFACE The .Nm -driver provides an +driver provides an .Xr led 4 annunciator interface at .Pa /dev/led/sleepled . diff --git a/share/man/man4/man4.powerpc/snd_ai2s.4 b/share/man/man4/man4.powerpc/snd_ai2s.4 index dee04243e..5243b171d 100644 --- a/share/man/man4/man4.powerpc/snd_ai2s.4 +++ b/share/man/man4/man4.powerpc/snd_ai2s.4 @@ -49,7 +49,7 @@ snd_ai2s_load="YES" .Sh DESCRIPTION The .Nm -driver provides support for the Apple I2S audio controllers found +driver provides support for the Apple I2S audio controllers found predominantly in G4 and G5 machines, along with the snapper and tumbler codecs. Some machines (e.g. the Mac Mini) do not have configurable codecs and so lack hardware volume control. diff --git a/share/man/man4/md.4 b/share/man/man4/md.4 index 4d7e4925a..49b0069d8 100644 --- a/share/man/man4/md.4 +++ b/share/man/man4/md.4 @@ -76,7 +76,7 @@ The image in .Pa /h/foo/ARM-MD will be loaded as the initial image each boot. To create the image to use, please follow the steps to create a file-backed -disk found in the +disk found in the .Xr mdconfig 8 man page. Other tools will also create these images, such as NanoBSD. diff --git a/share/man/man4/mos.4 b/share/man/man4/mos.4 index 84aaabc8d..ddd01215a 100644 --- a/share/man/man4/mos.4 +++ b/share/man/man4/mos.4 @@ -43,7 +43,7 @@ if_mos_load="YES" .Sh DESCRIPTION The .Nm -driver provides support for USB Ethernet adapters based on the +driver provides support for USB Ethernet adapters based on the Moschip MCS7730/MCS7830 chipset. .Pp The adapters that contain the Moschip MCS7730/MCS7830 chipset diff --git a/share/man/man4/mps.4 b/share/man/man4/mps.4 index 42ec64634..ce1973789 100644 --- a/share/man/man4/mps.4 +++ b/share/man/man4/mps.4 @@ -1,7 +1,7 @@ -.\" +.\" .\" Copyright (c) 2010 Spectra Logic Corporation .\" All rights reserved. -.\" +.\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: @@ -13,7 +13,7 @@ .\" ("Disclaimer") and any redistribution must be conditioned upon .\" including a substantially similar Disclaimer requirement for further .\" binary redistribution. -.\" +.\" .\" NO WARRANTY .\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS .\" "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT @@ -26,7 +26,7 @@ .\" STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING .\" IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE .\" POSSIBILITY OF SUCH DAMAGES. -.\" +.\" .\" mps driver man page. .\" .\" Author: Ken Merry @@ -117,7 +117,7 @@ dev.mps.X.disable_msix=1 .Ed .Pp To set the maximum number of DMA chains allocated for all adapters, -set the following variable in +set the following variable in .Xr loader.conf 5 : .Bd -literal -offset indent hw.mps.max_chains=NNNN @@ -207,7 +207,7 @@ This driver has a couple of known shortcomings: .It Not endian safe. It only works on little endian machines (e.g. amd64 and i386). -.It +.It No userland utility available (e.g. .Xr mptutil 8 ) . .It diff --git a/share/man/man4/netmap.4 b/share/man/man4/netmap.4 index 84fae5252..ca82b59c5 100644 --- a/share/man/man4/netmap.4 +++ b/share/man/man4/netmap.4 @@ -21,7 +21,7 @@ .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. -.\" +.\" .\" This document is derived in part from the enet man page (enet.4) .\" distributed with 4.3BSD Unix. .\" @@ -43,7 +43,7 @@ is a framework for fast and safe access to network devices .Nm uses memory mapped buffers and metadata (buffer indexes and lengths) to communicate with the kernel, -which is in charge of validating information through +which is in charge of validating information through .Pa ioctl() and .Pa select()/poll() . @@ -66,7 +66,7 @@ to bind the file descriptor to a network device. When a device is put in .Nm mode, its data path is disconnected from the host stack. -The processes owning the file descriptor +The processes owning the file descriptor can exchange packets with the device, or with the host stack, through an mmapped memory region that contains pre-allocated buffers and metadata. diff --git a/share/man/man4/ng_patch.4 b/share/man/man4/ng_patch.4 index c7c2194b7..b1ddf4aeb 100644 --- a/share/man/man4/ng_patch.4 +++ b/share/man/man4/ng_patch.4 @@ -164,7 +164,7 @@ Here .Dq Li ttl_add node of type .Nm -configured to add (mode +configured to add (mode .Dv NG_PATCH_MODE_ADD ) a .Va value diff --git a/share/man/man4/nvram2env.4 b/share/man/man4/nvram2env.4 index 51760979b..22d5b088d 100644 --- a/share/man/man4/nvram2env.4 +++ b/share/man/man4/nvram2env.4 @@ -44,7 +44,7 @@ the string name, "=" delimiter and the string value. .Nm copies the environment values into kernel environment using the kernel setenv call. .Pp -Configuration of +Configuration of .Nm is done in .Xr device.hints 5 @@ -69,7 +69,7 @@ compatible, please set it to "1". Use format "Generic", skip uint32_t field, then zero terminating array of strings. .It Fa 0x0004 -Use Broadcom CFE format. uint32_t signature "FLSH", uint32_t size, +Use Broadcom CFE format. uint32_t signature "FLSH", uint32_t size, three unused fields uint32_t, then data. .It Fa 0x0008 Use U-Boot format, uint32_t crc, then zero terminating array of strings. diff --git a/share/man/man4/nxge.4 b/share/man/man4/nxge.4 index 4550535b9..8d94afc59 100644 --- a/share/man/man4/nxge.4 +++ b/share/man/man4/nxge.4 @@ -48,8 +48,8 @@ if_nxge_load="YES" The .Nm driver provides support for Neterion Xframe-I and Xframe-II adapters. -The driver supports TCP Segmentation Offload (TSO/LSO), -Large Receive Offload (LRO), Jumbo Frames (5 buffer mode), +The driver supports TCP Segmentation Offload (TSO/LSO), +Large Receive Offload (LRO), Jumbo Frames (5 buffer mode), Header Separation (Rx 2 buffer mode), VLAN, and Promiscuous mode. .Pp For general information and support, please visit the Neterion support page diff --git a/share/man/man4/ufoma.4 b/share/man/man4/ufoma.4 index 1cbde0f59..8c7e73630 100644 --- a/share/man/man4/ufoma.4 +++ b/share/man/man4/ufoma.4 @@ -97,7 +97,7 @@ When an interface is recognized by the system but not used, the interface will be set to this mode. .It Li unlinked When an interface is not yet negotiated, the interface is in this mode. -.El +.El .Sh HARDWARE Devices supported by the .Nm diff --git a/share/man/man4/upgt.4 b/share/man/man4/upgt.4 index 7042dd7e7..7b8143888 100644 --- a/share/man/man4/upgt.4 +++ b/share/man/man4/upgt.4 @@ -181,13 +181,13 @@ Join an existing BSS network (i.e., connect to an access point): .Bd -literal -offset indent ifconfig wlan create wlandev upgt0 inet 192.168.0.20 \e netmask 0xffffff00 -.Ed -.Pp +.Ed +.Pp Join a specific BSS network with network name -.Dq Li my_net : -.Pp +.Dq Li my_net : +.Pp .Dl "ifconfig wlan create wlandev upgt0 ssid my_net up" -.Pp +.Pp Join a specific BSS network with 64-bit WEP encryption: .Bd -literal -offset indent ifconfig wlan create wlandev upgt0 ssid my_net \e diff --git a/share/man/man4/wbwd.4 b/share/man/man4/wbwd.4 index 2b24fab03..149e44f68 100644 --- a/share/man/man4/wbwd.4 +++ b/share/man/man4/wbwd.4 @@ -72,7 +72,7 @@ The driver provides the following options as .Xr sysctl 8 variables. -.Bl -tag -width "xxxxxx" +.Bl -tag -width "xxxxxx" .It Va dev.wbwd.0.timeout_override This variable allows to program the timer to a value independent on the one provided by the diff --git a/share/man/man4/xen.4 b/share/man/man4/xen.4 index 31096d062..e053fc535 100644 --- a/share/man/man4/xen.4 +++ b/share/man/man4/xen.4 @@ -1,7 +1,7 @@ .\" Copyright (c) 2010 Robert N. M. Watson .\" All rights reserved. .\" -.\" This software was developed by SRI International and the University of +.\" This software was developed by SRI International and the University of .\" Cambridge Computer Laboratory under DARPA/AFRL contract FA8750-10-C-0237 .\" ("CTSRD"), as part of the DARPA CRASH research program. .\" @@ -32,7 +32,7 @@ .Dt XEN 4 .Os .Sh NAME -.Nm xen +.Nm xen .Nd Xen Hypervisor Guest (DomU) Support .Sh SYNOPSIS To compile para-virtualized (PV) Xen guest support into an i386 kernel, place diff --git a/share/man/man5/ar.5 b/share/man/man5/ar.5 index 81bc7e60d..94d1e6866 100644 --- a/share/man/man5/ar.5 +++ b/share/man/man5/ar.5 @@ -237,7 +237,7 @@ the ASCII string No padding is used to separate adjacent file names. .Ss "Archive Symbol Tables" Archive symbol tables are used to speed up link editing by providing a -mapping between the program symbols defined in the archive +mapping between the program symbols defined in the archive and the corresponding archive members. Archive symbol tables are managed by the .Xr ranlib 1 diff --git a/share/man/man5/fdescfs.5 b/share/man/man5/fdescfs.5 index b87d16045..9c615817d 100644 --- a/share/man/man5/fdescfs.5 +++ b/share/man/man5/fdescfs.5 @@ -101,7 +101,7 @@ creates entries for all file descriptors opened by the process. .It Pa /dev/fd/# .El .Sh EXAMPLES -To mount a +To mount a .Nm volume located on .Pa /dev/fd : diff --git a/share/man/man5/fs.5 b/share/man/man5/fs.5 index abb0f470b..0d75aec2a 100644 --- a/share/man/man5/fs.5 +++ b/share/man/man5/fs.5 @@ -408,10 +408,10 @@ Each macro takes a pointer to an extattr structure. Returns a pointer to the next extended attribute following .Fa eap . .It Dv EXTATTR_CONTENT(eap) -Returns a pointer to the extended attribute content referenced by +Returns a pointer to the extended attribute content referenced by .Fa eap . .It Dv EXTATTR_CONTENT_SIZE(eap) -Returns the size of the extended attribute content referenced by +Returns the size of the extended attribute content referenced by .Fa eap . .It Dv EXTATTR_SET_LENGTHS(eap, size) Called with the size of the attribute content after initializing diff --git a/share/man/man5/fstab.5 b/share/man/man5/fstab.5 index adbf48928..060d57ce5 100644 --- a/share/man/man5/fstab.5 +++ b/share/man/man5/fstab.5 @@ -235,7 +235,7 @@ programs to determine the order in which file system and quota checks are done at reboot time. The .Fa fs_passno -field can be any value between 0 and +field can be any value between 0 and .Ql INT_MAX Ns -1 . .Pp The root file system should be specified with a @@ -245,7 +245,7 @@ of 1, and other file systems should have a of 2 or greater. A file system with a .Fa fs_passno -value of 1 is always checked sequentially and be completed before +value of 1 is always checked sequentially and be completed before another file system is processed, and it will be processed before all file systems with a larger .Fa fs_passno . @@ -269,7 +269,7 @@ will assume that the file system does not need to be checked. .Pp The .Fa fs_passno -field can be used to implement finer control when +field can be used to implement finer control when the system utilities may determine that the file system resides on a different physical device, when it actually does not, as with a .Xr ccd 4 diff --git a/share/man/man5/nsmb.conf.5 b/share/man/man5/nsmb.conf.5 index 1b1962871..30fbecd7c 100644 --- a/share/man/man5/nsmb.conf.5 +++ b/share/man/man5/nsmb.conf.5 @@ -132,7 +132,7 @@ is also assigned in this section. .Dq Li FSERVER:USER , defines the user settings and is useful for saving the password used during a specific connection. -The password may be plaintext or obfuscated using simple encryption. +The password may be plaintext or obfuscated using simple encryption. The simple encrypted password starts with the `$$1' symbols. Warning: the encryption function is very weak and intended only to hide clear text passwords. @@ -140,7 +140,7 @@ If the use of simple encryption is desired, the following command may be used on a password: .Bd -literal -offset indent smbutil crypt -.Ed +.Ed .Sh COMPATIBILITY At the time of this writing, the .Tn IPX diff --git a/share/man/man5/quota.user.5 b/share/man/man5/quota.user.5 index f502a5187..c314b654e 100644 --- a/share/man/man5/quota.user.5 +++ b/share/man/man5/quota.user.5 @@ -44,7 +44,7 @@ It is possible to specify a different location and file name with the and .Dq Li groupquota options in the -.Xr fstab 5 +.Xr fstab 5 file. .Pp The data files contain the following information: @@ -72,9 +72,9 @@ See .Xr edquota 8 for an explanation on the various limits and grace periods. .Pp -During normal quota operations the +During normal quota operations the .Xr quotactl 2 -interface is used to query or set quota information and the kernel +interface is used to query or set quota information and the kernel will maintain the data files as needed. If quotas are disabled on a file system, but marked as having quotas enabled in @@ -104,8 +104,8 @@ or .Dq Dv dbq_itime fields are non-zero, they are used to indicate the grace period on that file system for users who have exceeded their soft limit. -These times can be set by -.Xr edquota 8 +These times can be set by +.Xr edquota 8 with the .Fl t flag. diff --git a/share/man/man5/services.5 b/share/man/man5/services.5 index 55e0c9d73..d1153d9d5 100644 --- a/share/man/man5/services.5 +++ b/share/man/man5/services.5 @@ -66,7 +66,7 @@ Service names may contain any printable character other than a field delimiter, newline, or comment character. .Pp -If +If .Dq db is specified as source in the .Xr nsswitch.conf 5 , diff --git a/share/man/man7/release.7 b/share/man/man7/release.7 index 936e98b71..a725fc627 100644 --- a/share/man/man7/release.7 +++ b/share/man/man7/release.7 @@ -24,7 +24,7 @@ .\" .\" $FreeBSD$ .\" -.Dd March 18, 2011 +.Dd January 14, 2012 .Dt RELEASE 7 .Os .Sh NAME @@ -53,7 +53,7 @@ and with clean checkouts of specific versions of the doc, src, and ports trees. For this purpose, a script .Pq Pa src/release/generate-release.sh is provided to automate these checkouts and then execute -.Dq Li "make release" +.Dq Li "make release" in a clean .Xr chroot 8 . .Pp @@ -65,7 +65,7 @@ and should have experience upgrading systems from source. The release build process requires that .Pa /usr/obj be populated with the output of -.Dq Li "make buildworld" +.Dq Li "make buildworld" and .Dq Li "make buildkernel" . This is necessary to provide the object files for the release or, when @@ -139,7 +139,7 @@ must be specified for ports and documentation to be included in the release. .It Ev CVS_TAG If the variable .Ev CVS_TAG -is set, that tag will be used for CVS checkouts (doc and ports), otherwise +is set, that tag will be used for CVS checkouts (doc and ports), otherwise .Ic generate-release.sh will use HEAD. .It Ev MAKE_FLAGS @@ -149,6 +149,11 @@ when invoked by the script. .It Ev SVNROOT The location of the FreeBSD SVN source repository. Defaults to .Pa svn://svn.freebsd.org/base . +.It Ev RELSTRING +Optional base name for generated media images (e.g. FreeBSD-9.0-RC2-amd64). +Defaults to the output of +.Ic `uname -s`-`uname -r`-`uname -p` +within the chroot. .El .Sh MAKEFILE TARGETS The release makefile @@ -165,12 +170,12 @@ targets. Meta-target to build all release media and distributions applicable to this platform. .It Cm install -Copy all produced release media to +Copy all produced release media to .Pa ${DESTDIR} . .It Cm cdrom Builds installation CD-ROM images. On some systems, this may require that .Xr mkisofs 8 -be installed +be installed .Pq Pa sysutils/cdrtools and possibly that the .Xr md 4 @@ -216,7 +221,7 @@ hardware guide, and installation instructions. Other documentation (e.g. the Handbook) is built during the .Cm base.txz target invoked by -.Cm packagesystem . +.Cm packagesystem. .El .Sh ENVIRONMENT Optional variables: @@ -234,7 +239,7 @@ Location of a directory containing the doc tree. By default, .Pa /usr/doc . If it is unset or cannot be found, most documentation will not be included in the release; see -.Ev NODOC +.Ev NODOC below. .It Va NOPORTS If defined, the Ports Collection will be omitted from the release. @@ -278,7 +283,7 @@ Typically, one only needs to set .Va TARGET . .El .Sh FILES -.Bl -tag -compact -width Pa +.Bl -tag -compact .It Pa /usr/doc/Makefile .It Pa /usr/doc/share/mk/doc.project.mk .It Pa /usr/ports/Mk/bsd.port.mk @@ -311,9 +316,7 @@ The following sequence of commands can be used to build a .Dq "-CURRENT snapshot" in a clean environment, including ports and documentation: .Bd -literal -offset indent -cd /usr/src -make buildworld -cd release +cd /usr/src/release export CVSUP_HOST=cvsupN.freebsd.org sh generate-release.sh head /local3/release .Ed @@ -366,7 +369,7 @@ of building a release in a sterile environment. .Pp For the .Fx 9.0 -release, +release, .Pa src/release/Makefile was overhauled and the wrapper script .Pa src/release/generate-release.sh diff --git a/share/man/man8/picobsd.8 b/share/man/man8/picobsd.8 index e95786d66..07373f67b 100644 --- a/share/man/man8/picobsd.8 +++ b/share/man/man8/picobsd.8 @@ -648,7 +648,7 @@ already exists on disk (e.g.\& as a result of a previous update). .Xr crunchgen 1 , .Xr mdconfig 8 , .Xr nanobsd 8 , -.Xr swapon 8 +.Xr swapon 8 .Sh AUTHORS .An -nosplit .An Andrzej Bialecki Aq abial@FreeBSD.org , diff --git a/share/man/man9/BUS_DESCRIBE_INTR.9 b/share/man/man9/BUS_DESCRIBE_INTR.9 index 0163e7023..b7f137b5b 100644 --- a/share/man/man9/BUS_DESCRIBE_INTR.9 +++ b/share/man/man9/BUS_DESCRIBE_INTR.9 @@ -45,7 +45,7 @@ .Ft int .Fo bus_describe_intr .Fa "device_t dev" "struct resource *irq" "void *cookie" "const char *fmt" -.Fa ... +.Fa ... .Fc .Sh DESCRIPTION The diff --git a/share/man/man9/BUS_SETUP_INTR.9 b/share/man/man9/BUS_SETUP_INTR.9 index 391057060..8264a999a 100644 --- a/share/man/man9/BUS_SETUP_INTR.9 +++ b/share/man/man9/BUS_SETUP_INTR.9 @@ -130,8 +130,8 @@ Mutexes are not allowed to be held across calls to these functions. A filter runs in primary interrupt context. In this context, normal mutexes cannot be used. Only the spin lock version of these can be used (specified by passing -.Dv MTX_SPIN -to +.Dv MTX_SPIN +to .Fn mtx_init when initializing the mutex). .Xr wakeup 9 diff --git a/share/man/man9/DB_COMMAND.9 b/share/man/man9/DB_COMMAND.9 index e325f0fd0..099b27ea0 100644 --- a/share/man/man9/DB_COMMAND.9 +++ b/share/man/man9/DB_COMMAND.9 @@ -38,9 +38,9 @@ .Fo DB_COMMAND .Fa command_name .Fa command_function -.Fc -.Fn DB_SHOW_COMMAND "command_name" "command_function" -.Fn DB_SHOW_ALL_COMMAND "command_name" "command_function" +.Fc +.Fn DB_SHOW_COMMAND "command_name" "command_function" +.Fn DB_SHOW_ALL_COMMAND "command_name" "command_function" .Sh DESCRIPTION .Pp The @@ -48,9 +48,9 @@ The macro adds .Fa command_name to the list of top-level commands. -Invoking +Invoking .Fa command_name -from ddb will call +from ddb will call .Fa command_function . .Pp The @@ -61,14 +61,14 @@ are roughly equivalent to .Fn DB_COMMAND but in these cases, .Fa command_name -is a sub-command of the ddb +is a sub-command of the ddb .Sy show command and .Sy show all command, respectively. .Pp The general command syntax: -.Cm command Ns Op Li \&/ Ns Ar modifier +.Cm command Ns Op Li \&/ Ns Ar modifier .Ar address Ns Op Li , Ns Ar count , translates into the following parameters for .Fa command_function : diff --git a/share/man/man9/DEVICE_PROBE.9 b/share/man/man9/DEVICE_PROBE.9 index b536b90ec..86b833928 100644 --- a/share/man/man9/DEVICE_PROBE.9 +++ b/share/man/man9/DEVICE_PROBE.9 @@ -96,7 +96,7 @@ all the rules, or special needs drivers). .It BUS_PROBE_VENDOR The device is supported by a vendor driver. This is for source or binary drivers that are not yet integrated into the -.Fx +.Fx tree. Its use in the base OS is prohibited. .It BUS_PROBE_DEFAULT @@ -119,8 +119,8 @@ drivers matching particular types of serial ports that need special treatment for some reason. .It BUS_PROBE_HOOVER The driver matches all unclaimed devices on a bus. -The -.Xr ugen 4 +The +.Xr ugen 4 device is one example. .It BUS_PROBE_NOWILDCARD The driver expects its parent to tell it which children to manage diff --git a/share/man/man9/SYSINIT.9 b/share/man/man9/SYSINIT.9 index 9140dd830..1837d25d4 100644 --- a/share/man/man9/SYSINIT.9 +++ b/share/man/man9/SYSINIT.9 @@ -29,7 +29,7 @@ .Os .Sh NAME .Nm SYSINIT , -.Nm SYSUNINIT +.Nm SYSUNINIT .Nd a framework for dynamic kernel initialization .Sh SYNOPSIS .In sys/param.h diff --git a/share/man/man9/buf_ring.9 b/share/man/man9/buf_ring.9 index 3b73607bb..ffade9444 100644 --- a/share/man/man9/buf_ring.9 +++ b/share/man/man9/buf_ring.9 @@ -68,7 +68,7 @@ The .Nm functions provide a lock-less multi-producer and lock-less multi-consumer as -well as single-consumer ring buffer. +well as single-consumer ring buffer. .Pp The .Fn buf_ring_alloc diff --git a/share/man/man9/condvar.9 b/share/man/man9/condvar.9 index db3eab122..7b89d46d6 100644 --- a/share/man/man9/condvar.9 +++ b/share/man/man9/condvar.9 @@ -117,10 +117,10 @@ argument is a pointer to either a or .Xr sx 9 lock. -A +A .Xr mutex 9 argument must be initialized with -.Dv MTX_DEF +.Dv MTX_DEF and not .Dv MTX_SPIN . A thread must hold diff --git a/share/man/man9/devclass_get_maxunit.9 b/share/man/man9/devclass_get_maxunit.9 index 1083808e2..40a2d7929 100644 --- a/share/man/man9/devclass_get_maxunit.9 +++ b/share/man/man9/devclass_get_maxunit.9 @@ -48,7 +48,7 @@ The .Fn devclass_get_maxunit function returns -1 if .Fa dc -is +is .Dv NULL , otherwise it returns the next unit number in diff --git a/share/man/man9/device_get_children.9 b/share/man/man9/device_get_children.9 index 677d8eb59..cbc1124a2 100644 --- a/share/man/man9/device_get_children.9 +++ b/share/man/man9/device_get_children.9 @@ -48,9 +48,9 @@ and the count in .Fa *devcountp . The memory allocated for the list should be freed using .Fn free "*devlistp" "M_TEMP" . -.Fa devlistp +.Fa devlistp and -.Fa devcountp +.Fa devcountp are not changed when an error is returned. .Sh RETURN VALUES Zero is returned on success, otherwise an appropriate error is returned. diff --git a/share/man/man9/drbr.9 b/share/man/man9/drbr.9 index ad67c35e4..168ce1047 100644 --- a/share/man/man9/drbr.9 +++ b/share/man/man9/drbr.9 @@ -76,7 +76,7 @@ is enabled, will assert that the tx queue lock is held when it is called. .Pp The -.Fn drbr_free +.Fn drbr_free function frees all the enqueued mbufs and then frees the buf_ring. .Pp The @@ -106,7 +106,7 @@ The .Fn drbr_flush function frees all mbufs enqueued in the buf_ring and the ifnet's IFQ. .Pp -The +The .Fn drbr_empty function returns .Dv TRUE @@ -118,7 +118,7 @@ The .Fn drbr_inuse function returns the number of mbufs enqueued. Note to users that this is intrinsically racy as there is no guarantee that -there will not be more mbufs when +there will not be more mbufs when .Fn drbr_dequeue is actually called. Provided the tx queue lock is held there will not be less. @@ -137,7 +137,7 @@ on success. .Pp The .Fn drbr_dequeue -and +and .Fn drbr_dequeue_cond functions return an mbuf on success and .Dv NULL diff --git a/share/man/man9/eventtimers.9 b/share/man/man9/eventtimers.9 index 8a66b327c..6758f0448 100644 --- a/share/man/man9/eventtimers.9 +++ b/share/man/man9/eventtimers.9 @@ -213,7 +213,7 @@ is the opposite to It releases the event timer for other consumers use. .Pp .Fn ET_LOCK -and +and .Fn ET_UNLOCK macros should be used to manage .Xr mutex 9 diff --git a/share/man/man9/firmware.9 b/share/man/man9/firmware.9 index 9cb7fa33c..0f4fa9af6 100644 --- a/share/man/man9/firmware.9 +++ b/share/man/man9/firmware.9 @@ -159,7 +159,7 @@ argument may be set to to indicate that firmware_put is free to reclaim resources associated with the firmware image if this is the last reference. -By default a firmware image will be deferred to a +By default a firmware image will be deferred to a .Xr taskqueue 9 thread so the call may be done while holding a lock. In certain cases, such as on driver detach, this cannot be allowed. diff --git a/share/man/man9/ieee80211.9 b/share/man/man9/ieee80211.9 index 30affc9b8..1e53cf6b2 100644 --- a/share/man/man9/ieee80211.9 +++ b/share/man/man9/ieee80211.9 @@ -29,7 +29,7 @@ .Dt IEEE80211 9 .Os .Sh NAME -.Nm IEEE80211 +.Nm IEEE80211 .Nd 802.11 network layer .Sh SYNOPSIS .In net80211/ieee80211_var.h @@ -164,7 +164,7 @@ Table of channels the device is capable of operating on. This is initially provided by the driver but may be changed through calls that change the regulatory state. .It Dv ic_nchan -Number of entries in +Number of entries in .Dv ic_channels . .El .Pp @@ -221,7 +221,7 @@ There is no default method; the pointer may be NULL in which case it will not be used. .It Dv ic_node_alloc Allocate and initialize a -.Vt ieee80211_node +.Vt ieee80211_node structure. This method cannot sleep. The default method allocates zero'd memory using @@ -232,7 +232,7 @@ Memory allocated by the driver must be tagged with .Dv M_80211_NODE to balance the memory allocation statistics. .It Dv ic_node_free -Reclaim storage of a node allocated by +Reclaim storage of a node allocated by .Dv ic_node_alloc . Drivers are expected to .Em interpose @@ -302,7 +302,7 @@ and must initiate the work to scan a channel and schedule a timer to advance to the next channel in the scan list. This callback is done in a sleepable context. The default method handles active scan work (e.g. sending ProbeRequest -frames), and schedules a call to +frames), and schedules a call to .Xr ieee80211_scan_next 9 according to the maximum dwell time for the channel. Drivers that off-load scan work to firmware typically use this method @@ -354,7 +354,7 @@ Terminate receipt of A-MPDU data from the specified station for the TID. .El .Pp Once the -.Nm +.Nm layer is attached to a driver there are two more steps typically done to complete the work: .Bl -enum @@ -405,7 +405,7 @@ The following general capabilities are defined: Device is capable of operating in station (aka Infrastructure) mode. .It Dv IEEE80211_C_8023ENCAP Device requires 802.3-encapsulated frames be passed for transmit. -By default +By default .Nm will encapsulate all outbound frames as 802.11 frames (without a PLCP header). .It Dv IEEE80211_C_FF @@ -529,16 +529,16 @@ Device supports L-SIG TXOP protection. .It Dv IEEE80211_HTC_AMPDU Device supports A-MPDU aggregation. Note that any 802.11n compliant device must support A-MPDU receive -so this implicitly means support for +so this implicitly means support for .Em transmit of A-MPDU frames. .It Dv IEEE80211_HTC_AMSDU Device supports A-MSDU aggregation. Note that any 802.11n compliant device must support A-MSDU receive -so this implicitly means support for +so this implicitly means support for .Em transmit of A-MSDU frames. -.It Dv IEEE80211_HTC_HT +.It Dv IEEE80211_HTC_HT Device supports High Throughput (HT) operation. This capability must be set to enable 802.11n functionality in diff --git a/share/man/man9/ieee80211_amrr.9 b/share/man/man9/ieee80211_amrr.9 index 8206b2da5..a90de3dc2 100644 --- a/share/man/man9/ieee80211_amrr.9 +++ b/share/man/man9/ieee80211_amrr.9 @@ -86,7 +86,7 @@ rate for each frame. To maximize throughput algorithms try to use the highest rate that is appropriate for the operating conditions. The rate will vary as conditions change; the distance between two stations -may change, transient noise may be present that affects signal quality, +may change, transient noise may be present that affects signal quality, etc. .Nm uses very simple information from a driver to do it's job: @@ -119,8 +119,8 @@ The .Vt amrr structure member holds the per-vap state for .Nm -and -.Xr ral 4 +and +.Xr ral 4 initializes it in the vap create method with: .Bd -literal -offset indent ieee80211_amrr_init(&rvp->amrr, vap, diff --git a/share/man/man9/ieee80211_bmiss.9 b/share/man/man9/ieee80211_bmiss.9 index bd82c3c0b..63b8e9f4a 100644 --- a/share/man/man9/ieee80211_bmiss.9 +++ b/share/man/man9/ieee80211_bmiss.9 @@ -56,9 +56,9 @@ This causes some number of ProbeRequest frames to be sent to the access point to check if the association is still alive. If no response is received and roaming mode is set to .Dv IEEE80211_ROAMING_AUTO -then +then .Nm net80211 -will try to re-associate and if that fails +will try to re-associate and if that fails trigger a scan to look for the access point or another suitable AP. When the .Nm net80211 diff --git a/share/man/man9/ieee80211_input.9 b/share/man/man9/ieee80211_input.9 index 61b11a5b3..9422f0bc6 100644 --- a/share/man/man9/ieee80211_input.9 +++ b/share/man/man9/ieee80211_input.9 @@ -110,7 +110,7 @@ RSSI and noise are used by the layer to make scanning and roaming decisions in station mode and to do auto channel selection for hostap and similar modes. Otherwise the values are made available to user applications -(with the rssi presented as a filtered average over the last ten values +(with the rssi presented as a filtered average over the last ten values and the noise floor the last reported value). .Sh SEE ALSO .Xr ieee80211 9 diff --git a/share/man/man9/ieee80211_node.9 b/share/man/man9/ieee80211_node.9 index 180d8c493..452bbcc19 100644 --- a/share/man/man9/ieee80211_node.9 +++ b/share/man/man9/ieee80211_node.9 @@ -67,18 +67,18 @@ .Ft void .Fo ieee80211_dump_nodes .Fa "struct ieee80211_node_table *" -.Fc +.Fc .\" .Ft void .Fo ieee80211_dump_node .Fa "struct ieee80211_node *" -.Fc +.Fc .Sh DESCRIPTION The .Nm net80211 layer that supports 802.11 device drivers maintains a database of peer stations called the -.Dq node table +.Dq node table in the .Vt ic_sta entry of the @@ -125,7 +125,7 @@ field. This reference must be reclaimed by the driver when transmit processing is done. For each frame received the driver must lookup the table entry to -use in dispatching the frame +use in dispatching the frame .Dq up the stack . This lookup implicitly obtains a reference to the table entry and the driver must reclaim the reference when frame processing is completed. @@ -139,7 +139,7 @@ Entries may be looked up using one of the pre-defined API's or the .Fn ieee80211_iterate_nodes call may be used to iterate through all entries to do per-node processing or implement some non-standard search mechanism. -Note that +Note that .Fn ieee80211_iterate_nodes is single-threaded per-device and the effort processing involved is fairly @@ -206,7 +206,7 @@ iwi_node_free(struct ieee80211_node *ni) struct ieee80211com *ic = ni->ni_ic; struct iwi_softc *sc = ic->ic_ifp->if_softc; struct iwi_node *in = (struct iwi_node *)ni; - + if (in->in_station != -1) free_unr(sc->sc_unr, in->in_station); sc->sc_node_free(ni); /* invoke net80211 free handler */ diff --git a/share/man/man9/ieee80211_output.9 b/share/man/man9/ieee80211_output.9 index 82393bdaa..6a8d3a71e 100644 --- a/share/man/man9/ieee80211_output.9 +++ b/share/man/man9/ieee80211_output.9 @@ -110,13 +110,13 @@ node table entry in the field. The node is associated with the frame destination. Typically it is the receiver's entry but in some situations it may be -a placeholder entry or the +a placeholder entry or the .Dq next hop station (such as in a mesh network). In all cases the reference must be reclaimed with .Fn ieee80211_free_node when the transmit work is completed. -The rule to remember is: +The rule to remember is: .Nm net80211 passes responsibility for the .Vt mbuf @@ -131,7 +131,7 @@ assigned to the receiving station and/or any Diffserv setting in an IP or IPv6 header. If both vlan and Diffserv priority are present the higher of the two is used. -If WME/WMM is being used then any ACM policy (in station mode) is +If WME/WMM is being used then any ACM policy (in station mode) is also enforced. The resulting AC is attached to the mbuf and may be read back using the .Fn M_WME_GETAC @@ -182,7 +182,7 @@ The callback is done using .Fn ieee80211_process_callback with the last parameter set to a non-zero value if an error occurred and zero otherwise. -Note +Note .Nm net80211 understands that drivers may be incapable of determining status; a device may not report if an ACK frame is received and/or a device may queue diff --git a/share/man/man9/ieee80211_proto.9 b/share/man/man9/ieee80211_proto.9 index 1ac94d1e0..6b0da064d 100644 --- a/share/man/man9/ieee80211_proto.9 +++ b/share/man/man9/ieee80211_proto.9 @@ -108,7 +108,7 @@ Beware that data traffic is also gated by whether the associated .Dq port is authorized. When WPA/802.11i/802.1x is operational authorization may happen separately; -e.g. in station mode +e.g. in station mode .Xr wpa_supplicant 8 must complete the handshakes and plumb the necessary keys before a port is authorized. @@ -143,14 +143,14 @@ Certain .Nm net80211 data are valid only in certain states; e.g. the .Vt iv_bsschan -that specifies the channel for the operating BSS should never be used +that specifies the channel for the operating BSS should never be used except in .Dv IEEE80211_S_RUN or greater. .Sh STATE CHANGES State machine changes are typically handled internal to the .Nm net80211 -layer in response to +layer in response to .Xr ioctl 2 requests, received frames, or external events such as a beacon miss. The @@ -161,7 +161,7 @@ The request is initially processed to handle coordination of multiple vaps. For example, only one vap at a time can be scanning, if multiple vaps request a change to .Dv IEEE80211_S_SCAN -the first will be permitted to run and the others will be +the first will be permitted to run and the others will be .Em deferred until the scan operation completes at which time the selected channel will be adopted. @@ -197,12 +197,12 @@ call the handles two state changes specially. On transition to .Dv IEEE80211_S_RUN -the +the .Dv IFF_DRV_OACTIVE bit on the vap's transmit queue is cleared so traffic can flow. On transition to .Dv IEEE80211_S_INIT -any state in the scan cache associated with the vap is flushed +any state in the scan cache associated with the vap is flushed and any frames pending on the transmit queue are flushed. .Sh DRIVER INTEGRATION Drivers are expected to override the diff --git a/share/man/man9/ieee80211_radiotap.9 b/share/man/man9/ieee80211_radiotap.9 index 8d44a4785..cea2eb4e7 100644 --- a/share/man/man9/ieee80211_radiotap.9 +++ b/share/man/man9/ieee80211_radiotap.9 @@ -61,7 +61,7 @@ The .Nm net80211 layer used by 802.11 drivers includes support for a device-independent packet capture format called -.Nm radiotap +.Nm radiotap that is understood by tools such as .Xr tcpdump 1 . This facility is designed for capturing 802.11 traffic, @@ -257,7 +257,7 @@ struct wi_rx_radiotap_header { uint16_t wr_chan_flags; uint8_t wr_antsignal; uint8_t wr_antnoise; -} __packed; +} __packed; .Ed .Pp and transmit definitions for the Atheros driver: diff --git a/share/man/man9/ieee80211_regdomain.9 b/share/man/man9/ieee80211_regdomain.9 index 527deb51c..da310ddc7 100644 --- a/share/man/man9/ieee80211_regdomain.9 +++ b/share/man/man9/ieee80211_regdomain.9 @@ -56,7 +56,7 @@ The software layer provides a support framework for drivers that includes comprehensive regulatory support. .Nm net80211 -provides mechanisms that enforce +provides mechanisms that enforce .Em "regulatory policy" by privileged user applications. .Pp @@ -102,7 +102,7 @@ and leave proper setup to user applications. If default settings are known they can be installed and/or an event can be dispatched to user space using .Fn ieee80211_notify_country -so that +so that .Xr devd 8 will do the appropriate setup work at system boot (or device insertion). .Pp diff --git a/share/man/man9/ieee80211_scan.9 b/share/man/man9/ieee80211_scan.9 index b2b77cf86..54cefa750 100644 --- a/share/man/man9/ieee80211_scan.9 +++ b/share/man/man9/ieee80211_scan.9 @@ -322,7 +322,7 @@ Existing entries are typically updated based on the latest information though some information such as RSSI and noise floor readings may be combined to present an average. .Pp -The cache contents is aged through +The cache contents is aged through .Fn ieee80211_scan_timeout calls. Typically these happen together with other station table activity; every diff --git a/share/man/man9/ieee80211_vap.9 b/share/man/man9/ieee80211_vap.9 index f5ef20bd4..0c68f6dae 100644 --- a/share/man/man9/ieee80211_vap.9 +++ b/share/man/man9/ieee80211_vap.9 @@ -93,7 +93,7 @@ This data structure must have an structure at the front but is usually extended with driver-private state. Next the vap is setup with a call to .Fn ieee80211_vap_setup . -This request initializes +This request initializes .Nm net80211 state but does not activate the interface. The driver can then override methods setup by @@ -108,7 +108,7 @@ A vap is deleted when an .Dv SIOCIFDESTROY ioctl request is made or when the device detaches (causing all associated vaps to automatically be deleted). -Delete requests cause the +Delete requests cause the .Vt ic_vap_delete method to be called. Drivers must quiesce the device before calling diff --git a/share/man/man9/kproc.9 b/share/man/man9/kproc.9 index a20ab709b..613ac31bc 100644 --- a/share/man/man9/kproc.9 +++ b/share/man/man9/kproc.9 @@ -77,8 +77,8 @@ A new family of .Fn kthread_* 9 functions was added to produce .Em real -kernel -.Em threads . +kernel +.Em threads . See the .Xr kthread 9 man page for more information on those calls. @@ -227,7 +227,7 @@ The actual suspension of the kernel process is done with .Pp The .Fn kproc_kthread_add -function is much like the +function is much like the .Fn kproc_create function above except that if the kproc already exists, then only a new thread (see diff --git a/share/man/man9/kthread.9 b/share/man/man9/kthread.9 index d2c770b95..25a20cecf 100644 --- a/share/man/man9/kthread.9 +++ b/share/man/man9/kthread.9 @@ -82,7 +82,7 @@ kernel threads. See the .Xr kproc 9 man page for more information on the renamed calls. -Also note that the +Also note that the .Fn kproc_kthread_add 9 function appears in both pages as its functionality is split. .Pp @@ -184,11 +184,11 @@ member of the new thread's .Pp The .Fn kproc_kthread_add -function is much like the +function is much like the .Fn kthread_add function above except that if the kproc does not already -exist, it is created. -This function is better documented in the +exist, it is created. +This function is better documented in the .Xr kproc 9 manual page. .Pp diff --git a/share/man/man9/lock.9 b/share/man/man9/lock.9 index 5134894d9..989cb16ee 100644 --- a/share/man/man9/lock.9 +++ b/share/man/man9/lock.9 @@ -364,7 +364,7 @@ or the .Fa ilk must be held prior to calling -.Fn lockmgr +.Fn lockmgr or .Fn lockmgr_rw , and will be returned unlocked. diff --git a/share/man/man9/locking.9 b/share/man/man9/locking.9 index de027e955..7cb471544 100644 --- a/share/man/man9/locking.9 +++ b/share/man/man9/locking.9 @@ -82,7 +82,7 @@ since it may modify protected data. Reader/writer locks can be treated as mutexes (see above and .Xr mutex 9 ) with shared/exclusive semantics. -More specifically, regular mutexes can be +More specifically, regular mutexes can be considered to be equivalent to a write-lock on an .Em rw_lock. The @@ -94,7 +94,7 @@ are anonymous. Another important property is that shared holders of .Em rw_lock can recurse, but exclusive locks are not allowed to recurse. -This ability should not be used lightly and +This ability should not be used lightly and .Em may go away. .Pp See @@ -122,7 +122,7 @@ and read-mostly locks. They don't support priority propagation. They should be considered to be closely related to .Xr sleep 9 . -In fact it could in some cases be +In fact it could in some cases be considered a conditional sleep. .Pp See @@ -339,10 +339,10 @@ At this time this is a rather easy to remember table. .It Xo .Em "Context:" Ta spin mtx Ta mutex Ta sx Ta rwlock Ta rmlock Ta sleep .Xc -.It interrupt filter: Ta \&ok Ta \&no Ta \&no Ta \&no Ta \&no Ta \&no -.It interrupt thread: Ta \&ok Ta \&ok Ta \&no Ta \&ok Ta \&ok Ta \&no -.It callout: Ta \&ok Ta \&ok Ta \&no Ta \&ok Ta \&no Ta \&no -.It syscall: Ta \&ok Ta \&ok Ta \&ok Ta \&ok Ta \&ok Ta \&ok +.It interrupt filter: Ta \&ok Ta \&no Ta \&no Ta \&no Ta \&no Ta \&no +.It interrupt thread: Ta \&ok Ta \&ok Ta \&no Ta \&ok Ta \&ok Ta \&no +.It callout: Ta \&ok Ta \&ok Ta \&no Ta \&ok Ta \&no Ta \&no +.It syscall: Ta \&ok Ta \&ok Ta \&ok Ta \&ok Ta \&ok Ta \&ok .El .Sh SEE ALSO .Xr witness 4 , diff --git a/share/man/man9/malloc.9 b/share/man/man9/malloc.9 index ff6b4d282..749093931 100644 --- a/share/man/man9/malloc.9 +++ b/share/man/man9/malloc.9 @@ -29,7 +29,7 @@ .\" $NetBSD: malloc.9,v 1.3 1996/11/11 00:05:11 lukem Exp $ .\" $FreeBSD$ .\" -.Dd October 23, 2008 +.Dd January 28, 2012 .Dt MALLOC 9 .Os .Sh NAME @@ -123,6 +123,9 @@ operational characteristics as follows: .Bl -tag -width indent .It Dv M_ZERO Causes the allocated memory to be set to all zeros. +.It Dv M_NODUMP +For allocations greater than page size, causes the allocated +memory to be excluded from kernel core dumps. .It Dv M_NOWAIT Causes .Fn malloc , diff --git a/share/man/man9/mi_switch.9 b/share/man/man9/mi_switch.9 index 2f82b5a21..46e7a8e9e 100644 --- a/share/man/man9/mi_switch.9 +++ b/share/man/man9/mi_switch.9 @@ -62,7 +62,7 @@ From within a function such as .Xr cv_wait 9 , .Xr mtx_lock , or -.Xr tsleep 9 +.Xr tsleep 9 when the current thread voluntarily relinquishes the CPU to wait for some resource or lock to become available. diff --git a/share/man/man9/osd.9 b/share/man/man9/osd.9 index 871575c46..ba9c632e1 100644 --- a/share/man/man9/osd.9 +++ b/share/man/man9/osd.9 @@ -125,7 +125,7 @@ and remains valid until a corresponding call to .Ss Functions The .Fn osd_register -function registers a type/slot identifier pair with the +function registers a type/slot identifier pair with the .Nm framework for use with a new data type. The function may sleep and therefore cannot be called from a non-sleepable diff --git a/share/man/man9/rmlock.9 b/share/man/man9/rmlock.9 index 2e68b0704..948cc32d8 100644 --- a/share/man/man9/rmlock.9 +++ b/share/man/man9/rmlock.9 @@ -80,7 +80,7 @@ Read mostly locks are designed to be efficient for locks almost exclusively used as reader locks and as such should be used for protecting data that rarely changes. Acquiring an exclusive lock after the lock had been locked for shared access -is an expensive operation. +is an expensive operation. .Pp Although reader/writer locks look very similar to .Xr sx 9 @@ -196,9 +196,9 @@ This function releases a shared lock previously acquired by .Fn rm_rlock . The .Fa tracker -argument must match the -.Fa tracker -argument used for acquiring the shared lock +argument must match the +.Fa tracker +argument used for acquiring the shared lock .It Fn rm_wunlock "struct rmlock *rm" This function releases an exclusive lock previously acquired by .Fn rm_wlock . @@ -248,7 +248,7 @@ The implementation uses a single per CPU list shared by all rmlocks in the system. If rmlocks become popular, hashing to multiple per CPU queues may -be needed to speed up the writer lock process. +be needed to speed up the writer lock process. .Pp The .Nm diff --git a/share/man/man9/shm_map.9 b/share/man/man9/shm_map.9 index a711fb620..4ba822260 100644 --- a/share/man/man9/shm_map.9 +++ b/share/man/man9/shm_map.9 @@ -125,7 +125,7 @@ shm_example(int fd) fdrop(fp, curthread); return (error); } - + /* Do something with 'mem'. */ error = shm_unmap(fp, mem, 16384); diff --git a/share/man/man9/sleep.9 b/share/man/man9/sleep.9 index 469df9c9f..91417620a 100644 --- a/share/man/man9/sleep.9 +++ b/share/man/man9/sleep.9 @@ -93,7 +93,7 @@ then the thread will be made runnable with the specified .Fa priority when it resumes. -.Dv PZERO +.Dv PZERO should never be used, as it is for compatibility only. A new priority of 0 means to use the thread's current priority when it is made runnable again. @@ -243,7 +243,7 @@ It is the programmer's responsibility to choose a unique value. The older .Fn wakeup -function did not require this, though it was never good practice +function did not require this, though it was never good practice for threads to share a .Fa chan value. diff --git a/share/man/man9/spl.9 b/share/man/man9/spl.9 index 017807d07..3bfa556d4 100644 --- a/share/man/man9/spl.9 +++ b/share/man/man9/spl.9 @@ -80,8 +80,8 @@ code locking that the spl did when converting code from versions of the kernel prior to .Fx 5.0 . The examples in this man page are also obsolete and should not be viewed -as documenting -.Fx 5.0 +as documenting +.Fx 5.0 and newer. .Ef .Pp diff --git a/share/man/man9/sysctl_ctx_init.9 b/share/man/man9/sysctl_ctx_init.9 index f17ca3a33..cbca5c619 100644 --- a/share/man/man9/sysctl_ctx_init.9 +++ b/share/man/man9/sysctl_ctx_init.9 @@ -135,7 +135,7 @@ in most cases, the programmer specifies as the oid number when creating an oid. However, during registration of the oid in the tree, this number is changed to the first available number -greater than or equal to +greater than or equal to .Dv CTL_AUTO_START . If the first step of context deletion fails, re-registration of the oid does not change the already assigned oid number diff --git a/share/man/man9/taskqueue.9 b/share/man/man9/taskqueue.9 index 6fa67660f..f1a43b609 100644 --- a/share/man/man9/taskqueue.9 +++ b/share/man/man9/taskqueue.9 @@ -116,8 +116,8 @@ thread). The memory location where the thread identity is recorded is used to signal the service thread(s) to terminate--when this value is set to zero and the thread is signaled it will terminate. -If the queue is intended for use in fast interrupt handlers -.Fn taskqueue_create_fast +If the queue is intended for use in fast interrupt handlers +.Fn taskqueue_create_fast should be used in place of .Fn taskqueue_create . .Pp @@ -296,9 +296,9 @@ The variable is used to enqueue tasks onto the queue. .Pp .Fn TASKQUEUE_FAST_DEFINE -and +and .Fn TASKQUEUE_FAST_DEFINE_THREAD -act just like +act just like .Fn TASKQUEUE_DEFINE and .Fn TASKQUEUE_DEFINE_THREAD diff --git a/share/man/man9/timeout.9 b/share/man/man9/timeout.9 index 36731c8a2..ddc66b573 100644 --- a/share/man/man9/timeout.9 +++ b/share/man/man9/timeout.9 @@ -197,9 +197,9 @@ The function initializes a callout so it can be passed to .Fn callout_stop , .Fn callout_drain , -.Fn callout_reset +.Fn callout_reset or -.Fn callout_schedule +.Fn callout_schedule without any side effects. If the .Fa mpsafe diff --git a/share/man/man9/usbdi.9 b/share/man/man9/usbdi.9 index 7f656d9fd..03cc3057b 100644 --- a/share/man/man9/usbdi.9 +++ b/share/man/man9/usbdi.9 @@ -179,7 +179,7 @@ zero upon success. A non-zero return value indicates failure. . .Fn usbd_transfer_unsetup This function will release the given USB transfers and all allocated -resources associated with these USB transfers. +resources associated with these USB transfers. .Fa pxfer is a pointer to an array of USB transfer pointers, that may be NULL, that should be freed by the USB system. @@ -283,15 +283,15 @@ usb_default_callback(struct usb_xfer *xfer, usb_error_t error) usbd_xfer_status(xfer, &actlen, NULL, NULL, NULL); switch (USB_GET_STATE(xfer)) { - case USB_ST_SETUP: + case USB_ST_SETUP: /* * Setup xfer frame lengths/count and data */ usbd_transfer_submit(xfer); break; - case USB_ST_TRANSFERRED: - /* + case USB_ST_TRANSFERRED: + /* * Read usb frame data, if any. * "actlen" has the total length for all frames * transferred. @@ -300,13 +300,13 @@ usb_default_callback(struct usb_xfer *xfer, usb_error_t error) default: /* Error */ /* - * Print error message and clear stall + * Print error message and clear stall * for example. */ break; } - /* - * Here it is safe to do something without the private + /* + * Here it is safe to do something without the private * USB mutex locked. */ return; @@ -320,7 +320,7 @@ First the SETUP packet, then DATA packet(s) and then a STATUS packet. . The SETUP packet is always pointed to by frame 0 and the -length is set by +length is set by .Fn usbd_xfer_frame_len also if there should not be sent any SETUP packet! If an USB control transfer has no DATA stage, @@ -375,7 +375,7 @@ module defines a USB config structure where it is possible to specify the characteristics of the wanted endpoint. .Bd -literal -offset indent -struct usb_config { +struct usb_config { bufsize, callback direction, diff --git a/share/man/man9/vm_map_find.9 b/share/man/man9/vm_map_find.9 index 4aa5fb821..1d21baee1 100644 --- a/share/man/man9/vm_map_find.9 +++ b/share/man/man9/vm_map_find.9 @@ -71,7 +71,7 @@ by the caller before calling this function to account for the new entry. If .Fa find_space is either -.Dv VMFS_ALIGNED_SPACE +.Dv VMFS_ALIGNED_SPACE or .Dv VMFS_ANY_SPACE , the function will call diff --git a/share/man/man9/watchdog.9 b/share/man/man9/watchdog.9 index 170812bb3..2df9fd6e4 100644 --- a/share/man/man9/watchdog.9 +++ b/share/man/man9/watchdog.9 @@ -53,7 +53,7 @@ is zero, the watchdog must be disabled and the argument left untouched. If the watchdog cannot be disabled, the .Fa error -argument must be set to +argument must be set to .Dv EOPNOTSUPP . .Pp Else the watchdog should be reset and configured to a timeout of diff --git a/sys/boot/common/loader.8 b/sys/boot/common/loader.8 index 6472402c3..7ed707554 100644 --- a/sys/boot/common/loader.8 +++ b/sys/boot/common/loader.8 @@ -223,7 +223,7 @@ Loads a .Xr geli 8 encryption keyfile for the given provider name. The key index can be specified via -.Ar keyno +.Ar keyno or will default to zero. .Pp .It Ic ls Xo diff --git a/sys/boot/forth/loader.conf.5 b/sys/boot/forth/loader.conf.5 index fa83c8f48..5f7a0d707 100644 --- a/sys/boot/forth/loader.conf.5 +++ b/sys/boot/forth/loader.conf.5 @@ -266,7 +266,7 @@ The stops reading .Nm when it encounters a syntax error, so any options which are vital for -booting a particular system (i.e.\& +booting a particular system (i.e.\& .Dq Va hw.ata.ata_dma Ns "=0" ) should precede any experimental additions to .Nm . diff --git a/tools/tools/ath/athrd/athrd.1 b/tools/tools/ath/athrd/athrd.1 index ef9f00787..59c86f98c 100644 --- a/tools/tools/ath/athrd/athrd.1 +++ b/tools/tools/ath/athrd/athrd.1 @@ -82,10 +82,10 @@ and Mark passive scan channels with lower case letters and active scan channels with upper case letters. .It Fl r -Mark channels that require DFS with a +Mark channels that require DFS with a .Ql * . .It Fl 4 -Mark channels that have a 4ms packet limit with a +Mark channels that have a 4ms packet limit with a .Ql 4 . .It Fl c Display IEEE channel numbers instead of frequencies. @@ -117,10 +117,10 @@ Each frequency has a suffix that is one of: .Ql B , .Ql A , or -.Ql T +.Ql T according to whether the channel is usable with 802.11g, 802.11b, 802.11a, or Atheros Turbo mode. -All channels listed as +All channels listed as .Ql G are also usable in .Ql B . @@ -158,7 +158,7 @@ Lots belong here. use the HAL to calculate the set of channels. The transmit power calculations are done by emulating how the HAL works. -Because +Because .Nm does not read the actual EEPROM contents from a device this emulation may lag diff --git a/tools/tools/ether_reflect/ether_reflect.1 b/tools/tools/ether_reflect/ether_reflect.1 index 139dcc26b..45ee27a85 100644 --- a/tools/tools/ether_reflect/ether_reflect.1 +++ b/tools/tools/ether_reflect/ether_reflect.1 @@ -39,7 +39,7 @@ .Op Fl p .Op Fl d .Sh DESCRIPTION -The +The .Nm command implements a simple ethernet packet reflector using the .Xr PCAP 3 diff --git a/tools/tools/vimage/vimage.8 b/tools/tools/vimage/vimage.8 index d55bcba47..e9a24c411 100644 --- a/tools/tools/vimage/vimage.8 +++ b/tools/tools/vimage/vimage.8 @@ -82,7 +82,7 @@ image. .Ss Invocation If invoked with no modifiers, the .Nm -command spawns a new interactive shell in virtual image +command spawns a new interactive shell in virtual image .Ar vname . If optional additional arguments following .Ar vname @@ -106,7 +106,7 @@ Modify the parameters of a virtual image named .Ar vname , using the same syntax as with the -c form of the command. .It Fl d -Delete the virtual image +Delete the virtual image .Ar vname . No processes and/or sockets should exist in the target virtual image in order for the delete request to succeed. Non-loopback interfaces @@ -142,7 +142,7 @@ unless an optional argument specifying the desired interface name is provided. .El .Sh EXAMPLES -Create a new virtual image named +Create a new virtual image named .So v1 .Sc , which is allowed to create and manage an own subhierarchy of vimages: diff --git a/usr.bin/bsdiff/bsdiff/bsdiff.1 b/usr.bin/bsdiff/bsdiff/bsdiff.1 index 6c598628a..f4998ea2b 100644 --- a/usr.bin/bsdiff/bsdiff/bsdiff.1 +++ b/usr.bin/bsdiff/bsdiff/bsdiff.1 @@ -72,7 +72,7 @@ The .Nm utility does not store the hashes of .Ar oldfile -or +or .Ar newfile in .Ar patchfile . diff --git a/usr.bin/calendar/calendar.1 b/usr.bin/calendar/calendar.1 index 0b1208c6b..423fca341 100644 --- a/usr.bin/calendar/calendar.1 +++ b/usr.bin/calendar/calendar.1 @@ -36,11 +36,14 @@ .Nd reminder service .Sh SYNOPSIS .Nm -.Op Fl a .Op Fl A Ar num +.Op Fl a .Op Fl B Ar num +.Op Fl D Ar moon|sun +.Op Fl d .Op Fl F Ar friday .Op Fl f Ar calendarfile +.Op Fl l Ar longitude .Oo .Bk -words .Fl t Ar dd Ns @@ -49,16 +52,14 @@ .Sm on .Ek .Oc -.Op Fl W Ar num .Op Fl U Ar UTC-offset -.Op Fl l Ar longitude +.Op Fl W Ar num .Sh DESCRIPTION The .Nm utility checks the current directory for a file named .Pa calendar -and displays lines that begin with either today's date -or tomorrow's. +and displays lines that fall into the specified date range. On the day before a weekend (normally Friday), events for the next three days are displayed. .Pp @@ -76,6 +77,10 @@ This requires super-user privileges. Print lines from today and the previous .Ar num days (backward, past). +.It Fl D Ar moon|sun +Print UTC offset, longitude and moon or sun information. +.It Fl d +Debug option: print current date information. .It Fl F Ar friday Specify which day of the week is ``Friday'' (the day before the weekend begins). @@ -84,6 +89,11 @@ Default is 5. Use .Pa calendarfile as the default calendar file. +.It Fl l Ar longitude +Perform lunar and solar calculations from this longitude. +If neither longitude nor UTC offset is specified, the calculations will +be based on the difference between UTC time and localtime. +If both are specified, UTC offset overrides longitude. .It Xo Fl t .Sm off .Ar dd @@ -91,12 +101,11 @@ as the default calendar file. .Sm on .Xc For test purposes only: set date directly to argument values. -.It Fl l Ar longitude , Fl U Ar UTC-offset -Only one is needed: -Perform lunar and solar calculations from this longitude or from -this UTC offset. -If neither is specified, the calculations will be based on the -difference between UTC time and localtime. +.It Fl U Ar UTC-offset +Perform lunar and solar calculations from this UTC offset. +If neither UTC offset nor longitude is specified, the calculations +will be based on the difference between UTC time and localtime. +If both are specified, UTC offset overrides longitude. .It Fl W Ar num Print lines from today and the next .Ar num @@ -104,7 +113,6 @@ days (forward, future). Ignore weekends when calculating the number of days. .El .Sh FILE FORMAT -.Pp To handle calendars in your national code table you can specify .Dq LANG= in the calendar file as early as possible. @@ -210,7 +218,7 @@ Paskha\fB\et\fROrthodox Easter .Sh FILES .Bl -tag -width calendar.christian -compact .It Pa calendar -file in current directory. +file in current directory .It Pa ~/.calendar .Pa calendar HOME directory. diff --git a/usr.bin/comm/comm.1 b/usr.bin/comm/comm.1 index 0a34160c0..e5fc940b5 100644 --- a/usr.bin/comm/comm.1 +++ b/usr.bin/comm/comm.1 @@ -61,11 +61,13 @@ The filename ``-'' means the standard input. The following options are available: .Bl -tag -width indent .It Fl 1 -Suppress printing of column 1. +Suppress printing of column 1, lines only in +.Ar file1 . .It Fl 2 -Suppress printing of column 2. +Suppress printing of column 2, lines only in +.Ar file2 . .It Fl 3 -Suppress printing of column 3. +Suppress printing of column 3, lines common to both. .It Fl i Case insensitive comparison of lines. .El diff --git a/usr.bin/csup/cpasswd.1 b/usr.bin/csup/cpasswd.1 index 2563251a0..1e5a5c32d 100644 --- a/usr.bin/csup/cpasswd.1 +++ b/usr.bin/csup/cpasswd.1 @@ -52,7 +52,7 @@ server. By convention, e-mail addresses are used for all client names, e.g., .Ql BillyJoe@FreeBSD.org . Client names are case-insensitive. -.Pp +.Pp .Ar ServerName is the name of the .Nm CVSup diff --git a/usr.bin/csup/csup.1 b/usr.bin/csup/csup.1 index 446435661..5e5d5dd12 100644 --- a/usr.bin/csup/csup.1 +++ b/usr.bin/csup/csup.1 @@ -649,9 +649,9 @@ called If .Ql Makefile from that directory is not required then the line -.Pp +.Pp .Bl -item -compact -offset indent -.It +.It .Pa doc/Makefile .El .Pp @@ -662,8 +662,8 @@ A better solution would be .Bl -item -compact -offset indent .It .Pa doc/Makefile* -.El -.Pp +.El +.Pp which will match whether .Ql Makefile is an RCS file or not. @@ -679,7 +679,7 @@ containing the following lines: .Pa doc/ru* .It .Pa doc/zh* -.El +.El .Pp As many as three refuse files are examined for each .Ar supfile @@ -710,7 +710,7 @@ for .Ar base and .Ar sup -for +for .Ar collDir but it is possible to override both of these. The value of .Ar base @@ -720,11 +720,11 @@ option or a .Ar base=pathname entry in the .Ar supfile . -(If both are used the +(If both are used the .Fl b option will override the .Ar supfile -entry.) The value of +entry.) The value of .Ar collDir can only be changed with the .Fl c @@ -779,11 +779,11 @@ in the .Pp .Bl -item -compact -offset indent .It -.Pa /bar/sup/refuse +.Pa /bar/sup/refuse .It -.Pa /bar/sup/src-all/refuse +.Pa /bar/sup/src-all/refuse .It -.Pa /bar/sup/src-all/refuse.cvs:RELENG_3 +.Pa /bar/sup/src-all/refuse.cvs:RELENG_3 .El .Pp and with @@ -794,7 +794,7 @@ as well: .Bl -item -compact -offset indent .It .Pa /bar/stool/refuse -.It +.It .Pa /bar/stool/src-all/refuse .It .Pa /bar/stool/src-all/refuse.cvs:RELENG_3 diff --git a/usr.bin/find/find.1 b/usr.bin/find/find.1 index 04fe50ccc..354c5c92e 100644 --- a/usr.bin/find/find.1 +++ b/usr.bin/find/find.1 @@ -302,7 +302,7 @@ Please refer to the .Ic -atime primary description for information on supported time units. .It Ic -d -Same as +Same as .Ic depth . GNU find implements this as a primary in mistaken emulation of .Fx @@ -451,12 +451,12 @@ is being executed and the latter matches any file system which is mounted read-only. .It Ic -gid Ar gname The same thing as -.Ar -group Ar gname +.Ar -group Ar gname for compatibility with GNU find. GNU find imposes a restriction that -.Ar gname +.Ar gname is numeric, while -.Xr find 1 +.Xr find 1 does not. .It Ic -group Ar gname True if the file belongs to the group @@ -489,7 +489,7 @@ Like .Ic -regex , but the match is case insensitive. .It Ic -iwholename Ar pattern -The same thing as +The same thing as .Ic -ipath , for GNU find compatibility. .It Ic -links Ar n @@ -545,7 +545,7 @@ minutes. Same as .Ic -newer . .It Ic -mount -The same thing as +The same thing as .Ic -xdev , for GNU find compatibility. .It Ic -mtime Ar n Ns Op Cm smhdw @@ -618,7 +618,7 @@ True if the file belongs to an unknown group. This option is for GNU find compatibility and is ignored. .It Ic -noleaf This option is for GNU find compatibility. -In GNU find it disables an optimization not relevant to +In GNU find it disables an optimization not relevant to .Xr find 1 , so it is ignored. .It Ic -nouser @@ -754,7 +754,7 @@ True if the file is a hard link to If the command option .Ic -L is specified, it is also true if the file is a symbolic link and -points to +points to .Ar name . .It Ic -size Ar n Ns Op Cm ckMGTP True if the file's size, rounded up, in 512-byte blocks is @@ -807,12 +807,12 @@ socket .El .It Ic -uid Ar uname The same thing as -.Ar -user Ar uname +.Ar -user Ar uname for compatibility with GNU find. GNU find imposes a restriction that -.Ar uname +.Ar uname is numeric, while -.Xr find 1 +.Xr find 1 does not. .It Ic -user Ar uname True if the file belongs to the user @@ -823,7 +823,7 @@ is numeric and there is no such user name, then .Ar uname is treated as a user ID. .It Ic -wholename Ar pattern -The same thing as +The same thing as .Ic -path , for GNU find compatibility. .El diff --git a/usr.bin/fstat/fuser.1 b/usr.bin/fstat/fuser.1 index 90252f618..9414e51c1 100644 --- a/usr.bin/fstat/fuser.1 +++ b/usr.bin/fstat/fuser.1 @@ -29,7 +29,7 @@ .Os .Sh NAME .Nm fuser -.Nd list IDs of all processes that have one or more files open +.Nd list IDs of all processes that have one or more files open .Sh SYNOPSIS .Nm .Op Fl cfkmu diff --git a/usr.bin/ipcrm/ipcrm.1 b/usr.bin/ipcrm/ipcrm.1 index 5d01bfe81..f70eab684 100644 --- a/usr.bin/ipcrm/ipcrm.1 +++ b/usr.bin/ipcrm/ipcrm.1 @@ -114,6 +114,6 @@ If the identifier or the key is -1, it will remove all these objects. The wiping of all System V IPC objects was first implemented in .Fx 6.4 No and 7.1. .Sh AUTHORS -The original author was Adam Glass. +The original author was Adam Glass. The wiping of all System V IPC objects was thought up by Callum Gibson and extended and implemented by Edwin Groothuis. diff --git a/usr.bin/locale/locale.1 b/usr.bin/locale/locale.1 index b2aba5def..144f2802e 100644 --- a/usr.bin/locale/locale.1 +++ b/usr.bin/locale/locale.1 @@ -35,11 +35,11 @@ .Nm .Op Fl a | m .Nm -.Fl k +.Fl k .Ic list .Op Ar prefix .Nm -.Op Fl ck +.Op Fl ck .Ar keyword ... .Sh DESCRIPTION The diff --git a/usr.bin/lockf/lockf.1 b/usr.bin/lockf/lockf.1 index 255a8283a..f3ad6dfed 100644 --- a/usr.bin/lockf/lockf.1 +++ b/usr.bin/lockf/lockf.1 @@ -139,7 +139,7 @@ A system call (e.g., .Xr fork 2 ) failed unexpectedly. .It Dv EX_SOFTWARE -The +The .Ar command did not exit normally, but may have been signaled or stopped. diff --git a/usr.bin/ministat/ministat.1 b/usr.bin/ministat/ministat.1 index 1e199a19f..88d5324a0 100644 --- a/usr.bin/ministat/ministat.1 +++ b/usr.bin/ministat/ministat.1 @@ -119,12 +119,12 @@ excellent "Cartoon Guide to Statistics" which supplied the above example. .Sh HISTORY The .Nm -command was written by Poul-Henning Kamp out of frustration +command was written by Poul-Henning Kamp out of frustration over all the bogus benchmark claims made by people with no understanding of the importance of uncertainty and statistics. .Pp From -.Fx 5.2 +.Fx 5.2 it has lived in the source tree as a developer tool, graduating to the installed system from .Fx 8.0 . diff --git a/usr.bin/printf/printf.1 b/usr.bin/printf/printf.1 index 792529ae6..c5bba974a 100644 --- a/usr.bin/printf/printf.1 +++ b/usr.bin/printf/printf.1 @@ -344,7 +344,7 @@ Trying to print a dash ("-") as the first character causes .Nm to interpret the dash as a program argument. .Nm -- -must be used before +must be used before .Ar format . .Pp If the locale contains multibyte characters diff --git a/usr.bin/procstat/procstat.1 b/usr.bin/procstat/procstat.1 index 7cf562a7d..6587bd398 100644 --- a/usr.bin/procstat/procstat.1 +++ b/usr.bin/procstat/procstat.1 @@ -54,7 +54,7 @@ for printing: .Bl -tag -width indent .It Fl b Display binary information for the process. -.It Fl c +.It Fl c Display command line arguments for the process. .It Fl e Display environment variables for the process. diff --git a/usr.bin/sed/sed.1 b/usr.bin/sed/sed.1 index a6b9ea261..075988997 100644 --- a/usr.bin/sed/sed.1 +++ b/usr.bin/sed/sed.1 @@ -146,7 +146,7 @@ The option suppresses this behavior. .It Fl r Same as -.Fl E +.Fl E for compatibility with GNU sed. .El .Pp @@ -195,7 +195,7 @@ option was specified); .It a context address that consists of a regular expression preceded and followed by a -delimiter. The closing delimiter can also optionally be followed by the +delimiter. The closing delimiter can also optionally be followed by the .Dq I character, to indicate that the regular expression is to be matched in a case-insensitive way. diff --git a/usr.bin/tftp/tftp.1 b/usr.bin/tftp/tftp.1 index 720fd84d8..0107878c4 100644 --- a/usr.bin/tftp/tftp.1 +++ b/usr.bin/tftp/tftp.1 @@ -83,7 +83,7 @@ Sets the TFTP blksize2 option in TFTP Read Request or Write Request packets to .Ar [size] . Values are restricted to powers of 2 between 8 and 32768. This is a -non-standard TFTP option. +non-standard TFTP option. .Pp .It Cm connect Ar host Op Ar port Set the @@ -109,12 +109,12 @@ or commands. .Pp .It Cm debug Ar level -Enable or disable debugging levels during verbose output. The value of +Enable or disable debugging levels during verbose output. The value of .Ar level can be one of -.Cm packet , simple , options , +.Cm packet, simple, options, or -.Cm access . +.Cm access. .Pp .It Cm get Oo Ar host : Oc Ns Ar file Op Ar localname .It Cm get Xo @@ -186,7 +186,7 @@ are .Cm off (disable RFC 2347 options), and .Cm extra -(toggle support for non-RFC defined options). +(toggle support for non-RFC defined options). .Pp .It Cm quit Exit @@ -222,24 +222,19 @@ Toggle verbose mode. .Pp The following RFC's are supported: .Rs -RFC 1350 -.%T The TFTP Protocol (Revision 2) +.%T RFC 1350: The TFTP Protocol (Revision 2) .Re .Rs -RFC 2347 -.%T TFTP Option Extension +.%T RFC 2347: TFTP Option Extension .Re .Rs -RFC 2348 -.%T TFTP Blocksize Option +.%T RFC 2348: TFTP Blocksize Option .Re .Rs -RFC 2349 -.%T TFTP Timeout Interval and Transfer Size Options +.%T RFC 2349: TFTP Timeout Interval and Transfer Size Options .Re .Rs -RFC 3617 -.%T Uniform Resource Identifier (URI) Scheme and Applicability Statement for the Trivial File Transfer Protocol (TFTP) +.%T RFC 3617: Uniform Resource Identifier (URI) Scheme and Applicability Statement for the Trivial File Transfer Protocol (TFTP) .Re .Pp The non-standard diff --git a/usr.bin/top/top.local.1 b/usr.bin/top/top.local.1 index 015b969b7..f3b01460b 100644 --- a/usr.bin/top/top.local.1 +++ b/usr.bin/top/top.local.1 @@ -1,4 +1,4 @@ -.\" $FreeBSD$ +.\" $FreeBSD$ .SH "FreeBSD NOTES" .SH DESCRIPTION OF MEMORY @@ -33,20 +33,20 @@ immediate reallocation .B Buf: number of bytes used for BIO-level disk caching .TP -.B Free: +.B Free: number of bytes free .TP -.B Total: +.B Total: total available swap usage -.TP -.B Free: +.TP +.B Free: total free swap usage -.TP -.B Inuse: +.TP +.B Inuse: swap usage -.TP -.B In: +.TP +.B In: bytes paged in from swap devices (last interval) .TP -.B Out: +.B Out: bytes paged out to swap devices (last interval) diff --git a/usr.bin/touch/touch.1 b/usr.bin/touch/touch.1 index 1f3b8c20b..c1c99fa04 100644 --- a/usr.bin/touch/touch.1 +++ b/usr.bin/touch/touch.1 @@ -51,27 +51,27 @@ utility sets the modification and access times of files. If any file does not exist, it is created with default permissions. .Pp By default, -.Nm +.Nm changes both modification and access times. The .Fl a -and +and .Fl m flags may be used to select the access time or the modification time individually. Selecting both is equivalent to the default. By default, the timestamps are set to the current time. -The +The .Fl t flag explicitly specifies a different time, and the .Fl r flag specifies to set the times those of the specified file. -The +The .Fl A flag adjusts the values by a specified amount. .Pp The following options are available: .Bl -tag -width Ds -.It Fl A +.It Fl A Adjust the access and modification time stamps for the file by the specified value. This flag is intended for use in modifying files with incorrectly set @@ -95,7 +95,7 @@ The number of seconds, from 00 to 59. .Pp The .Fl A -flag implies the +flag implies the .Fl c flag: if any file specified does not exist, it will be silently ignored. .It Fl a diff --git a/usr.sbin/adduser/adduser.conf.5 b/usr.sbin/adduser/adduser.conf.5 index d5fcf772f..c7c4f5d06 100644 --- a/usr.sbin/adduser/adduser.conf.5 +++ b/usr.sbin/adduser/adduser.conf.5 @@ -34,7 +34,7 @@ .Xr adduser 8 configuration file .Sh DESCRIPTION -The +The .Pa /etc/adduser.conf file is automatically generated by the .Xr adduser 8 diff --git a/usr.sbin/bluetooth/ath3kfw/ath3kfw.8 b/usr.sbin/bluetooth/ath3kfw/ath3kfw.8 index be10b472e..e2454dc85 100644 --- a/usr.sbin/bluetooth/ath3kfw/ath3kfw.8 +++ b/usr.sbin/bluetooth/ath3kfw/ath3kfw.8 @@ -58,7 +58,7 @@ The options are as follows: .Bl -tag -width indent .It Fl d Ar device_name Specify -.Xr ugen 4 +.Xr ugen 4 device name. .It Fl f Ar firmware_file_name Specify firmware file name for download. diff --git a/usr.sbin/bsdinstall/bsdinstall.8 b/usr.sbin/bsdinstall/bsdinstall.8 index 4b8b51eeb..27ececb22 100644 --- a/usr.sbin/bsdinstall/bsdinstall.8 +++ b/usr.sbin/bsdinstall/bsdinstall.8 @@ -85,7 +85,7 @@ is set, also sets the host name of the current system. Interactively configures network interfaces (first invoking .Cm wlanconfig on wireless interfaces), saving the result to the new system's -.Pa rc.conf +.Pa rc.conf and .Pa resolv.conf . If diff --git a/usr.sbin/bsnmpd/modules/snmp_wlan/snmp_wlan.3 b/usr.sbin/bsnmpd/modules/snmp_wlan/snmp_wlan.3 index 12398a951..8282fb8eb 100644 --- a/usr.sbin/bsnmpd/modules/snmp_wlan/snmp_wlan.3 +++ b/usr.sbin/bsnmpd/modules/snmp_wlan/snmp_wlan.3 @@ -1,7 +1,7 @@ .\"- .\" Copyright (C) 2010 The FreeBSD Foundation .\" All rights reserved. -.\" +.\" .\" This documentation was written by Shteryana Sotirova Shopova under .\" sponsorship from the FreeBSD Foundation. .\" @@ -13,7 +13,7 @@ .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. -.\" +.\" .\" THIS SOFTWARE IS PROVIDED BY AUTHOR AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE @@ -33,7 +33,7 @@ .Os .Sh NAME .Nm snmp_wlan -.Nd "wireless networking module for +.Nd "wireless networking module for" .Xr bsnmpd 1 .Sh LIBRARY .Pq begemotSnmpdModulePath."wlan" = "/usr/lib/snmp_wlan.so" @@ -61,10 +61,10 @@ via .Va wlanParentIfName column. Any optional parameters may be set via the -.Va wlanIfaceOperatingMode , -.Va wlanIfaceFlags , +.Va wlanIfaceOperatingMode, +.Va wlanIfaceFlags, .Va wlanIfaceBssid -and +and .Va wlanIfaceLocalAddress columns. To finally create the interface in the system, a SET with value of active(1) to diff --git a/usr.sbin/bsnmpd/tools/bsnmptools/bsnmpget.1 b/usr.sbin/bsnmpd/tools/bsnmptools/bsnmpget.1 index 97ef694ba..57a85d60a 100644 --- a/usr.sbin/bsnmpd/tools/bsnmptools/bsnmpget.1 +++ b/usr.sbin/bsnmpd/tools/bsnmptools/bsnmpget.1 @@ -33,7 +33,7 @@ .\" .\" $FreeBSD$ .\" -.Dd September 17, 2007 +.Dd January 10, 2012 .Dt BSNMPGET 1 .Os .Sh NAME @@ -102,7 +102,7 @@ and .Nm bsnmpset are simple tools for retrieving management information from and setting -management information to a Simple Network Managment Protocol (SNMP) agent. +management information to a Simple Network Management Protocol (SNMP) agent. .Pp Depending on the options .Nm bsnmpget @@ -112,16 +112,15 @@ objects whose values will be retrived, waits for a response and prints it if received successfully. .Pp .Nm Bsnmpwalk -queries an agent with SMNP GetNextRequest packets, +queries an agent with ether SMNP GetNextRequest or GetBulkRequest packets, asking for values of OID instances that are a part of the object subtree rooted at the provided OIDs. .Pp .Nm Bsnmpset constructs a SMNP SetRequest packet, fills in the OIDs (object identifiers), syntaxes and values of the objects whose values are to be set and waits for a -responce from server. +response from server. .Sh OPTIONS -.Pp The options are as follows (not all apply to all three programs): .Bl -tag -width ".It Fl D Ar options" .It Fl A Ar options @@ -165,7 +164,7 @@ terminal. Retry on error. If an error is returned in the response PDU, resend the request removing the variable that caused the error until a valid response is received. -This is only usefull for a GetRequest- and a GetNextRequest-PDU. +This is only useful for a GetRequest- and a GetNextRequest-PDU. .It Fl h Print a short help text with default values for various options. .It Fl I Ar options @@ -220,7 +219,7 @@ The path of the posix local (unix domain) socket if local transport is used. .It Fl M Ar max-repetitions The value for the max-repetitions field in a GetBulk PDU. -Default is 1. +Default is 10. .It Fl N Ar non-repeaters The value for the non-repeaters field in a GetBulk PDU. Default is 0. @@ -251,8 +250,17 @@ A binary localized privacy key to use when encypting/decrypting SNMPv3 PDU data. By default plain text SNMPv3 PDUs are sent. .It Fl p Ar [get|getnext|getbulk] The PDU type to send by -.Nm bsmpget . -Default is get. +.Nm bsmpget +and +.Nm bsnmpwalk . +Default is get +for +.Nm bsmpget +and getnext for +.Nm bsnmpwalk . +Getbulk allows executing the so called SNMP "bulkwalks" allowing the values of +multiple columns to be retrived in a single PDU by +.Nm bsnmpwalk . .It Fl r Ar retries Number of resends of request packets before giving up if the agent does not respond after the first try. diff --git a/usr.sbin/cdcontrol/cdcontrol.1 b/usr.sbin/cdcontrol/cdcontrol.1 index b8cf92ddf..f1e969d1b 100644 --- a/usr.sbin/cdcontrol/cdcontrol.1 +++ b/usr.sbin/cdcontrol/cdcontrol.1 @@ -131,7 +131,7 @@ Eject the disc. .It Ic close Inject the disc. .It Ic volume -Same as +Same as .Em status volume command. .It Ic volume Ar level diff --git a/usr.sbin/config/config.8 b/usr.sbin/config/config.8 index 03cffb4a0..784b06b1c 100644 --- a/usr.sbin/config/config.8 +++ b/usr.sbin/config/config.8 @@ -86,7 +86,7 @@ Configure a system for debugging. .It Fl x Ar kernel Print kernel configuration file embedded into a kernel file. -This option makes sense only if +This option makes sense only if .Cd "options INCLUDE_CONFIG_FILE" entry was present in your configuration file. .It Fl p @@ -246,7 +246,7 @@ The utility appeared in .Bx 4.1 . .Pp -Before support for +Before support for .Fl x was introduced, .Cd "options INCLUDE_CONFIG_FILE" @@ -255,7 +255,7 @@ the new kernel. This meant that .Xr strings 1 could be used to extract it from a kernel: -to extract the configuration information, you had to use +to extract the configuration information, you had to use the command: .Pp .Dl "strings -n 3 kernel | sed -n 's/^___//p'" diff --git a/usr.sbin/ctladm/ctladm.8 b/usr.sbin/ctladm/ctladm.8 index 027d89ec3..cb87fdba3 100644 --- a/usr.sbin/ctladm/ctladm.8 +++ b/usr.sbin/ctladm/ctladm.8 @@ -1,7 +1,7 @@ -.\" +.\" .\" Copyright (c) 2003 Silicon Graphics International Corp. .\" All rights reserved. -.\" +.\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: @@ -13,7 +13,7 @@ .\" ("Disclaimer") and any redistribution must be conditioned upon .\" including a substantially similar Disclaimer requirement for further .\" binary redistribution. -.\" +.\" .\" NO WARRANTY .\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS .\" "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT @@ -26,7 +26,7 @@ .\" STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING .\" IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE .\" POSSIBILITY OF SUCH DAMAGES. -.\" +.\" .\" ctladm utility man page. .\" .\" Author: Ken Merry @@ -291,7 +291,7 @@ device, so the transfer length can be calculated accurately. The blocksize can be obtained via the .Tn SCSI READ CAPACITY command. -.It Fl N +.It Fl N Do not copy data to .Nm from the kernel when doing a read, just execute the command without copying @@ -455,7 +455,7 @@ the proper error. .It Fl o Set the Copan proprietary on/offline bit in the CDB. When this flag is used, the LUN will be spun down and taken offline ("Logical unit not ready, -manual intervention required"). See the description of the +manual intervention required"). See the description of the .Ic shutdown and .Ic startup @@ -463,7 +463,7 @@ options. .El .It Ic synccache Send the -.Tn SCSI +.Tn SCSI SYNCHRONIZE CACHE command to the device. By default, SYNCHRONIZE CACHE(10) is used. If the specified starting LBA is greater than 0xffffffff or the length is greater than 0xffff, though, @@ -546,7 +546,7 @@ may be delayed currently: before data is transferred and just prior to sending status to the host .Pq Dq done . One of the two must be supplied as an argument to the -.Fl l +.Fl l option. The .Fl t option must also be specified. @@ -580,7 +580,7 @@ argument will show whether SYNCHRONIZE CACHE commands are being sent to the backend or not. The default is to send SYNCHRONIZE CACHE commands to the backend. -The +The .Sq on argument will cause all SYNCHRONIZE CACHE commands sent to all LUNs to be sent to the backend. @@ -622,7 +622,7 @@ If the .Fl c flag is specified, all commands matching the pattern will be returned with the specified error until the error injection command is deleted with -.Fl d +.Fl d flag. .Bl -tag -width 17n .It Fl i Ar action @@ -705,7 +705,7 @@ for a given port. One of .Fl l , .Fl o , -or +or .Fl w or .Fl W @@ -719,7 +719,7 @@ List all CTL frontend ports or a specific port type or number. Turn the specified CTL frontend ports off or on. If no port number or port type is specified, all ports are turned on or off. -.It Fl p Ar targ_port +.It Fl p Ar targ_port Specify the frontend port number. The port numbers can be found in the frontend port list. .It Fl q @@ -739,7 +739,7 @@ and .It Fl w Ar wwnn Set the World Wide Node Name for the given port. The -.Fl n +.Fl n argument must be specified, since this is only possible to implement on a single port. As a general rule, the WWNN should be the same across all ports on the @@ -933,7 +933,7 @@ This works when the Front End Target Drivers are enabled or disabled. .Dl ctladm lunlist .Pp List all LUNs in the system, along with their inquiry data and device type. -This only works when the FETDs are enabled, since the commands go through the +This only works when the FETDs are enabled, since the commands go through the ioctl port. .Pp .Dl ctladm inject 0:6 -i mediumerr -p read -r 0,512 -c diff --git a/usr.sbin/edquota/edquota.8 b/usr.sbin/edquota/edquota.8 index 326c8373c..f616fa084 100644 --- a/usr.sbin/edquota/edquota.8 +++ b/usr.sbin/edquota/edquota.8 @@ -106,7 +106,7 @@ megainodes (M), terainodes (T), petainodes (P), or exainodes (E). If no units are specified, the number of inodes specified are used. If the .Fl h -flag is specified, the editor will always display the +flag is specified, the editor will always display the block usage and limits in a more human readable format rather than displaying them in the historic kilobyte format. Setting a quota to zero indicates that no quota should be imposed. diff --git a/usr.sbin/freebsd-update/freebsd-update.8 b/usr.sbin/freebsd-update/freebsd-update.8 index 1943a5382..2d9a4473e 100644 --- a/usr.sbin/freebsd-update/freebsd-update.8 +++ b/usr.sbin/freebsd-update/freebsd-update.8 @@ -49,7 +49,7 @@ updates to the FreeBSD base system. Note that updates are only available if they are being built for the FreeBSD release and architecture being used; in particular, the .Fx -Security Team only builds updates for releases shipped in binary form +Security Team only builds updates for releases shipped in binary form by the .Fx Release Engineering Team, e.g., diff --git a/usr.sbin/gpioctl/gpioctl.8 b/usr.sbin/gpioctl/gpioctl.8 index 4ceecf6f4..32ae40983 100644 --- a/usr.sbin/gpioctl/gpioctl.8 +++ b/usr.sbin/gpioctl/gpioctl.8 @@ -35,21 +35,21 @@ .Nd GPIO control utility .Sh SYNOPSIS .Nm -.Cm -l +.Cm -l .Fl f Ar ctldev .Op Fl v .Nm -.Cm -t +.Cm -t .Fl f Ar ctldev .Ar pin .Nm -.Cm -c +.Cm -c .Fl f Ar ctldev .Ar pin -.Ar flag +.Ar flag .Op flag ... .Nm -.Cm -f Ar ctldev +.Cm -f Ar ctldev .Ar pin .Ar [0|1] .Sh DESCRIPTION diff --git a/usr.sbin/i2c/i2c.8 b/usr.sbin/i2c/i2c.8 index dab26ea3b..ac71af3de 100644 --- a/usr.sbin/i2c/i2c.8 +++ b/usr.sbin/i2c/i2c.8 @@ -23,14 +23,14 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" $FreeBSD$ +.\" $FreeBSD$ .\" .Dd January 23, 2009 .Dt I2C 8 .Os .Sh NAME .Nm i2c -.Nd test I2C bus and slave devices +.Nd test I2C bus and slave devices .Sh SYNOPSIS .Nm .Cm -a Ar address @@ -120,12 +120,12 @@ Scan the default bus (/dev/iic0) for devices: .Pp i2c -s .It -Scan the default bus (/dev/iic0) for devices and skip addresses 0x56 and +Scan the default bus (/dev/iic0) for devices and skip addresses 0x56 and 0x45. .Pp i2c -s -n 0x56:0x45 .It -Scan the default bus (/dev/iic0) for devices and skip address range +Scan the default bus (/dev/iic0) for devices and skip address range 0x34 to 0x56. .Pp i2c -s -n 0x34..0x56 @@ -161,6 +161,6 @@ The utility and this manual page were written by .An Bartlomiej Sieka .Aq tur@semihalf.com -and +and .An Michal Hajduk .Aq mih@semihalf.com . diff --git a/usr.sbin/mountd/exports.5 b/usr.sbin/mountd/exports.5 index f2a1474e1..3a8950fd0 100644 --- a/usr.sbin/mountd/exports.5 +++ b/usr.sbin/mountd/exports.5 @@ -73,7 +73,7 @@ There are three forms of this specification. The first is to list all mount points as absolute directory paths separated by whitespace. This list of directory paths should be considered an -.Dq administrative control , +.Dq administrative control , since it is only enforced by the .Xr mountd 8 daemon and not the kernel. @@ -90,7 +90,7 @@ option is used on .Xr mountd 8 . Because NFSv4 does not use the mount protocol, the -.Dq administrative controls +.Dq administrative controls are not applied. Thus, all the above export line(s) should be considered to have the .Fl alldirs diff --git a/usr.sbin/mptutil/mptutil.8 b/usr.sbin/mptutil/mptutil.8 index a5b3593f8..3fc57cebb 100644 --- a/usr.sbin/mptutil/mptutil.8 +++ b/usr.sbin/mptutil/mptutil.8 @@ -70,7 +70,7 @@ .Cm volume status Ar volume .Nm .Op Fl u Ar unit -.Cm volume cache Ar volume +.Cm volume cache Ar volume .Ar enable|disable .Nm .Op Fl u Ar unit @@ -387,7 +387,7 @@ console. .Pp The mpt version 1 API that is used by .Nm -and +and .Xr mpt 4 doesn't support volumes above two terabytes. This is a limitation of the API. diff --git a/usr.sbin/newsyslog/newsyslog.conf.5 b/usr.sbin/newsyslog/newsyslog.conf.5 index 6a12caddd..589d98f0a 100644 --- a/usr.sbin/newsyslog/newsyslog.conf.5 +++ b/usr.sbin/newsyslog/newsyslog.conf.5 @@ -304,7 +304,7 @@ when this log file is rotated. .It Cm R if this flag is set the .Xr newsyslog 8 -will run shell command defined in +will run shell command defined in .Ar path_to_pid_cmd_file after rotation instead of trying to send signal to a process id stored in the file. diff --git a/usr.sbin/pciconf/pciconf.8 b/usr.sbin/pciconf/pciconf.8 index 72586dd8b..6b7729144 100644 --- a/usr.sbin/pciconf/pciconf.8 +++ b/usr.sbin/pciconf/pciconf.8 @@ -185,7 +185,7 @@ Ns Va function Ns , .Li pci Ns Va bus Ns \&: Ns Va device Ns \&: Ns Va function Ns , or .Li pci Ns Va bus Ns \&: Ns Va device Ns . In case of an abridged form, omitted selector components are assumed to be 0. -An optional leading device name followed by @ and an optional final colon +An optional leading device name followed by @ and an optional final colon will be ignored; this is so that the first column in the output of .Nm .Fl l diff --git a/usr.sbin/pkg_install/updating/pkg_updating.1 b/usr.sbin/pkg_install/updating/pkg_updating.1 index cdb7665f0..86fea89ba 100644 --- a/usr.sbin/pkg_install/updating/pkg_updating.1 +++ b/usr.sbin/pkg_install/updating/pkg_updating.1 @@ -1,6 +1,6 @@ .\" -.\" FreeBSD updating - Scan the installed ports and show all UPDATING entries -.\" that affect one of the installed ports. Alternative a list of portnames +.\" FreeBSD updating - Scan the installed ports and show all UPDATING entries +.\" that affect one of the installed ports. Alternative a list of portnames .\" could be passed to pkg_updating .\" .\" "THE BEER-WARE LICENSE" (Revision 42): @@ -37,7 +37,7 @@ UPDATING entries for the named packages are displayed. Only entries newer than .Ar date are shown. Use a YYYYMMDD date format. -.It Fl f , -file Ar file +.It Fl f , -file Ar file Defines a alternative location of the UPDATING .Ar file . .It Fl h , -help diff --git a/usr.sbin/rtadvd/rtadvd.8 b/usr.sbin/rtadvd/rtadvd.8 index b2e667023..4b74eb4ed 100644 --- a/usr.sbin/rtadvd/rtadvd.8 +++ b/usr.sbin/rtadvd/rtadvd.8 @@ -158,7 +158,7 @@ to reload the configuration file .Pa /etc/rtadvd.conf . If an invalid parameter is found in the configuration file upon the reload, the entry will be ignored and the old configuration will be used. -When parameters in an existing entry are updated, +When parameters in an existing entry are updated, .Nm will send Router Advertisement messages with the old configuration but zero router lifetime to the interface first, and then start to send a new diff --git a/usr.sbin/setfib/setfib.1 b/usr.sbin/setfib/setfib.1 index 37753a078..f36792caa 100644 --- a/usr.sbin/setfib/setfib.1 +++ b/usr.sbin/setfib/setfib.1 @@ -32,7 +32,7 @@ .Nd execute a utility with an altered default network view .Sh SYNOPSIS .Nm -.Op Fl F +.Op Fl F .Ar fib .Ar utility .Op Ar argument ... diff --git a/usr.sbin/timed/timed/timed.8 b/usr.sbin/timed/timed/timed.8 index 119bbc428..8dabd38dd 100644 --- a/usr.sbin/timed/timed/timed.8 +++ b/usr.sbin/timed/timed/timed.8 @@ -86,20 +86,20 @@ If it finds an untrusted host claiming to be master, will suppress incoming messages from that host and call for a new election. .It -Use real host names (resolvable by RDNS) not aliases (eg in +Use real host names (resolvable by RDNS) not aliases (eg in .Xr named 8 parlance: use A names, not C names). .It Use full names eg time1.domain.com not time1. .It .Fl F -automatically includes the functionality of +automatically includes the functionality of .Fl M (so .Fl M does not need to asserted). .It -If +If .Fl F is not specified, all hosts on connected networks are treated as trustworthy. diff --git a/usr.sbin/wlandebug/wlandebug.8 b/usr.sbin/wlandebug/wlandebug.8 index 25fd0af2c..3049000e4 100644 --- a/usr.sbin/wlandebug/wlandebug.8 +++ b/usr.sbin/wlandebug/wlandebug.8 @@ -119,7 +119,7 @@ program. .It Ar mesh trace operation of 802.11s mesh protocol processing. .It Ar wpa -trace operation of the WPA protocol; +trace operation of the WPA protocol; only partly meaningful as WPA protocol support is mostly implemented in user mode by the .Xr hostapd 8 -- 2.45.0