Re: svn commit: r368817 - in head/lib/libc: locale net stdlib sys x86/sys
On Sun, Dec 20, 2020 at 03:19:51AM +0200, Konstantin Belousov wrote: > On Sat, Dec 19, 2020 at 02:54:28PM +0000, Gordon Bergling wrote: > > Modified: head/lib/libc/sys/thr_self.2 > > == > > --- head/lib/libc/sys/thr_self.2Sat Dec 19 13:56:19 2020 > > (r368816) > > +++ head/lib/libc/sys/thr_self.2Sat Dec 19 14:54:28 2020 > > (r368817) > > @@ -71,12 +71,12 @@ The memory pointed to by the > > argument is not valid. > > .El > > .Sh SEE ALSO > > +.Xr _umtx_op 2 , > > .Xr thr_exit 2 , > > .Xr thr_kill 2 , > > .Xr thr_kill2 2 , > > .Xr thr_new 2 , > > .Xr thr_set_name 2 , > > -.Xr _umtx_op 2 , > > .Xr pthread_getthreadid_np 3 , > > .Xr pthread_self 3 > > .Sh STANDARDS > Why this reordering ? The SEE ALSO section should be ordered by section and within the section alphabetically. Therefore _umtx_op must be on top of section two. --Gordon ___ svn-src-all@freebsd.org mailing list https://lists.freebsd.org/mailman/listinfo/svn-src-all To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"
svn commit: r368817 - in head/lib/libc: locale net stdlib sys x86/sys
Author: gbe (doc committer) Date: Sat Dec 19 14:54:28 2020 New Revision: 368817 URL: https://svnweb.freebsd.org/changeset/base/368817 Log: libc: Fix most issues reported by mandoc - varios "new sentence, new line" warnings - varios "sections out of conventional order" warnings - varios "unusual Xr order" warnings - varios "missing section argument" warnings - varios "no blank before trailing delimiter" warnings - varios "normalizing date format" warnings MFC after:1 month Modified: head/lib/libc/locale/setlocale.3 head/lib/libc/net/gethostbyname.3 head/lib/libc/stdlib/system.3 head/lib/libc/sys/_umtx_op.2 head/lib/libc/sys/copy_file_range.2 head/lib/libc/sys/execve.2 head/lib/libc/sys/fhlink.2 head/lib/libc/sys/open.2 head/lib/libc/sys/pdfork.2 head/lib/libc/sys/ptrace.2 head/lib/libc/sys/revoke.2 head/lib/libc/sys/rtprio.2 head/lib/libc/sys/sendfile.2 head/lib/libc/sys/thr_exit.2 head/lib/libc/sys/thr_new.2 head/lib/libc/sys/thr_self.2 head/lib/libc/sys/thr_set_name.2 head/lib/libc/sys/thr_suspend.2 head/lib/libc/sys/thr_wake.2 head/lib/libc/x86/sys/pkru.3 Modified: head/lib/libc/locale/setlocale.3 == --- head/lib/libc/locale/setlocale.3Sat Dec 19 13:56:19 2020 (r368816) +++ head/lib/libc/locale/setlocale.3Sat Dec 19 14:54:28 2020 (r368817) @@ -157,6 +157,15 @@ if the given combination of and .Fa locale makes no sense. +.Sh FILES +.Bl -tag -width /usr/share/locale/locale/category -compact +.It Pa $PATH_LOCALE/ Ns Em locale/category +.It Pa /usr/share/locale/ Ns Em locale/category +locale file for the locale +.Em locale +and the category +.Em category . +.El .Sh EXAMPLES The following code illustrates how a program can initialize the international environment for one language, while selectively @@ -176,15 +185,6 @@ following manner before using any of the locale-specif .Bd -literal setlocale(LC_ALL, ""); .Ed -.Sh FILES -.Bl -tag -width /usr/share/locale/locale/category -compact -.It Pa $PATH_LOCALE/ Ns Em locale/category -.It Pa /usr/share/locale/ Ns Em locale/category -locale file for the locale -.Em locale -and the category -.Em category . -.El .Sh ERRORS No errors are defined. .Sh SEE ALSO Modified: head/lib/libc/net/gethostbyname.3 == --- head/lib/libc/net/gethostbyname.3 Sat Dec 19 13:56:19 2020 (r368816) +++ head/lib/libc/net/gethostbyname.3 Sat Dec 19 14:54:28 2020 (r368817) @@ -303,8 +303,27 @@ for example, a mail-forwarder may be registered for th .Xr hosts 5 , .Xr hostname 7 , .Xr named 8 -.Sh CAVEAT +.Sh HISTORY The +.Fn herror +function appeared in +.Bx 4.3 . +The +.Fn endhostent , +.Fn gethostbyaddr , +.Fn gethostbyname , +.Fn gethostent , +and +.Fn sethostent +functions appeared in +.Bx 4.2 . +The +.Fn gethostbyname2 +function first appeared in +.Tn BIND +version 4.9.4. +.Sh CAVEATS +The .Fn gethostent function is defined, and @@ -343,25 +362,6 @@ The .Fn endhostent function closes the file. -.Sh HISTORY -The -.Fn herror -function appeared in -.Bx 4.3 . -The -.Fn endhostent , -.Fn gethostbyaddr , -.Fn gethostbyname , -.Fn gethostent , -and -.Fn sethostent -functions appeared in -.Bx 4.2 . -The -.Fn gethostbyname2 -function first appeared in -.Tn BIND -version 4.9.4. .Sh BUGS These functions use a thread-specific data storage; if the data is needed for future use, it should be Modified: head/lib/libc/stdlib/system.3 == --- head/lib/libc/stdlib/system.3 Sat Dec 19 13:56:19 2020 (r368816) +++ head/lib/libc/stdlib/system.3 Sat Dec 19 14:54:28 2020 (r368817) @@ -108,4 +108,4 @@ because all meta-characters supported by would be honored. User supplied parameters should always be carefully santized before they appear in -.Fa string. +.Fa string . Modified: head/lib/libc/sys/_umtx_op.2 == --- head/lib/libc/sys/_umtx_op.2Sat Dec 19 13:56:19 2020 (r368816) +++ head/lib/libc/sys/_umtx_op.2Sat Dec 19 14:54:28 2020 (r368817) @@ -1180,7 +1180,7 @@ request: .It Dv UMTX_SHM_CREAT Creates the anonymous shared memory object, which can be looked up with the specified key -.Fa uaddr. +.Fa uaddr . If the object associated with the .Fa uaddr key already exists, it is returned instead of creating a new object. @@ -1198,7 +1198,7 @@ the specified key an error is returned, and no new object is created. .It Dv UMTX_SHM_DESTROY De-associate the shared object with the specified key -.Fa uaddr. +.Fa uaddr . The object is destroyed after the last open file descriptor is closed and the last mapping for it is destroyed. .It Dv UMTX_SHM_ALIVE Modified: head/lib/libc/sys/copy_file_range.2 ===
svn commit: r368816 - head/usr.sbin/trim
Author: gbe (doc committer) Date: Sat Dec 19 13:56:19 2020 New Revision: 368816 URL: https://svnweb.freebsd.org/changeset/base/368816 Log: trim(8): Fix a few issues reported by mandoc - new sentence, new line - unusual Xr order: ioctl(2) after da(4) - unusual Xr order: sysexits(3) after nda(4) MFC after:1 week Modified: head/usr.sbin/trim/trim.8 Modified: head/usr.sbin/trim/trim.8 == --- head/usr.sbin/trim/trim.8 Sat Dec 19 13:51:46 2020(r368815) +++ head/usr.sbin/trim/trim.8 Sat Dec 19 13:56:19 2020(r368816) @@ -60,10 +60,12 @@ The following options are available: Do not actually erase anything but show what it would do (dry run). Implies .Fl v . -This is the default. Overrides +This is the default. +Overrides .Fl f . .It Fl f -Perform the operation. Overrides +Perform the operation. +Overrides .Fl N . .It Fl l Xo .Sm off @@ -150,11 +152,11 @@ is special device file not supporting DIOCGMEDIASIZE (probably not a disk), so its size cannot be examined. .El .Sh SEE ALSO +.Xr ioctl 2 , +.Xr sysexits 3 , .Xr ada 4 , .Xr da 4 , -.Xr ioctl 2 , -.Xr nda 4 , -.Xr sysexits 3 +.Xr nda 4 .Sh HISTORY The .Nm ___ svn-src-all@freebsd.org mailing list https://lists.freebsd.org/mailman/listinfo/svn-src-all To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"
svn commit: r368815 - head/usr.sbin/zonectl
Author: gbe (doc committer) Date: Sat Dec 19 13:51:46 2020 New Revision: 368815 URL: https://svnweb.freebsd.org/changeset/base/368815 Log: zonectl(8): Fix a few issues reported by mandoc - Add missing quotation mark for a comment above the .Dd - inserting missing end of block: Sh breaks Bd - skipping paragraph macro: Pp before Bl - skipping paragraph macro: Pp before Bd - empty block: Bd MFC after:1 week Modified: head/usr.sbin/zonectl/zonectl.8 Modified: head/usr.sbin/zonectl/zonectl.8 == --- head/usr.sbin/zonectl/zonectl.8 Sat Dec 19 13:45:39 2020 (r368814) +++ head/usr.sbin/zonectl/zonectl.8 Sat Dec 19 13:51:46 2020 (r368815) @@ -30,7 +30,7 @@ .\" Authors: Ken Merry (Spectra Logic Corporation) .\" .\" $FreeBSD$ -.\ +.\" .Dd May 18, 2016 .Dt ZONECTL 8 .Os @@ -104,7 +104,6 @@ These zones must be written sequentially. If they are not written sequentially, starting at the write pointer, the command will fail. .El -.Pp .Bl -tag -width 12n .It Fl c Ar cmd Specify the zone subcommand: @@ -208,14 +207,12 @@ zonectl -d /dev/da5 -c params .Ed .Pp Display basic zoning information for disk da5. -.Pp .Bd -literal -offset indent zonectl -d /dev/da5 -c rz .Ed .Pp Issue the Report Zones command to disk da5, and print out all zones on the drive in the default format. -.Pp .Bd -literal -offset indent zonectl -d /dev/da5 -c rz -o reset -P script .Ed @@ -223,14 +220,11 @@ zonectl -d /dev/da5 -c rz -o reset -P script Issue the Report Zones command to disk da5, and print out all of the zones that have the Reset Write Pointer Recommended bit set to true. Print the zones in a script friendly form. -.Pp .Bd -literal -offset indent zonectl -d /dev/da5 -c rwp -l 0x2c8 .Ed .Pp Issue the Reset Write Pointer command to disk da5 for the zone that starts at LBA 0x2c8. -.Pp -.Bd -literal -offset indent .Sh AUTHORS .An Kenneth Merry Aq k...@freebsd.org ___ svn-src-all@freebsd.org mailing list https://lists.freebsd.org/mailman/listinfo/svn-src-all To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"
svn commit: r368814 - head/usr.sbin/nfsd
Author: gbe (doc committer) Date: Sat Dec 19 13:45:39 2020 New Revision: 368814 URL: https://svnweb.freebsd.org/changeset/base/368814 Log: nfsv4(4): Fix a few issues reported by mandoc - new sentence, new line - function name without markup: rtalloc() - function name without markup: VOP_RECLAIM() MFC after:1 week Modified: head/usr.sbin/nfsd/nfsv4.4 Modified: head/usr.sbin/nfsd/nfsv4.4 == --- head/usr.sbin/nfsd/nfsv4.4 Sat Dec 19 13:36:59 2020(r368813) +++ head/usr.sbin/nfsd/nfsv4.4 Sat Dec 19 13:45:39 2020(r368814) @@ -60,8 +60,8 @@ To provide for correct recovery semantics, a small fil is used by the server during the recovery phase. If this file is missing or empty, there is a backup copy maintained by .Xr nfsd 8 -that will be used. If either file is missing, they will be -created by the +that will be used. +If either file is missing, they will be created by the .Xr nfsd 8 . If both the file and the backup copy are empty, it will result in the server starting without providing a grace period @@ -299,7 +299,8 @@ Without a functioning callback path, a server will nev to a client. .sp For NFSv4.0, by default, the callback address will be set to the IP address acquired via -rtalloc() in the kernel and port# 7745. +.Fn rtalloc +in the kernel and port# 7745. To override the default port#, a command line option for .Xr nfscbd 8 can be used. @@ -341,8 +342,9 @@ variables. .Pp NFSv4 mount(s) against exported volume(s) on the same host are not recommended, since this can result in a hung NFS server. -It occurs when an nfsd thread tries to do an NFSv4 VOP_RECLAIM()/Close RPC -as part of acquiring a new vnode. +It occurs when an nfsd thread tries to do an NFSv4 +.Fn VOP_RECLAIM +/ Close RPC as part of acquiring a new vnode. If all other nfsd threads are blocked waiting for lock(s) held by this nfsd thread, then there isn't an nfsd thread to service the Close RPC. .Sh FILES ___ svn-src-all@freebsd.org mailing list https://lists.freebsd.org/mailman/listinfo/svn-src-all To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"
svn commit: r368813 - in head/usr.sbin/bluetooth: bluetooth-config hccontrol hcseriald sdpd
Author: gbe (doc committer) Date: Sat Dec 19 13:36:59 2020 New Revision: 368813 URL: https://svnweb.freebsd.org/changeset/base/368813 Log: bluetooth: Fix a mandoc related issues - new sentence, new line - sections out of conventional order: Sh FILES - unusual Xr order: bthost(1) after bthidd(8) - no blank before trailing delimiter - whitespace at end of input line - sections out of conventional order: Sh EXIT STATUS MFC after:1 week Modified: head/usr.sbin/bluetooth/bluetooth-config/bluetooth-config.8 head/usr.sbin/bluetooth/hccontrol/hccontrol.8 head/usr.sbin/bluetooth/hcseriald/hcseriald.8 head/usr.sbin/bluetooth/sdpd/sdpd.8 Modified: head/usr.sbin/bluetooth/bluetooth-config/bluetooth-config.8 == --- head/usr.sbin/bluetooth/bluetooth-config/bluetooth-config.8 Sat Dec 19 13:23:26 2020(r368812) +++ head/usr.sbin/bluetooth/bluetooth-config/bluetooth-config.8 Sat Dec 19 13:36:59 2020(r368813) @@ -45,7 +45,8 @@ The following options are available: .It Fl d Scan for a specific bluetooth device address. .It Fl n -Limit scan to a specific host controller. Hint: List all netgraph nodes with +Limit scan to a specific host controller. +Hint: List all netgraph nodes with .Ql /usr/sbin/ngctl list . .El .Pp @@ -62,11 +63,6 @@ keyboards, configure and restart .Nm can bring up any interface and daemon necessary for operation and, if a node is provided on command line, will do so automatically for that interface. -.Sh CAVEATS -.Nm -can not parse entries in -.Xr hcsecd 8 -config file and thus will ask the user to manually modify existing pairing PIN entries. .Sh FILES .Bl -tag -width ".Pa /etc/bluetooth/hosts" -compact .It Pa /etc/bluetooth/hosts @@ -79,7 +75,8 @@ scan -n ubt0 -a 00:26:bb:7a:58:95 .Bd -ragged -offset indent This will scan the bluetooth controller ubt0hci for a bluetooth device with the address 00:26:bb:7a:58:95, set up ubt0 if necessary and enter an interactive dialog to pair the -new device. Since in this example a mouse is paired, +new device. +Since in this example a mouse is paired, .Nm will interact with .Xr bthidd 8 , @@ -93,9 +90,9 @@ This will scan all bluetooth controllers on the system to bring up controllers or daemons along the way. .Ed .Sh SEE ALSO +.Xr bthost 1 , .Xr bthidcontrol 8 , .Xr bthidd 8 , -.Xr bthost 1 , .Xr hccontrol 8 , .Xr hcsecd 8 , .Xr sdpcontrol 8 , @@ -107,5 +104,10 @@ utility first appeared in .Fx 12.1 . .Sh AUTHORS .An Dirk Engling Aq Mt erdge...@erdgeist.org +.Sh CAVEATS +.Nm +can not parse entries in +.Xr hcsecd 8 +config file and thus will ask the user to manually modify existing pairing PIN entries. .Sh THANKS TO Lars Engels and Warren Block for suggestions, help, and testing. Modified: head/usr.sbin/bluetooth/hccontrol/hccontrol.8 == --- head/usr.sbin/bluetooth/hccontrol/hccontrol.8 Sat Dec 19 13:23:26 2020(r368812) +++ head/usr.sbin/bluetooth/hccontrol/hccontrol.8 Sat Dec 19 13:36:59 2020(r368813) @@ -147,8 +147,8 @@ are: .It Cm Read_RSSI .It Cm LE_Enable .It Cm LE_Read_Local_Supported_Features -.It Cm LE_Set_Advertising_Parameters -.It Cm LE_Read_Advertising_Physical_Channel_Tx_Power +.It Cm LE_Set_Advertising_Parameters +.It Cm LE_Read_Advertising_Physical_Channel_Tx_Power .It Cm LE_Set_Advertising_Data .It Cm LE_Set_Scan_Response_Data .It Cm LE_Set_Advertising_Enable @@ -192,10 +192,11 @@ are: .It Cm Write_Node_Role_Switch .It Cm Read_Node_List .El +.Sh EXIT STATUS +.Ex -std .Sh EXAMPLES Make the blutooth LE host, ubt0hci, scannable through .Xr hccontrol 8 commands: -.Pp .Bd -literal -offset indent hccontrol -n ubt0hci le_set_advertising_enable disable hccontrol -n ubt0hci le_set_advertising_param @@ -204,8 +205,6 @@ hccontrol -n ubt0hci le_set_advertising_data hccontrol -n ubt0hci le_set_scan_response -n FBSD_Host hccontrol -n ubt0hci le_set_advertising_enable enable .Ed -.Sh EXIT STATUS -.Ex -std .Sh SEE ALSO .Xr bluetooth 3 , .Xr netgraph 3 , Modified: head/usr.sbin/bluetooth/hcseriald/hcseriald.8 == --- head/usr.sbin/bluetooth/hcseriald/hcseriald.8 Sat Dec 19 13:23:26 2020(r368812) +++ head/usr.sbin/bluetooth/hcseriald/hcseriald.8 Sat Dec 19 13:36:59 2020(r368813) @@ -69,7 +69,7 @@ Example: .El .Sh FILES .Bl -tag -width ".Pa /var/run/hcserial. Ns Ar * Ns Pa .pid" -compact -.It Pa /var/run/hcserial. Ns Ar * Ns Pa .pid +.It Pa /var/run/hcserial . Ns Ar * Ns Pa .pid Process ID of the currently running .Nm daemon. Modified: head/usr.sbin/bluetooth/sdpd/sdpd.8 == --- head/usr.sbin/bluetooth/sdpd/sdpd.8 Sat Dec 19 13:23:26 2020 (r368812) +++ head/usr.sbin/bluetooth/sdpd/sdpd.8 Sat
svn commit: r368812 - head/usr.sbin/mpsutil
Author: gbe (doc committer) Date: Sat Dec 19 13:23:26 2020 New Revision: 368812 URL: https://svnweb.freebsd.org/changeset/base/368812 Log: mpsutil(8): Remove trailing whitespace MFC after:1 week Modified: head/usr.sbin/mpsutil/mpsutil.8 Modified: head/usr.sbin/mpsutil/mpsutil.8 == --- head/usr.sbin/mpsutil/mpsutil.8 Sat Dec 19 13:21:40 2020 (r368811) +++ head/usr.sbin/mpsutil/mpsutil.8 Sat Dec 19 13:23:26 2020 (r368812) @@ -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 ___ svn-src-all@freebsd.org mailing list https://lists.freebsd.org/mailman/listinfo/svn-src-all To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"
svn commit: r368811 - head/usr.sbin/bhyvectl
Author: gbe (doc committer) Date: Sat Dec 19 13:21:40 2020 New Revision: 368811 URL: https://svnweb.freebsd.org/changeset/base/368811 Log: bhyvectl(8): Normalize the man page date MFC after:1 week Modified: head/usr.sbin/bhyvectl/bhyvectl.8 Modified: head/usr.sbin/bhyvectl/bhyvectl.8 == --- head/usr.sbin/bhyvectl/bhyvectl.8 Sat Dec 19 13:17:25 2020 (r368810) +++ head/usr.sbin/bhyvectl/bhyvectl.8 Sat Dec 19 13:21:40 2020 (r368811) @@ -24,7 +24,7 @@ .\" .\" $FreeBSD$ .\" -.Dd May 04, 2020 +.Dd May 4, 2020 .Dt BHYVECTL 8 .Os .Sh NAME ___ svn-src-all@freebsd.org mailing list https://lists.freebsd.org/mailman/listinfo/svn-src-all To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"
svn commit: r368810 - head/usr.sbin/camdd
Author: gbe (doc committer) Date: Sat Dec 19 13:17:25 2020 New Revision: 368810 URL: https://svnweb.freebsd.org/changeset/base/368810 Log: camdd(8): Fix the man page date The comment before the .Dd macro was missing a quotation mark, so that the date of the man page was always today. MFC after:3 days Modified: head/usr.sbin/camdd/camdd.8 Modified: head/usr.sbin/camdd/camdd.8 == --- head/usr.sbin/camdd/camdd.8 Sat Dec 19 13:11:44 2020(r368809) +++ head/usr.sbin/camdd/camdd.8 Sat Dec 19 13:17:25 2020(r368810) @@ -30,7 +30,7 @@ .\" Authors: Ken Merry (Spectra Logic Corporation) .\" .\" $FreeBSD$ -.\ +.\" .Dd November 11, 2015 .Dt CAMDD 8 .Os ___ svn-src-all@freebsd.org mailing list https://lists.freebsd.org/mailman/listinfo/svn-src-all To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"
svn commit: r368809 - head/usr.sbin/config
Author: gbe (doc committer) Date: Sat Dec 19 13:11:44 2020 New Revision: 368809 URL: https://svnweb.freebsd.org/changeset/base/368809 Log: config: Fix a few mandoc related errors - new sentence, new line - no blank before trailing delimiter MFC after:1 week Modified: head/usr.sbin/config/config.5 head/usr.sbin/config/config.8 Modified: head/usr.sbin/config/config.5 == --- head/usr.sbin/config/config.5 Sat Dec 19 13:05:54 2020 (r368808) +++ head/usr.sbin/config/config.5 Sat Dec 19 13:11:44 2020 (r368809) @@ -96,7 +96,7 @@ There can be more than one directive in a configuration file. The allowed list of CPU names is architecture specific and is defined in the file -.Pa sys/conf/options. Ns Aq Ar arch . +.Pa sys/conf/options . Ns Aq Ar arch . .\" DEVICE .Pp .It Ic device Ar name Op , Ar name Op ... @@ -109,7 +109,7 @@ defined in the file Devices that are specific to architecture .Ar arch are defined in the file -.Pa sys/conf/files. Ns Aq Ar arch . +.Pa sys/conf/files . Ns Aq Ar arch . .\" ENV .Pp .It Ic env Ar filename @@ -182,7 +182,7 @@ specified variables. .It Ic files Ar filename Specifies a file containing a list of files specific to that kernel configuration file (a la -.Pa files. Ns Aq Ar arch ) . +.Pa files . Ns Aq Ar arch ) . .\" HINTS .Pp .It Ic hints Ar filename @@ -400,7 +400,7 @@ the file Options specific to architecture .Ar arch are specified in the file -.Pa sys/conf/options. Ns Aq Ar arch . +.Pa sys/conf/options . Ns Aq Ar arch . .\" PROFILE .Pp .It Ic profile Ar number @@ -432,18 +432,18 @@ onwards, this information is passed to a booting kerne .Bl -tag -width ".Pa sys/conf/Makefile. Ns Ar arch" -compact .It Pa sys/compile/ Ns Ar NAME Compile directory created from a kernel configuration. -.It Pa sys/conf/Makefile. Ns Ar arch +.It Pa sys/conf/Makefile . Ns Ar arch .Pa Makefile fragments for architecture .Ar arch . .It Pa sys/conf/files Devices common to all architectures. -.It Pa sys/conf/files. Ns Ar arch +.It Pa sys/conf/files . Ns Ar arch Devices for architecture .Ar arch . .It Pa sys/conf/options Options common to all architectures. -.It Pa sys/conf/options. Ns Ar arch +.It Pa sys/conf/options . Ns Ar arch Options for architecture .Ar arch . .El Modified: head/usr.sbin/config/config.8 == --- head/usr.sbin/config/config.8 Sat Dec 19 13:05:54 2020 (r368808) +++ head/usr.sbin/config/config.8 Sat Dec 19 13:11:44 2020 (r368809) @@ -76,7 +76,8 @@ Search in .Ar path for any file included by the .Ic include -directive. This option may be specified more than once. +directive. +This option may be specified more than once. .It Fl d Ar destdir Use .Ar destdir @@ -238,10 +239,10 @@ in the root file system. .Bl -tag -width "/sys/ARCH/compile/SYSTEM_NAME" -compact .It Pa /sys/conf/files list of common files system is built from -.It Pa /sys/conf/Makefile. Ns Va ARCH +.It Pa /sys/conf/Makefile . Ns Va ARCH generic makefile for the .Va ARCH -.It Pa /sys/conf/files. Ns Va ARCH +.It Pa /sys/conf/files . Ns Va ARCH list of .Va ARCH specific files ___ svn-src-all@freebsd.org mailing list https://lists.freebsd.org/mailman/listinfo/svn-src-all To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"
svn commit: r368808 - head/usr.sbin/devctl
Author: gbe (doc committer) Date: Sat Dec 19 13:05:54 2020 New Revision: 368808 URL: https://svnweb.freebsd.org/changeset/base/368808 Log: devctl(8): Correct "sections out of conventional order" error MFC after:1 week Modified: head/usr.sbin/devctl/devctl.8 Modified: head/usr.sbin/devctl/devctl.8 == --- head/usr.sbin/devctl/devctl.8 Sat Dec 19 13:00:17 2020 (r368807) +++ head/usr.sbin/devctl/devctl.8 Sat Dec 19 13:05:54 2020 (r368808) @@ -194,11 +194,6 @@ tried first; if failed or not implemented, power reset If you have detached or suspended a child device explicitly and then do a reset, the child device will end up attached. .El -.Sh BUGS -Currently there is no administrative flag to prevent re-attach or resume -of the manually detached or suspended devices after reset. -Similarly, there is no flag to prevent un-suspending of the the manually -suspended devices after system resume. .Sh SEE ALSO .Xr devctl 3 , .Xr devinfo 8 @@ -207,3 +202,8 @@ The .Nm utility first appeared in .Fx 10.3 . +.Sh BUGS +Currently there is no administrative flag to prevent re-attach or resume +of the manually detached or suspended devices after reset. +Similarly, there is no flag to prevent un-suspending of the the manually +suspended devices after system resume. ___ svn-src-all@freebsd.org mailing list https://lists.freebsd.org/mailman/listinfo/svn-src-all To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"
svn commit: r368807 - head/usr.bin/patch
Author: gbe (doc committer) Date: Sat Dec 19 13:00:17 2020 New Revision: 368807 URL: https://svnweb.freebsd.org/changeset/base/368807 Log: patch(1): Fix a few mandoc related issues - no blank before trailing delimiter MFC after:1 week Modified: head/usr.bin/patch/patch.1 Modified: head/usr.bin/patch/patch.1 == --- head/usr.bin/patch/patch.1 Sat Dec 19 12:55:27 2020(r368806) +++ head/usr.bin/patch/patch.1 Sat Dec 19 13:00:17 2020(r368807) @@ -164,7 +164,7 @@ ask any questions. It assumes the following: skip patches for which a file to patch cannot be found; patch files even though they have the wrong version for the -.Qq Prereq: +.Qq Prereq : line in the patch; and assume that patches are not reversed even if they look like they are. This option does not suppress commentary; use @@ -288,7 +288,7 @@ in that it suppresses questions, but makes some differ skip patches for which a file to patch cannot be found (the same as .Fl f ) ; skip patches for which the file has the wrong version for the -.Qq Prereq: +.Qq Prereq : line in the patch; and assume that patches are reversed if they look like they are. .It Fl u , Fl Fl unified @@ -393,7 +393,7 @@ line of context. If that fails, and the maximum fuzz factor is set to 2 or more, the first two and last two lines of context are ignored, and another scan is made. -.Pq The default maximum fuzz factor is 2. +.Pq The default maximum fuzz factor is 2 . .Pp If .Nm @@ -450,7 +450,7 @@ and the file is specified in the line beginning with .Qq +++ . If there is an -.Qq Index: +.Qq Index : line in the leading garbage (regardless of the diff type), .Nm will use the file name from that line as the @@ -544,13 +544,13 @@ First, you can save people a lot of grief by keeping a file which is patched to increment the patch level as the first diff in the patch file you send out. If you put a -.Qq Prereq: +.Qq Prereq : line in with the patch, it will not let them apply patches out of order without some warning. .Pp Second, make sure you have specified the file names right, either in a context diff header, or with an -.Qq Index: +.Qq Index : line. If you are patching something in a subdirectory, be sure to tell the patch user to specify a ___ svn-src-all@freebsd.org mailing list https://lists.freebsd.org/mailman/listinfo/svn-src-all To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"
svn commit: r368806 - head/usr.bin/uname
Author: gbe (doc committer) Date: Sat Dec 19 12:55:27 2020 New Revision: 368806 URL: https://svnweb.freebsd.org/changeset/base/368806 Log: uname(1): Fix a typo in the man page date MFC after:3 days Modified: head/usr.bin/uname/uname.1 Modified: head/usr.bin/uname/uname.1 == --- head/usr.bin/uname/uname.1 Sat Dec 19 12:54:00 2020(r368805) +++ head/usr.bin/uname/uname.1 Sat Dec 19 12:55:27 2020(r368806) @@ -28,7 +28,7 @@ .\"@(#)uname.1 8.3 (Berkeley) 4/8/94 .\" $FreeBSD$ .\" -.Dd Novermber 13, 2020 +.Dd November 13, 2020 .Dt UNAME 1 .Os .Sh NAME ___ svn-src-all@freebsd.org mailing list https://lists.freebsd.org/mailman/listinfo/svn-src-all To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"
svn commit: r368805 - head/usr.bin/ident
Author: gbe (doc committer) Date: Sat Dec 19 12:54:00 2020 New Revision: 368805 URL: https://svnweb.freebsd.org/changeset/base/368805 Log: ident(1): Normalizing date format MFC after:3 days Modified: head/usr.bin/ident/ident.1 Modified: head/usr.bin/ident/ident.1 == --- head/usr.bin/ident/ident.1 Sat Dec 19 12:47:40 2020(r368804) +++ head/usr.bin/ident/ident.1 Sat Dec 19 12:54:00 2020(r368805) @@ -24,7 +24,7 @@ .\" .\" $FreeBSD$ .\" -.Dd Jul 25, 2015 +.Dd July 25, 2015 .Dt IDENT 1 .Os .Sh NAME ___ svn-src-all@freebsd.org mailing list https://lists.freebsd.org/mailman/listinfo/svn-src-all To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"
svn commit: r368804 - head/sbin/ipfw
Author: gbe (doc committer) Date: Sat Dec 19 12:47:40 2020 New Revision: 368804 URL: https://svnweb.freebsd.org/changeset/base/368804 Log: ipfw(8): Fix a few mandoc related issues - no blank before trailing delimiter - missing section argument: Xr inet_pton - skipping paragraph macro: Pp before Ss - unusual Xr order: syslogd after sysrc - tab in filled text There were a few multiline NAT examples which used the .Dl macro with tabs. I converted them to .Bd, which is a more suitable macro for that case. MFC after:1 week Modified: head/sbin/ipfw/ipfw.8 Modified: head/sbin/ipfw/ipfw.8 == --- head/sbin/ipfw/ipfw.8 Sat Dec 19 11:57:47 2020(r368803) +++ head/sbin/ipfw/ipfw.8 Sat Dec 19 12:47:40 2020(r368804) @@ -305,7 +305,6 @@ Finally, counters can be reset with the and .Cm resetlog commands. -.Pp .Ss COMMAND OPTIONS The following general options are available when invoking .Nm : @@ -389,7 +388,8 @@ listed. When listing pipes, sort according to one of the four counters (total or current packets or bytes). .It Fl t -When listing, show last match timestamp converted with ctime(). +When listing, show last match timestamp converted with +.Fn ctime . .It Fl T When listing, show last match timestamp as seconds from the epoch. This form can be more convenient for postprocessing by scripts. @@ -1441,7 +1441,7 @@ list. Matches all IPv6 addresses with base .Ar addr (specified as allowed by -.Xr inet_pton +.Xr inet_pton 3 or a hostname) and mask width of .Cm masklen @@ -1450,12 +1450,12 @@ bits. Matches all IPv6 addresses with base .Ar addr (specified as allowed by -.Xr inet_pton +.Xr inet_pton 3 or a hostname) and the mask of .Ar mask , specified as allowed by -.Xr inet_pton . +.Xr inet_pton 3 . As an example, fe::640:0:0/::::0:0 will match fe:*:*:*:0:640:*:*. This form is advised only for non-contiguous @@ -1518,7 +1518,7 @@ operand, and possibly grouped into .Pp The following match patterns can be used (listed in alphabetical order): .Bl -tag -width indent -.It Cm // this is a comment. +.It Cm // this is a comment . Inserts the specified text as a comment in the rule. Everything following // is considered as a comment and stored in the rule. You can have comment-only rules, which are listed as having a @@ -1806,7 +1806,10 @@ keyword is special name used for compatibility with ol .It Cm layer2 Matches only layer2 packets, i.e., those passed to .Nm -from ether_demux() and ether_output_frame(). +from +.Fn ether_demux +and +.Fn ether_output_frame . .It Cm limit Bro Cm src-addr | src-port | dst-addr | dst-port Brc Ar N Op Ar :flowname The firewall will only allow .Ar N @@ -2258,8 +2261,8 @@ Shows generic table information and algo-specific data The following lookup algorithms are supported: .Bl -tag -width indent .It Ar algo-desc : algo-name | "algo-name algo-data" -.It Ar algo-name: Ar addr:radix | addr:hash | iface:array | number:array | flow:hash -.It Cm addr:radix +.It Ar algo-name : Ar addr: radix | addr: hash | iface: array | number: array | flow: hash +.It Cm addr: radix Separate Radix trees for IPv4 and IPv6, the same way as the routing table (see .Xr route 4 ) . Default choice for @@ -2330,11 +2333,11 @@ IPv6 nexthop to fwd packets to. The .Cm tablearg argument can be used with the following actions: -.Cm nat, pipe , queue, divert, tee, netgraph, ngtee, fwd, skipto, setfib, +.Cm nat, pipe, queue, divert, tee, netgraph, ngtee, fwd, skipto, setfib , action parameters: -.Cm tag, untag, +.Cm tag, untag , rule options: -.Cm limit, tagged. +.Cm limit, tagged . .Pp When used with the .Cm skipto @@ -2614,7 +2617,6 @@ mode can be enabled by setting the .Va net.inet.ip.dummynet.io_fast .Xr sysctl 8 variable to a non-zero value. -.Pp .Ss PIPE, QUEUE AND SCHEDULER CONFIGURATION The .Em pipe , @@ -3550,7 +3552,6 @@ Note that the behavior of stateless translator with re packets differs from stateful translator. If corresponding addresses was not found in the lookup tables, the packet will not be dropped and the search continues. -.Pp .Ss XLAT464 CLAT translation XLAT464 CLAT NAT64 translator implements client-side stateless translation as defined in RFC6877 and is very similar to statless NAT64 translator @@ -3662,12 +3663,12 @@ or .Xr kenv 1 before ipfw module gets loaded. .Bl -tag -width indent -.It Va net.inet.ip.fw.default_to_accept: No 0 +.It Va net.inet.ip.fw.default_to_accept : No 0 Defines ipfw last rule behavior. This value overrides .Cd "options IPFW_DEFAULT_TO_(ACCEPT|DENY)" from kernel configuration file. -.It Va net.inet.ip.fw.tables_max: No 128 +.It Va net.inet.ip.fw.tables_max : No 128 Defines number of tables available in ipfw. Number cannot exceed 65534. .El @@ -3682,7 +3683,7 @@ These are shown below together with their default valu .Xr sysctl 8 command what value is actually in use)
svn commit: r368803 - head/sbin/ping
Author: gbe (doc committer) Date: Sat Dec 19 11:57:47 2020 New Revision: 368803 URL: https://svnweb.freebsd.org/changeset/base/368803 Log: ping(8): Fix a mandoc related issue - unusual Xr punctuation: none before traceroute6(8) Modified: head/sbin/ping/ping.8 Modified: head/sbin/ping/ping.8 == --- head/sbin/ping/ping.8 Sat Dec 19 11:47:38 2020(r368802) +++ head/sbin/ping/ping.8 Sat Dec 19 11:57:47 2020(r368803) @@ -749,7 +749,7 @@ ping -6 -k agl dst.foo.com .Xr ip6 4 , .Xr ifconfig 8 , .Xr routed 8 , -.Xr traceroute 8 +.Xr traceroute 8 , .Xr traceroute6 8 .Rs .%A A. Conta ___ svn-src-all@freebsd.org mailing list https://lists.freebsd.org/mailman/listinfo/svn-src-all To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"
svn commit: r368802 - head/sbin/nvmecontrol
Author: gbe (doc committer) Date: Sat Dec 19 11:47:38 2020 New Revision: 368802 URL: https://svnweb.freebsd.org/changeset/base/368802 Log: nvmecontrol(8): Fix a few mandoc related issues and add a SEE ALSO section - inserting missing end of block: Ss breaks Bl - skipping paragraph macro: Pp before Ss - referenced manual not found: Xr nvme 4 (2 times) - unknown standard specifier: St The The macro .St can only be used for standards known by mdoc(7). So add a SEE ALSO section and add a reference to the NVM Express Base Specification. MFC after:2 weeks Modified: head/sbin/nvmecontrol/nvmecontrol.8 Modified: head/sbin/nvmecontrol/nvmecontrol.8 == --- head/sbin/nvmecontrol/nvmecontrol.8 Sat Dec 19 11:03:54 2020 (r368801) +++ head/sbin/nvmecontrol/nvmecontrol.8 Sat Dec 19 11:47:38 2020 (r368802) @@ -35,7 +35,7 @@ .\" .\" $FreeBSD$ .\" -.Dd April 30, 2020 +.Dd December 19, 2020 .Dt NVMECONTROL 8 .Os .Sh NAME @@ -205,7 +205,6 @@ .Sh DESCRIPTION NVM Express (NVMe) is a storage protocol standard, for SSDs and other high-speed storage devices over PCI Express. -.Pp .Ss identify The identify commands reports information from the drive's .Dv IDENTIFY_CONTROLLER @@ -238,6 +237,7 @@ of is used to retrieve the .Dv IDENTIFY_CONTROLLER data associated with that drive. +.El .Ss logpage The logpage command knows how to print log pages of various types. It also knows about vendor specific log pages from hgst/wdc and intel. @@ -482,9 +482,7 @@ and commands send NVMe commands to either the administrative or the data part of the device. These commands are expected to be compatible with nvme-cli. -Please see -.St The NVMe Standard -for details. +Please see the NVMe Standard for details. .Bl -tag -width 16n .It Fl o -opcode Ar opcode Opcode to send. @@ -674,6 +672,12 @@ linker set are added to the top-level commands. The members of the .Va logpage linker set are added to the logpage parsers. +.Sh SEE ALSO +.Rs +.%T The NVM Express Base Specification +.%D June 10, 2019 +.%U https://nvmexpress.org/wp-content/uploads/NVM-Express-1_4-2019.06.10-Ratified.pdf +.Re .Sh HISTORY The .Nm ___ svn-src-all@freebsd.org mailing list https://lists.freebsd.org/mailman/listinfo/svn-src-all To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"
svn commit: r368800 - head/sbin/devd
Author: gbe (doc committer) Date: Sat Dec 19 11:03:04 2020 New Revision: 368800 URL: https://svnweb.freebsd.org/changeset/base/368800 Log: devd.conf(5): Fix a mandoc related issue - sections out of conventional order: Sh SEE ALSO MFC after:1 week Modified: head/sbin/devd/devd.conf.5 Modified: head/sbin/devd/devd.conf.5 == --- head/sbin/devd/devd.conf.5 Sat Dec 19 11:00:11 2020(r368799) +++ head/sbin/devd/devd.conf.5 Sat Dec 19 11:03:04 2020(r368800) @@ -786,12 +786,12 @@ detach 0 { The installed .Pa /etc/devd.conf has many additional examples. -.Sh BUGS -The variable expansion's interaction with single quotes is -suboptimal and surprising. .Sh SEE ALSO .Xr cam 4 , .Xr coretemp 4 , .Xr devfs 5 , .Xr re_format 7 , .Xr devd 8 +.Sh BUGS +The variable expansion's interaction with single quotes is +suboptimal and surprising. ___ svn-src-all@freebsd.org mailing list https://lists.freebsd.org/mailman/listinfo/svn-src-all To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"
svn commit: r368798 - head/share/man/man9
Author: gbe (doc committer) Date: Sat Dec 19 10:31:25 2020 New Revision: 368798 URL: https://svnweb.freebsd.org/changeset/base/368798 Log: sysctl(9): Fix a few mandoc related issues - missing comma before name: Nm SYSCTL_UQUAD - bad NAME section content: text MFC after:1 week Modified: head/share/man/man9/sysctl.9 Modified: head/share/man/man9/sysctl.9 == --- head/share/man/man9/sysctl.9Sat Dec 19 10:26:40 2020 (r368797) +++ head/share/man/man9/sysctl.9Sat Dec 19 10:31:25 2020 (r368798) @@ -95,8 +95,8 @@ .Nm SYSCTL_UINT , .Nm SYSCTL_ULONG , .Nm SYSCTL_UMA_CUR , -.Nm SYSCTL_UMA_MAX -.Nm SYSCTL_UQUAD , +.Nm SYSCTL_UMA_MAX , +.Nm SYSCTL_UQUAD .Nd Dynamic and static sysctl MIB creation functions .Sh SYNOPSIS .In sys/param.h ___ svn-src-all@freebsd.org mailing list https://lists.freebsd.org/mailman/listinfo/svn-src-all To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"
svn commit: r368797 - head/share/man/man9
Author: gbe (doc committer) Date: Sat Dec 19 10:26:40 2020 New Revision: 368797 URL: https://svnweb.freebsd.org/changeset/base/368797 Log: ofw_bus_status_okay(9): Fix a few mandoc related issues - missing comma before name: Nm ofw_bus_status_okay - missing comma before name: Nm ofw_bus_node_status_okay - skipping paragraph macro: Pp after Sh MFC after:1 week Modified: head/share/man/man9/ofw_bus_status_okay.9 Modified: head/share/man/man9/ofw_bus_status_okay.9 == --- head/share/man/man9/ofw_bus_status_okay.9 Sat Dec 19 10:24:36 2020 (r368796) +++ head/share/man/man9/ofw_bus_status_okay.9 Sat Dec 19 10:26:40 2020 (r368797) @@ -32,8 +32,8 @@ .Dt ofw_bus_status_okay 9 .Os .Sh NAME -.Nm ofw_bus_get_status -.Nm ofw_bus_status_okay +.Nm ofw_bus_get_status , +.Nm ofw_bus_status_okay , .Nm ofw_bus_node_status_okay .Nd check status of the device tree node .Sh SYNOPSIS @@ -47,7 +47,6 @@ .Ft int .Fn ofw_bus_node_status_okay "phandle_t node" .Sh DESCRIPTION -.Pp The "status" property of the device tree node indicates whether the device is enabled or not. Multiple hardware versions might be built using the same base System-on-Chip ___ svn-src-all@freebsd.org mailing list https://lists.freebsd.org/mailman/listinfo/svn-src-all To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"
svn commit: r368796 - head/share/man/man9
Author: gbe (doc committer) Date: Sat Dec 19 10:24:36 2020 New Revision: 368796 URL: https://svnweb.freebsd.org/changeset/base/368796 Log: ofw_bus_is_compatible(9): Fix a few mandoc related issues - missing comma before name: Nm ofw_bus_is_compatible_strict - missing comma before name: Nm ofw_bus_node_is_compatible - missing comma before name: Nm ofw_bus_search_compatible - skipping paragraph macro: Pp after Sh MFC after:1 week Modified: head/share/man/man9/ofw_bus_is_compatible.9 Modified: head/share/man/man9/ofw_bus_is_compatible.9 == --- head/share/man/man9/ofw_bus_is_compatible.9 Sat Dec 19 10:20:22 2020 (r368795) +++ head/share/man/man9/ofw_bus_is_compatible.9 Sat Dec 19 10:24:36 2020 (r368796) @@ -32,9 +32,9 @@ .Dt ofw_bus_is_compatible 9 .Os .Sh NAME -.Nm ofw_bus_is_compatible -.Nm ofw_bus_is_compatible_strict -.Nm ofw_bus_node_is_compatible +.Nm ofw_bus_is_compatible , +.Nm ofw_bus_is_compatible_strict , +.Nm ofw_bus_node_is_compatible , .Nm ofw_bus_search_compatible .Nd check device tree nodes for compatibility with drivers .Sh SYNOPSIS @@ -50,7 +50,6 @@ .Ft const struct ofw_compat_data * .Fn ofw_bus_search_compatible "device_t dev" "const struct ofw_compat_data *compat" .Sh DESCRIPTION -.Pp The "compatible" property of the device tree node is used to identify the type of the device the node represents. The property is a list of one or more strings that represent ___ svn-src-all@freebsd.org mailing list https://lists.freebsd.org/mailman/listinfo/svn-src-all To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"
svn commit: r368795 - head/share/man/man9
Author: gbe (doc committer) Date: Sat Dec 19 10:20:22 2020 New Revision: 368795 URL: https://svnweb.freebsd.org/changeset/base/368795 Log: fail(9): Fix a few mandoc related issues - function name without markup: return() - function name without markup: print() MFC after:1 week Modified: head/share/man/man9/fail.9 Modified: head/share/man/man9/fail.9 == --- head/share/man/man9/fail.9 Sat Dec 19 10:18:21 2020(r368794) +++ head/share/man/man9/fail.9 Sat Dec 19 10:20:22 2020(r368795) @@ -218,9 +218,15 @@ The operator -> can be used to express cascading terms If you specify ->, it means that if does not .Ql execute , is evaluated. -For the purpose of this operator, the return() and print() operators -are the only types that cascade. -A return() term only cascades if the code executes, and a print() +For the purpose of this operator, the +.Fn return +and +.Fn print +operators are the only types that cascade. +A +.Fn return +term only cascades if the code executes, and a +.Fn print term only cascades when passed a non-zero argument. A pid can optionally be specified. The fail point term is only executed when invoked by a process with a ___ svn-src-all@freebsd.org mailing list https://lists.freebsd.org/mailman/listinfo/svn-src-all To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"
svn commit: r368794 - head/share/man/man9
Author: gbe (doc committer) Date: Sat Dec 19 10:18:21 2020 New Revision: 368794 URL: https://svnweb.freebsd.org/changeset/base/368794 Log: driver(9): Fix a mandoc related issue - sections out of conventional order: Sh SEE ALSO MFC after:1 week Modified: head/share/man/man9/driver.9 Modified: head/share/man/man9/driver.9 == --- head/share/man/man9/driver.9Sat Dec 19 10:15:58 2020 (r368793) +++ head/share/man/man9/driver.9Sat Dec 19 10:18:21 2020 (r368794) @@ -102,11 +102,6 @@ macro will also create the devclass with the name of t can optionally call extra initialisation code in the driver by specifying an extra module event handler and argument as the last two arguments. -.Sh HISTORY -The -.Nm -framework first appeared in -.Fx 2.2.7 . .Sh SEE ALSO .Xr devclass 9 , .Xr device 9 , @@ -116,6 +111,11 @@ framework first appeared in .Xr DEVICE_PROBE 9 , .Xr DEVICE_SHUTDOWN 9 , .Xr DRIVER_MODULE 9 +.Sh HISTORY +The +.Nm +framework first appeared in +.Fx 2.2.7 . .Sh AUTHORS This manual page was written by .An Doug Rabson . ___ svn-src-all@freebsd.org mailing list https://lists.freebsd.org/mailman/listinfo/svn-src-all To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"
svn commit: r368793 - head/share/man/man9
Author: gbe (doc committer) Date: Sat Dec 19 10:15:58 2020 New Revision: 368793 URL: https://svnweb.freebsd.org/changeset/base/368793 Log: bhnd_erom(9): Fix a few mandoc related issues - skipping paragraph macro: Pp before Bl - skipping paragraph macro: Pp after Ss - skipping paragraph macro: Pp at the end of Ss - unusual Xr punctuation: none before bhnd_driver_get_erom_class(9) - unusual Xr punctuation: none before bus_space(9) MFC after:1 week Modified: head/share/man/man9/bhnd_erom.9 Modified: head/share/man/man9/bhnd_erom.9 == --- head/share/man/man9/bhnd_erom.9 Sat Dec 19 10:11:37 2020 (r368792) +++ head/share/man/man9/bhnd_erom.9 Sat Dec 19 10:15:58 2020 (r368793) @@ -336,7 +336,6 @@ If the core information is not desired, set to .Dv NULL . .Ss Bus Space I/O -.Pp The .Vt bhnd_erom_io structure provides a set of I/O callbacks used by @@ -353,7 +352,6 @@ callbacks directly. The .Vt bhnd_erom_io structure contains these required fields: -.Pp .Bl -tag -width "read" -offset indent .It Fa map A function implementing @@ -424,7 +422,6 @@ relative to the bus address previously mapped using The .Fa width must be one of 1, 2, or 4 bytes. -.Pp .Sh RETURN VALUES The .Fn bhnd_erom_probe @@ -477,8 +474,8 @@ functions return 0 on success, otherwise an appropriat .Sh SEE ALSO .Xr bhnd 4 , .Xr bhnd 9 , -.Xr bhnd_alloc_resource 9 -.Xr bhnd_driver_get_erom_class 9 +.Xr bhnd_alloc_resource 9 , +.Xr bhnd_driver_get_erom_class 9 , .Xr bus_space 9 .Sh AUTHORS .An -nosplit ___ svn-src-all@freebsd.org mailing list https://lists.freebsd.org/mailman/listinfo/svn-src-all To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"
svn commit: r368792 - head/share/man/man9
Author: gbe (doc committer) Date: Sat Dec 19 10:11:37 2020 New Revision: 368792 URL: https://svnweb.freebsd.org/changeset/base/368792 Log: bhnd(9): Fix a few mandoc related issues - skipping paragraph macro: Pp before Bl - skipping paragraph macro: Pp at the end of Ss - missing section argument: Xr device_set_desc - unusual Xr punctuation: none before bhnd_erom(9) MFC after:1 week Modified: head/share/man/man9/bhnd.9 Modified: head/share/man/man9/bhnd.9 == --- head/share/man/man9/bhnd.9 Sat Dec 19 09:55:02 2020(r368791) +++ head/share/man/man9/bhnd.9 Sat Dec 19 10:11:37 2020(r368792) @@ -715,7 +715,6 @@ per-core management registers. When BHND hardware is used as a host-connected peripheral (e.g., in a PCI Wi-Fi card), the on-chip peripheral controller core is configured to operate as an endpoint device, bridging access to the SoC hardware: -.Pp .Bl -dash -offset indent .It Host access to SoC address space is provided via a set of register windows @@ -925,7 +924,6 @@ A pointer to the bus If true, the resource requires bus window remapping before it is MMIO accessible. .El -.Pp .\" .Ss "Bus Space Functions" The bhnd_bus_space functions wrap their equivalent @@ -1116,7 +1114,6 @@ bus of device The returned .Vt bhnd_chipid struct contains the following fields: -.Pp .Bl -tag -width "enum_addr" -offset indent .It Fa chip_id The chip identifier. @@ -1320,7 +1317,6 @@ on success. The .Vt bhnd_board_info structure contains the following fields: -.Pp .Bl -tag -width "board_srom_rev" -offset indent .It Fa board_vendor Vendor ID of the board manufacturer (PCI-SIG assigned). @@ -1362,7 +1358,6 @@ fields will be populated from device NVRAM. .Pp Symbolic constants for common board flags are defined in .In dev/bhnd/bhnd_ids.h . -.Pp .Ss "Device Matching Functions" The bhnd device matching functions are used to match against core, chip, and board-level device attributes. @@ -1481,7 +1476,6 @@ is returned. A .Vt bhnd_board_match match descriptor may be initialized using one or more of the following macros: -.Pp .Bl -tag -width "Fn BHND_MATCH_BOARD_VENDOR vendor" -offset indent .It Fn BHND_MATCH_BOARD_VENDOR "vendor" Match on boards with a vendor equal to @@ -1518,7 +1512,6 @@ struct bhnd_board_match board_desc = { A .Vt bhnd_chip_match match descriptor may be initialized using one or more of the following macros: -.Pp .Bl -tag -width "Fn BHND_MATCH_CHIP_IPR id pkg hwrev" -offset indent .It Fn BHND_MATCH_CHIP_ID "id" Match on chips with an ID equal to @@ -1565,7 +1558,6 @@ struct bhnd_chip_match chip_desc = { A .Vt bhnd_core_match match descriptor may be initialized using one or more of the following macros: -.Pp .Bl -tag -width "Fn BHND_MATCH_CORE_VENDOR vendor" -offset indent .It Fn BHND_MATCH_CORE_VENDOR "vendor" Match on cores with a vendor ID equal to @@ -1711,7 +1703,6 @@ bridged backplane. A .Vt bhnd_device table entry may be initialized using one of the following macros: -.Pp .Bl -ohang -offset indent .It Fn BHND_DEVICE "vendor" "device" "desc" "quirks" "flags" Match on devices with a vendor ID equal to @@ -2242,7 +2233,6 @@ will be discarded. .Pp The following clocks are supported, and may be combined using bitwise OR to request multiple clocks: -.Pp .Bl -tag -width ".Dv BHND_CLOCK_DYN" -offset indent .It BHND_CLOCK_DYN Dynamically select an appropriate clock source based on all outstanding clock @@ -2454,7 +2444,7 @@ device identification of overriding the core name with the specified .Fa dev_name , to populate the device's verbose description using -.Xr device_set_desc . +.Xr device_set_desc 9 . .Pp The .Fn bhnd_set_default_core_desc @@ -2463,7 +2453,7 @@ function uses the device identification of .Fa dev to populate the device's verbose description using -.Xr device_set_desc . +.Xr device_set_desc 9 . .Pp The .Fn bhnd_vendor_name @@ -2491,7 +2481,6 @@ functions return a pointer to on success, a null pointer otherwise. .\" .Ss "Device Configuration Functions" -.Pp The .Fn bhnd_read_config and @@ -2521,7 +2510,6 @@ and functions return 0 on success, otherwise an appropriate error code is returned. .\" .Ss "Device Information Functions" -.Pp The .Fn bhnd_read_board_info function returns 0 on success, otherwise an appropriate error code is returned. @@ -2542,7 +2530,6 @@ If fetching the requested DMA address translation othe appropriate error code will be returned. .\" .Ss "Interrupt Functions" -.Pp The .Fn bhnd_get_intr_ivec function returns @@ -2641,7 +2628,6 @@ The and .Fn bhnd_release_ext_rsrc functions return 0 on success, otherwise an appropriate error code is returned. -.Pp .\" .Ss "Service Provider Functions" The @@ -2664,14 +2650,13 @@ function returns a pointer to on success, a null pointer if the requested provider is not registered. .\" .Ss "Utility Functions" -.Pp The .Fn bhnd_format_c
svn commit: r368791 - head/share/man/man9
Author: gbe (doc committer) Date: Sat Dec 19 09:55:02 2020 New Revision: 368791 URL: https://svnweb.freebsd.org/changeset/base/368791 Log: disk(9): Fix a few mandoc related errors - function name without markup: g_io_deliver() - function name without markup: disk_gone() - sections out of conventional order: Sh SEE ALSO - referenced manual not found: Xr MAKE_DEV 9 Actually the man page of MAKE_DEV has never existed. MFC after:3 days Modified: head/share/man/man9/disk.9 Modified: head/share/man/man9/disk.9 == --- head/share/man/man9/disk.9 Sat Dec 19 09:40:05 2020(r368790) +++ head/share/man/man9/disk.9 Sat Dec 19 09:55:02 2020(r368791) @@ -172,9 +172,11 @@ kernel panic to record a copy of the system RAM to the Optional: if this method is provided, it gives the disk driver the opportunity to override the default GEOM response to BIO_GETATTR requests. This function should return -1 if the attribute is not handled, 0 if the -attribute is handled, or an errno to be passed to g_io_deliver(). +attribute is handled, or an errno to be passed to +.Fn g_io_deliver . .It Vt "disk_gone_t *" Va d_gone -Optional: if this method is provided, it will be called after disk_gone() +Optional: if this method is provided, it will be called after +.Fn disk_gone is called, once GEOM has finished its cleanup process. Once this callback is called, it is safe for the disk driver to free all of its resources, as it will not be receiving further calls from GEOM. @@ -241,15 +243,14 @@ Typically used to store a pointer to the drivers .Vt softc structure for this disk device. .El +.Sh SEE ALSO +.Xr GEOM 4 , +.Xr devfs 5 .Sh HISTORY The .Nm kernel disk storage API first appeared in .Fx 4.9 . -.Sh SEE ALSO -.Xr GEOM 4 , -.Xr devfs 5 , -.Xr MAKE_DEV 9 .Sh AUTHORS This manual page was written by .An Robert Watson . ___ svn-src-all@freebsd.org mailing list https://lists.freebsd.org/mailman/listinfo/svn-src-all To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"
svn commit: r368790 - head/share/man/man9
Author: gbe (doc committer) Date: Sat Dec 19 09:40:05 2020 New Revision: 368790 URL: https://svnweb.freebsd.org/changeset/base/368790 Log: accept_filter(9): Fix a mandoc related error - no blank before trailing delimiter Modified: head/share/man/man9/accept_filter.9 Modified: head/share/man/man9/accept_filter.9 == --- head/share/man/man9/accept_filter.9 Sat Dec 19 08:38:31 2020 (r368789) +++ head/share/man/man9/accept_filter.9 Sat Dec 19 09:40:05 2020 (r368790) @@ -143,7 +143,7 @@ This manual page was written by .An Alfred Perlstein , .An Sheldon Hearn and -.An Jeroen Ruigrok van der Werven. +.An Jeroen Ruigrok van der Werven . .Pp The accept filter concept was pioneered by .An David Filo ___ svn-src-all@freebsd.org mailing list https://lists.freebsd.org/mailman/listinfo/svn-src-all To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"
svn commit: r368716 - stable/12/contrib/ee
Author: gbe (doc committer) Date: Thu Dec 17 13:07:15 2020 New Revision: 368716 URL: https://svnweb.freebsd.org/changeset/base/368716 Log: MFC r368511: ee(1) man page bugfixes - whitespace cleanups - new sentence, new line Modified: stable/12/contrib/ee/ee.1 Directory Properties: stable/12/ (props changed) Modified: stable/12/contrib/ee/ee.1 == --- stable/12/contrib/ee/ee.1 Thu Dec 17 12:58:05 2020(r368715) +++ stable/12/contrib/ee/ee.1 Thu Dec 17 13:07:15 2020(r368716) @@ -18,32 +18,33 @@ ree [-e] [-i] [-h] [+#] [\fIfile\fR ...] .fi .ad b .SH DESCRIPTION -The command -.I ee -is a simple screen oriented text editor. It is always in text insertion -mode unless there is a prompt at the bottom of the terminal, or a -menu present (in a box in the middle of the terminal). The command -.I ree -is the same as -.I ee, -but restricted to editing the named -file (no file operations, or shell escapes are allowed). +The command +.I ee +is a simple screen oriented text editor. +It is always in text insertion mode unless there is a prompt at the bottom +of the terminal, or a menu present (in a box in the middle of the terminal). +The command +.I ree +is the same as +.I ee, +but restricted to editing the named file (no file operations, or shell escapes +are allowed). .PP -An editor with similar user-friendly qualities but more features is available -and is called +An editor with similar user-friendly qualities but more features is available +and is called .I aee. .PP -For +For .I ee -to work properly, the environment variable -.SM TERM -must be set to indicate the type of terminal being used. For -example, for an -.SM HP 700/92 -terminal, the -.SM TERM -variable should be set to "70092". See your System Administrator if -you need more information. +to work properly, the environment variable +.SM TERM +must be set to indicate the type of terminal being used. +For example, for an +.SM HP 700/92 +terminal, the +.SM TERM +variable should be set to "70092". +See your System Administrator if you need more information. .\" .\" options .\" @@ -53,13 +54,13 @@ The following options are available from the command l .TP 4 .B -e Turns off expansion of tab character to spaces. -.TP +.TP .B -i Turns off display of information window at top of terminal. .TP .B -h -Turns off highlighting of borders of windows and menus (improves -performance on some terminals). +Turns off highlighting of borders of windows and menus (improves performance on +some terminals). .TP .B +# Moves the cursor to line '#' at startup. @@ -68,21 +69,19 @@ Moves the cursor to line '#' at startup. .\" control keys .\" .SS "Control keys" -To do anything other than insert text, the user must use the control -keys (the -.B Control -key, represented by a "^", pressed in conjunction with an -alphabetic key, e.g., ^a) and function keys available on the keyboard -(such as +To do anything other than insert text, the user must use the control keys (the +.B Control +key, represented by a "^", pressed in conjunction with an +alphabetic key, e.g., ^a) and function keys available on the keyboard +(such as .BR "Next Page" ", " "Prev Page" , arrow keys, etc.). .PP -Since not all terminals have function keys, +Since not all terminals have function keys, .I ee -has the basic cursor movement functions assigned to control keys as -well as more intuitive keys on the keyboard when available. For -instance, to move the cursor up, the user can use the up arrow key, -or +has the basic cursor movement functions assigned to control keys as well as more +intuitive keys on the keyboard when available. +For instance, to move the cursor up, the user can use the up arrow key, or .BR ^u . .RS 4 .nf @@ -119,11 +118,13 @@ or .sp .SS "EMACS keys mode" .PP -Since many shells provide an Emacs mode (for cursor movement and other editing -operations), some bindings that may be more useful for people familiar with -those bindings have been provided. These are accessible via the -.B settings -menu, or via the initialization file (see below). The mappings are as follows: +Since many shells provide an Emacs mode (for cursor movement and other editing +operations), some bindings that may be more useful for people familiar with those +bindings have been provided. +These are accessible via the +.B settings +menu, or via the initialization file (see below). +The mappings are as follows: .RS .nf .ta 1.4i @@ -178,11 +179,12 @@ Move the cursor in the direction indicated. .\" .SS Commands .PP -Some operations require more information than a single keystroke can -provide. For the most basic operations, there is a menu that can be -obtained by pressing the +Some operations require more information than a single keystroke can provide. +For the most basic operations, there is a menu that can be obtained by +pr
Re: svn commit: r368507 - in stable/12: share/man/man5 usr.sbin/periodic usr.sbin/periodic/etc/daily
On Thu, Dec 10, 2020 at 01:08:41PM +0100, Helge Oldach wrote: > Hi, > > Gordon Bergling wrote on Thu, 10 Dec 2020 10:55:05 +0100 (CET): > > Author: gbe (doc committer) > > Date: Thu Dec 10 09:55:04 2020 > > New Revision: 368507 > > URL: https://svnweb.freebsd.org/changeset/base/368507 > > > > Log: > > MFC r363110 (by allanjude): > > > > Add a periodic script to backup the partition table and boot code > > > > Optionally, alert you if the contents change from the previous backup > > > > PR: 86388 > > Submitted by: Rob Fairbanks , Miroslav Lachman > > <000.f...@quip.cz> (Original Version) > > Relnotes: yes > > Sponsored by: Klara Inc. > > Event:July 2020 Bugathon > > Differential Revision:https://reviews.freebsd.org/D25628 > > > > Added: > > stable/12/usr.sbin/periodic/etc/daily/221.backup-gpart > > - copied unchanged from r363110, > > head/usr.sbin/periodic/etc/daily/221.backup-gpart > > Modified: > > stable/12/share/man/man5/periodic.conf.5 > > stable/12/usr.sbin/periodic/periodic.conf > > Directory Properties: > > stable/12/ (props changed) > > > > Please MFC r363169 as well, else 221.backup-gpart won't be installed. > > Kind regards > Helge There were a few missing commits for PR 86388 including r363169. I have merge them all to -STABLE. Thanks for spotting this! --Gordon ___ svn-src-all@freebsd.org mailing list https://lists.freebsd.org/mailman/listinfo/svn-src-all To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"
svn commit: r368515 - stable/12/usr.sbin/periodic/etc/daily
Author: gbe (doc committer) Date: Thu Dec 10 13:32:51 2020 New Revision: 368515 URL: https://svnweb.freebsd.org/changeset/base/368515 Log: MFC r363169 by allanjude: Actually install the new 221.backup-gpart periodic script PR: 86388 Submitted by: Rob Fairbanks Reported by: Michael Butler Sponsored by: Klara Inc. Modified: stable/12/usr.sbin/periodic/etc/daily/Makefile Directory Properties: stable/12/ (props changed) Modified: stable/12/usr.sbin/periodic/etc/daily/Makefile == --- stable/12/usr.sbin/periodic/etc/daily/Makefile Thu Dec 10 13:25:45 2020(r368514) +++ stable/12/usr.sbin/periodic/etc/daily/Makefile Thu Dec 10 13:32:51 2020(r368515) @@ -11,6 +11,7 @@ CONFS=100.clean-disks \ 200.backup-passwd \ 210.backup-aliases \ 222.backup-gmirror \ + 221.backup-gpart \ 330.news \ 400.status-disks \ 401.status-graid \ ___ svn-src-all@freebsd.org mailing list https://lists.freebsd.org/mailman/listinfo/svn-src-all To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"
svn commit: r368514 - in stable/12: share/man/man5 usr.sbin/periodic usr.sbin/periodic/etc/daily
Author: gbe (doc committer) Date: Thu Dec 10 13:25:45 2020 New Revision: 368514 URL: https://svnweb.freebsd.org/changeset/base/368514 Log: MFC r367436 and r367443 by rew: r367436 Add a periodic script to backup output generated from `zfs list`, `zfs get`, `zpool list`, and `zpool get` commands. Disabled by default. r367443 Add a periodic script to backup output generated from `gmirror list`. Disabled by default. PR: 86388 Submitted by: Miroslav Lachman <000 dot fbsd at quip dot cz> Reported by: Seklecki Reviewed by: allanjude, 0mp, gbe Event:July 2020 Bugathon Differential Revision:https://reviews.freebsd.org/D25638 Differential Revision:https://reviews.freebsd.org/D25631 Added: stable/12/usr.sbin/periodic/etc/daily/222.backup-gmirror - copied unchanged from r367443, head/usr.sbin/periodic/etc/daily/222.backup-gmirror stable/12/usr.sbin/periodic/etc/daily/223.backup-zfs - copied unchanged from r367436, head/usr.sbin/periodic/etc/daily/223.backup-zfs Modified: stable/12/share/man/man5/periodic.conf.5 stable/12/usr.sbin/periodic/etc/daily/Makefile stable/12/usr.sbin/periodic/periodic.conf Directory Properties: stable/12/ (props changed) Modified: stable/12/share/man/man5/periodic.conf.5 == --- stable/12/share/man/man5/periodic.conf.5Thu Dec 10 13:11:52 2020 (r368513) +++ stable/12/share/man/man5/periodic.conf.5Thu Dec 10 13:25:45 2020 (r368514) @@ -25,7 +25,7 @@ .\" .\" $FreeBSD$ .\" -.Dd September 9, 2020 +.Dd November 7, 2020 .Dt PERIODIC.CONF 5 .Os .Sh NAME @@ -257,6 +257,20 @@ as configured in Set to .Dq Li YES to create backup of EFI System Partition (ESP). +.It Va daily_backup_gmirror_enable +.Pq Vt bool +Set to +.Dq Li YES +to create backup of gmirror information (i.e., output of +.Nm gmirror Cm list ) , +see +.Xr gmirror 8 . +.It Va daily_backup_gmirror_verbose +.Pq Vt bool +Set to +.Dq Li YES +to report a diff between the new backup and the existing backup +in the daily output. .It Va daily_backup_gpart_enable .Pq Vt bool Set to @@ -289,6 +303,57 @@ Set to if you want the .Pa /etc/mail/aliases file backed up and modifications to be displayed in your daily output. +.It Va daily_backup_zfs_enable +.Pq Vt bool +Set to +.Dq Li YES +to create backup of the output generated from the +.Xr zfs-list 8 +and +.Xr zpool-list 8 +utilities. +.It Va daily_backup_zfs_list_flags +.Pq Vt str +Set to the arguments for the +.Xr zfs-list 8 +utility. +The default is standard behavior. +.It Va daily_backup_zpool_list_flags +.Pq Vt str +Set to the arguments for the +.Xr zpool-list 8 +utility. +The default is +.Fl v . +.It Va daily_backup_zfs_props_enable +.Pq Vt bool +Set to +.Dq Li YES +to create backup of the output generated from the +.Xr zfs-get 8 +and +.Xr zpool-get 8 +utilities. +.It Va daily_backup_zfs_get_flags +.Pq Vt str +Set to the arguments for the +.Xr zfs-get 8 +utility. +The default is +.Cm all . +.It Va daily_backup_zpool_get_flags +.Pq Vt str +Set to the arguments for the +.Xr zpool-get 8 +utility. +The default is +.Cm all . +.It Va daily_backup_zfs_verbose +.Pq Vt bool +Set to +.Dq Li YES +to report a diff between the new backup and the existing backup +in the daily output. .It Va daily_calendar_enable .Pq Vt bool Set to Copied: stable/12/usr.sbin/periodic/etc/daily/222.backup-gmirror (from r367443, head/usr.sbin/periodic/etc/daily/222.backup-gmirror) == --- /dev/null 00:00:00 1970 (empty, because file is newly added) +++ stable/12/usr.sbin/periodic/etc/daily/222.backup-gmirrorThu Dec 10 13:25:45 2020(r368514, copy of r367443, head/usr.sbin/periodic/etc/daily/222.backup-gmirror) @@ -0,0 +1,72 @@ +#!/bin/sh + +# $FreeBSD$ +# Created by: Miroslav Lachman <000.f...@quip.cz> + +# Backup output from `gmirror list`, which provides detailed information +# of all gmirrors. The backup will be stored in /var/backups/. + +# If there is a global system configuration file, suck it in. +# +if [ -r /etc/defaults/periodic.conf ] +then + . /etc/defaults/periodic.conf + source_periodic_confs +fi + +bak_dir=/var/backups + +rotate() { + base_name=$1 + show_diff=$2 + file="$bak_dir/$base_name" + + if [ -f "${file}.bak" ]; then + rc=0 + if cmp -s "${file}.bak" "${file}.tmp"; then + rm "${file}.tmp" + else + rc=1 + [ -n "$show_diff" ] && diff "${file}.bak" "${file}.tmp" + mv "${file}.bak" "${file}.bak2" || rc=3 + mv "${file}.tmp" "${file}.bak" || rc=3 + fi + else + rc=1 + mv "${file}.tmp" "${file}.bak" || rc=3 + [ -n "$show_diff" ] && cat "${file}.bak" +
svn commit: r368512 - stable/12/share/man/man5
Author: gbe (doc committer) Date: Thu Dec 10 13:08:06 2020 New Revision: 368512 URL: https://svnweb.freebsd.org/changeset/base/368512 Log: MFC r366615: man5: Fix a few typos spotted by igor - fstab(5): conjuction -> conjunction - mount.conf(5): repeated 'the' - periodic.conf(5): Partion -> Partition Modified: stable/12/share/man/man5/fstab.5 stable/12/share/man/man5/mount.conf.5 stable/12/share/man/man5/periodic.conf.5 Modified: stable/12/share/man/man5/fstab.5 == --- stable/12/share/man/man5/fstab.5Thu Dec 10 10:58:30 2020 (r368511) +++ stable/12/share/man/man5/fstab.5Thu Dec 10 13:08:06 2020 (r368512) @@ -205,7 +205,7 @@ is applied automatically. .Pp The .Dq update -option is typically used in conjuction with two +option is typically used in conjunction with two .Nm files. The first Modified: stable/12/share/man/man5/mount.conf.5 == --- stable/12/share/man/man5/mount.conf.5 Thu Dec 10 10:58:30 2020 (r368511) +++ stable/12/share/man/man5/mount.conf.5 Thu Dec 10 13:08:06 2020 (r368512) @@ -123,8 +123,7 @@ is performed. When the kernel processes this line, a .Li mountroot> command-line prompt is displayed. -At this prompt, the operator can enter the -the root mount. +At this prompt, the operator can enter the root mount. .It Ic .md Ar file Create a memory backed .Xr md 4 Modified: stable/12/share/man/man5/periodic.conf.5 == --- stable/12/share/man/man5/periodic.conf.5Thu Dec 10 10:58:30 2020 (r368511) +++ stable/12/share/man/man5/periodic.conf.5Thu Dec 10 13:08:06 2020 (r368512) @@ -256,7 +256,7 @@ as configured in .Pq Vt bool Set to .Dq Li YES -to create backup of EFI System Partion (ESP). +to create backup of EFI System Partition (ESP). .It Va daily_backup_gpart_enable .Pq Vt bool Set to ___ svn-src-all@freebsd.org mailing list https://lists.freebsd.org/mailman/listinfo/svn-src-all To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"
svn commit: r368511 - head/contrib/ee
Author: gbe (doc committer) Date: Thu Dec 10 10:58:30 2020 New Revision: 368511 URL: https://svnweb.freebsd.org/changeset/base/368511 Log: ee(1): Whitespace cleanup This is a direct commit to -CURRENT since the upstream went away. MFC after:1 week Modified: head/contrib/ee/ee.1 Modified: head/contrib/ee/ee.1 == --- head/contrib/ee/ee.1Thu Dec 10 10:23:18 2020(r368510) +++ head/contrib/ee/ee.1Thu Dec 10 10:58:30 2020(r368511) @@ -18,32 +18,33 @@ ree [-e] [-i] [-h] [+#] [\fIfile\fR ...] .fi .ad b .SH DESCRIPTION -The command -.I ee -is a simple screen oriented text editor. It is always in text insertion -mode unless there is a prompt at the bottom of the terminal, or a -menu present (in a box in the middle of the terminal). The command -.I ree -is the same as -.I ee, -but restricted to editing the named -file (no file operations, or shell escapes are allowed). +The command +.I ee +is a simple screen oriented text editor. +It is always in text insertion mode unless there is a prompt at the bottom +of the terminal, or a menu present (in a box in the middle of the terminal). +The command +.I ree +is the same as +.I ee, +but restricted to editing the named file (no file operations, or shell escapes +are allowed). .PP -An editor with similar user-friendly qualities but more features is available -and is called +An editor with similar user-friendly qualities but more features is available +and is called .I aee. .PP -For +For .I ee -to work properly, the environment variable -.SM TERM -must be set to indicate the type of terminal being used. For -example, for an -.SM HP 700/92 -terminal, the -.SM TERM -variable should be set to "70092". See your System Administrator if -you need more information. +to work properly, the environment variable +.SM TERM +must be set to indicate the type of terminal being used. +For example, for an +.SM HP 700/92 +terminal, the +.SM TERM +variable should be set to "70092". +See your System Administrator if you need more information. .\" .\" options .\" @@ -53,13 +54,13 @@ The following options are available from the command l .TP 4 .B -e Turns off expansion of tab character to spaces. -.TP +.TP .B -i Turns off display of information window at top of terminal. .TP .B -h -Turns off highlighting of borders of windows and menus (improves -performance on some terminals). +Turns off highlighting of borders of windows and menus (improves performance on +some terminals). .TP .B +# Moves the cursor to line '#' at startup. @@ -68,21 +69,19 @@ Moves the cursor to line '#' at startup. .\" control keys .\" .SS "Control keys" -To do anything other than insert text, the user must use the control -keys (the -.B Control -key, represented by a "^", pressed in conjunction with an -alphabetic key, e.g., ^a) and function keys available on the keyboard -(such as +To do anything other than insert text, the user must use the control keys (the +.B Control +key, represented by a "^", pressed in conjunction with an +alphabetic key, e.g., ^a) and function keys available on the keyboard +(such as .BR "Next Page" ", " "Prev Page" , arrow keys, etc.). .PP -Since not all terminals have function keys, +Since not all terminals have function keys, .I ee -has the basic cursor movement functions assigned to control keys as -well as more intuitive keys on the keyboard when available. For -instance, to move the cursor up, the user can use the up arrow key, -or +has the basic cursor movement functions assigned to control keys as well as more +intuitive keys on the keyboard when available. +For instance, to move the cursor up, the user can use the up arrow key, or .BR ^u . .RS 4 .nf @@ -119,11 +118,13 @@ or .sp .SS "EMACS keys mode" .PP -Since many shells provide an Emacs mode (for cursor movement and other editing -operations), some bindings that may be more useful for people familiar with -those bindings have been provided. These are accessible via the -.B settings -menu, or via the initialization file (see below). The mappings are as follows: +Since many shells provide an Emacs mode (for cursor movement and other editing +operations), some bindings that may be more useful for people familiar with those +bindings have been provided. +These are accessible via the +.B settings +menu, or via the initialization file (see below). +The mappings are as follows: .RS .nf .ta 1.4i @@ -178,11 +179,12 @@ Move the cursor in the direction indicated. .\" .SS Commands .PP -Some operations require more information than a single keystroke can -provide. For the most basic operations, there is a menu that can be -obtained by pressing the +Some operations require more information than a single keystroke can provide. +For the most basic operations, there is a menu that can be obtained by +pressing the .SM \fBESC\fR -key.
svn commit: r368509 - in stable/12: share/man/man5 usr.sbin/periodic
Author: gbe (doc committer) Date: Thu Dec 10 10:00:43 2020 New Revision: 368509 URL: https://svnweb.freebsd.org/changeset/base/368509 Log: MFC r365508 (by rew): periodic.conf(5): don't truncate interface names reported by 420.status-network. The daily periodic script, 420.status-network uses netstat(1) to report interface status. By default, netstat(1) truncates interface names. Add the '-W' flag (avoid truncating interface names) as the default for 'daily_status_network_netstat_flags' in periodic.conf(5). The default 420.status-network command is now 'netstat -i -d -W -n'. PR: 163572 Reported by: kes-...@yandex.ru Reviewed by: allanjude (mentor), bcr (manpages) Approved by: allanjude (mentor) Differential Revision:https://reviews.freebsd.org/D26023 Modified: stable/12/share/man/man5/periodic.conf.5 stable/12/usr.sbin/periodic/periodic.conf Directory Properties: stable/12/ (props changed) Modified: stable/12/share/man/man5/periodic.conf.5 == --- stable/12/share/man/man5/periodic.conf.5Thu Dec 10 09:57:18 2020 (r368508) +++ stable/12/share/man/man5/periodic.conf.5Thu Dec 10 10:00:43 2020 (r368509) @@ -25,7 +25,7 @@ .\" .\" $FreeBSD$ .\" -.Dd June 16, 2020 +.Dd September 9, 2020 .Dt PERIODIC.CONF 5 .Os .Sh NAME @@ -439,7 +439,7 @@ utility when is set to .Dq Li YES . The default is -.Fl d . +.Fl d W . .It Va daily_status_network_usedns .Pq Vt bool Set to Modified: stable/12/usr.sbin/periodic/periodic.conf == --- stable/12/usr.sbin/periodic/periodic.conf Thu Dec 10 09:57:18 2020 (r368508) +++ stable/12/usr.sbin/periodic/periodic.conf Thu Dec 10 10:00:43 2020 (r368509) @@ -123,7 +123,7 @@ daily_status_mfi_enable="NO" # Check mfiutil(8) # 420.status-network daily_status_network_enable="YES" # Check network status daily_status_network_usedns="YES" # DNS lookups are ok -daily_status_network_netstat_flags="-d"# netstat(1) flags +daily_status_network_netstat_flags="-d -W" # netstat(1) flags # 430.status-uptime daily_status_uptime_enable="YES" # Check system uptime ___ svn-src-all@freebsd.org mailing list https://lists.freebsd.org/mailman/listinfo/svn-src-all To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"
svn commit: r368508 - stable/12/share/man/man5
Author: gbe (doc committer) Date: Thu Dec 10 09:57:18 2020 New Revision: 368508 URL: https://svnweb.freebsd.org/changeset/base/368508 Log: MFC r363114 (by allanjude) periodic.conf: correct capitailization in the middle of a sentence Reported by: yuripv Event:July 2020 Bugathon Modified: stable/12/share/man/man5/periodic.conf.5 Directory Properties: stable/12/ (props changed) Modified: stable/12/share/man/man5/periodic.conf.5 == --- stable/12/share/man/man5/periodic.conf.5Thu Dec 10 09:55:04 2020 (r368507) +++ stable/12/share/man/man5/periodic.conf.5Thu Dec 10 09:57:18 2020 (r368508) @@ -256,17 +256,17 @@ as configured in .Pq Vt bool Set to .Dq Li YES -To create backup of EFI System Partion (ESP). +to create backup of EFI System Partion (ESP). .It Va daily_backup_gpart_enable .Pq Vt bool Set to .Dq Li YES -To create backups of partition tables, and bootcode partition contents. +to create backups of partition tables, and bootcode partition contents. .It Va daily_backup_gpart_verbose .Pq Vt bool Set to .Dq Li YES -To be verbose if existing backups for kern.geom.conftxt or the partition tables differ +to be verbose if existing backups for kern.geom.conftxt or the partition tables differ from the new backups. .It Va daily_backup_passwd_enable .Pq Vt bool ___ svn-src-all@freebsd.org mailing list https://lists.freebsd.org/mailman/listinfo/svn-src-all To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"
svn commit: r368507 - in stable/12: share/man/man5 usr.sbin/periodic usr.sbin/periodic/etc/daily
Author: gbe (doc committer) Date: Thu Dec 10 09:55:04 2020 New Revision: 368507 URL: https://svnweb.freebsd.org/changeset/base/368507 Log: MFC r363110 (by allanjude): Add a periodic script to backup the partition table and boot code Optionally, alert you if the contents change from the previous backup PR: 86388 Submitted by: Rob Fairbanks , Miroslav Lachman <000.f...@quip.cz> (Original Version) Relnotes: yes Sponsored by: Klara Inc. Event:July 2020 Bugathon Differential Revision:https://reviews.freebsd.org/D25628 Added: stable/12/usr.sbin/periodic/etc/daily/221.backup-gpart - copied unchanged from r363110, head/usr.sbin/periodic/etc/daily/221.backup-gpart Modified: stable/12/share/man/man5/periodic.conf.5 stable/12/usr.sbin/periodic/periodic.conf Directory Properties: stable/12/ (props changed) Modified: stable/12/share/man/man5/periodic.conf.5 == --- stable/12/share/man/man5/periodic.conf.5Thu Dec 10 09:51:50 2020 (r368506) +++ stable/12/share/man/man5/periodic.conf.5Thu Dec 10 09:55:04 2020 (r368507) @@ -252,6 +252,22 @@ Files will be deleted using the same criteria as would normally use when determining whether to believe the cached information, as configured in .Pa /etc/mail/sendmail.cf . +.It Va daily_backup_efi_enable +.Pq Vt bool +Set to +.Dq Li YES +To create backup of EFI System Partion (ESP). +.It Va daily_backup_gpart_enable +.Pq Vt bool +Set to +.Dq Li YES +To create backups of partition tables, and bootcode partition contents. +.It Va daily_backup_gpart_verbose +.Pq Vt bool +Set to +.Dq Li YES +To be verbose if existing backups for kern.geom.conftxt or the partition tables differ +from the new backups. .It Va daily_backup_passwd_enable .Pq Vt bool Set to Copied: stable/12/usr.sbin/periodic/etc/daily/221.backup-gpart (from r363110, head/usr.sbin/periodic/etc/daily/221.backup-gpart) == --- /dev/null 00:00:00 1970 (empty, because file is newly added) +++ stable/12/usr.sbin/periodic/etc/daily/221.backup-gpart Thu Dec 10 09:55:04 2020(r368507, copy of r363110, head/usr.sbin/periodic/etc/daily/221.backup-gpart) @@ -0,0 +1,124 @@ +#!/bin/sh + +## $FreeBSD$ +## Created by: Miroslav Lachman <000.f...@quip.cz> + +## Backup of disk partitions layout, useful for gpart restore. +## Data are stored on local filesystem, in /var/backup. +## It is recommended to copy those files to off-site storage. + + +## If there is a global system configuration file, suck it in. +## +if [ -r /etc/defaults/periodic.conf ] +then + . /etc/defaults/periodic.conf + source_periodic_confs +fi + +bak_dir=/var/backups + +rotate() { + base_name=$1 + show_diff=$2 + file="$bak_dir/$base_name" + + if [ -f "${file}.bak" ] ; then + rc=0 + if cmp -s "${file}.bak" "${file}.tmp"; then + rm "${file}.tmp" + else + rc=1 + [ -n "$show_diff" ] && diff "${file}.bak" "${file}.tmp" + mv "${file}.bak" "${file}.bak2" || rc=3 + mv "${file}.tmp" "${file}.bak" || rc=3 + fi + else + rc=1 + mv "${file}.tmp" "${file}.bak" || rc=3 + [ -n "$show_diff" ] && cat "${file}.bak" + fi +} + +case "$daily_backup_gpart_verbose" in + [Yy][Ee][Ss]) show="YES" +esac + +case "$daily_backup_gpart_enable" in + [Yy][Ee][Ss]) + + echo "" + echo "Dump of kern.geom.conftxt:"; + sysctl -n kern.geom.conftxt > "$bak_dir/kern.geom.conftxt.tmp" + rotate "kern.geom.conftxt" $show + + gpart_devs=$(gpart show | awk '$1 == "=>" { print $4 }') + if [ -n "$daily_backup_gpart_exclude" ]; then + gpart_devs=$(echo ${gpart_devs} | grep -E -v "${daily_backup_gpart_exclude}") + fi + + if [ -z "$gpart_devs" ]; then + echo '$daily_backup_gpart_enable is set but no disk probed by kernel.' \ + "perhaps NFS diskless client." + rc=2 + else + echo "" + echo "Backup of partitions information for:"; + + for d in ${gpart_devs}; do + echo "$d" + safe_name=$(echo "gpart.${d}" | tr -cs ".[:alnum:]\n" "_") + gpart backup "$d" > "$bak_dir/$safe_name.tmp" + rotate "$safe_name" $show + done + + gpart_show=$(gpart show -p) + boot_part=$(echo "$gpart_show" | awk '$4 ~ /(bios|freebsd)-boot/ { print $3 }') + if [ -n "$boot_part" ]; then + echo "" + echo "Backup of boot partition content:" + for b in ${boot_p
svn commit: r368506 - stable/12/share/man/man5
Author: gbe (doc committer) Date: Thu Dec 10 09:51:50 2020 New Revision: 368506 URL: https://svnweb.freebsd.org/changeset/base/368506 Log: MFC r362226 (by bapt): Fix typo in the documentation about the daily ntpd status PR: 245679 Submitted by: Taylor Stearns Modified: stable/12/share/man/man5/periodic.conf.5 Directory Properties: stable/12/ (props changed) Modified: stable/12/share/man/man5/periodic.conf.5 == --- stable/12/share/man/man5/periodic.conf.5Thu Dec 10 09:39:27 2020 (r368505) +++ stable/12/share/man/man5/periodic.conf.5Thu Dec 10 09:51:50 2020 (r368506) @@ -25,7 +25,7 @@ .\" .\" $FreeBSD$ .\" -.Dd March 7, 2018 +.Dd June 16, 2020 .Dt PERIODIC.CONF 5 .Os .Sh NAME @@ -518,7 +518,7 @@ for the previous day. .Pq Vt num Set to the number of maillog files that should be checked for yesterday's mail rejects. -.It Va daily_status_ntpd +.It Va daily_status_ntpd_enable .Pq Vt bool Set to .Dq Li YES ___ svn-src-all@freebsd.org mailing list https://lists.freebsd.org/mailman/listinfo/svn-src-all To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"
svn commit: r368418 - in stable/12: sbin/mount share/man/man5
Author: gbe (doc committer) Date: Mon Dec 7 20:36:58 2020 New Revision: 368418 URL: https://svnweb.freebsd.org/changeset/base/368418 Log: MFC r350224 by sobomax: Allow "update" option to be used in the fstab(5). Document possible use case. Approved by: sobomax Differential Revision:https://reviews.freebsd.org/D18586 Modified: stable/12/sbin/mount/mount.c stable/12/share/man/man5/fstab.5 Directory Properties: stable/12/ (props changed) Modified: stable/12/sbin/mount/mount.c == --- stable/12/sbin/mount/mount.cMon Dec 7 18:58:08 2020 (r368417) +++ stable/12/sbin/mount/mount.cMon Dec 7 20:36:58 2020 (r368418) @@ -361,6 +361,7 @@ main(int argc, char *argv[]) else failok = 0; if (!(init_flags & MNT_UPDATE) && + !hasopt(fs->fs_mntops, "update") && ismounted(fs, mntbuf, mntsize)) continue; options = update_options(options, fs->fs_mntops, Modified: stable/12/share/man/man5/fstab.5 == --- stable/12/share/man/man5/fstab.5Mon Dec 7 18:58:08 2020 (r368417) +++ stable/12/share/man/man5/fstab.5Mon Dec 7 20:36:58 2020 (r368418) @@ -190,6 +190,32 @@ see the .Xr mount 8 manual page. .Pp +If the option +.Dq update +is specified, it indicates that the status of an already mounted file +system should be changed accordingly. +This allows, for example, file systems mounted read-only to be upgraded +read-write and vice-versa. +By default, an entry corresponding to a file systems that is already +mounted is going to be skipped over when processing +.Nm , +unless it's a root file system, in which case logic similar to +.Dq update +is applied automatically. +.Pp +The +.Dq update +option is typically used in conjuction with two +.Nm +files. +The first +.Nm +file is used to set up the initial set of file systems. +The second +.Nm +file is then run to update the initial set of file systems and +to add additional file systems. +.Pp The type of the mount is extracted from the .Fa fs_mntops field and stored separately in the ___ svn-src-all@freebsd.org mailing list https://lists.freebsd.org/mailman/listinfo/svn-src-all To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"
svn commit: r368383 - stable/12/usr.sbin/wpa/hostapd
Author: gbe (doc committer) Date: Sun Dec 6 08:01:27 2020 New Revision: 368383 URL: https://svnweb.freebsd.org/changeset/base/368383 Log: MFC r367901 and r367904 r367901: hostapd.conf(5): Fix a mandoc warning -new sentence, new line r367904: hostapd.conf(5): Add missing 'l' In r367901 I accidentally deleted the 'l' while fixing a few mandoc erros. Spotted by: Yuri Pankov Modified: stable/12/usr.sbin/wpa/hostapd/hostapd.conf.5 Directory Properties: stable/12/ (props changed) Modified: stable/12/usr.sbin/wpa/hostapd/hostapd.conf.5 == --- stable/12/usr.sbin/wpa/hostapd/hostapd.conf.5 Sun Dec 6 07:57:56 2020(r368382) +++ stable/12/usr.sbin/wpa/hostapd/hostapd.conf.5 Sun Dec 6 08:01:27 2020(r368383) @@ -67,8 +67,9 @@ The following parameters are recognized: Interface name. Should be set in .Dq hostap -mode. Make certain that there are no spaces after the interface name, -or hostapd will complain that the interface does not exist. +mode. +Make certain that there are no spaces after the interface name, or hostapd will +complain that the interface does not exist. .It Va debug Debugging mode: 0 = no, 1 = minimal, 2 = verbose, 3 = msg dumps, 4 = excessive. ___ svn-src-all@freebsd.org mailing list https://lists.freebsd.org/mailman/listinfo/svn-src-all To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"
svn commit: r368382 - stable/12/sbin/camcontrol
Author: gbe (doc committer) Date: Sun Dec 6 07:57:56 2020 New Revision: 368382 URL: https://svnweb.freebsd.org/changeset/base/368382 Log: MFC r367889: camcontrol(8): Fix some warnings spotted by mandoc - skipping paragraph macro: Pp before Bl Modified: stable/12/sbin/camcontrol/camcontrol.8 Directory Properties: stable/12/ (props changed) Modified: stable/12/sbin/camcontrol/camcontrol.8 == --- stable/12/sbin/camcontrol/camcontrol.8 Sun Dec 6 07:55:12 2020 (r368381) +++ stable/12/sbin/camcontrol/camcontrol.8 Sun Dec 6 07:57:56 2020 (r368382) @@ -2276,7 +2276,6 @@ These zones must be written sequentially. If they are not written sequentially, starting at the write pointer, the command will fail. .El -.Pp .Bl -tag -width 12n .It Fl c Ar cmd Specify the zone subcommand: @@ -2831,7 +2830,6 @@ This will read and decode the attribute values from pa in tape drive sa0, and will display any .Tn SCSI errors that result. -.Pp .Bd -literal -offset indent camcontrol zone da0 -v -c rz -P summary .Ed @@ -2842,7 +2840,6 @@ summary of the zone parameters, and display any or .Tn ATA errors that result. -.Pp .Bd -literal -offset indent camcontrol zone da0 -v -c rz -o reset .Ed @@ -2853,7 +2850,6 @@ pointer reset from the disk da0, and display any or .Tn ATA errors that result. -.Pp .Bd -literal -offset indent camcontrol zone da0 -v -c rwp -l 0x2c8 .Ed @@ -2864,7 +2860,6 @@ that starts at LBA 0x2c8 and display any or .Tn ATA errors that result. -.Pp .Bd -literal -offset indent camcontrol epc ada0 -c timer -T 60.1 -p Idle_a -e -s .Ed @@ -2873,7 +2868,6 @@ Set the timer for the Idle_a power condition on drive .Pa ada0 to 60.1 seconds, enable that particular power condition, and save the timer value and the enabled state of the power condition. -.Pp .Bd -literal -offset indent camcontrol epc da4 -c goto -p Standby_z -H .Ed @@ -2885,7 +2879,6 @@ the drive's lowest power state) and hold in that state explicitly released by another .Cm goto command. -.Pp .Bd -literal -offset indent camcontrol epc da2 -c status -P .Ed @@ -2903,7 +2896,6 @@ to only send the .Tn ATA CHECK POWER MODE command, which should not trigger a change in the drive's power state. -.Pp .Bd -literal -offset indent camcontrol epc ada0 -c list .Ed @@ -2911,7 +2903,6 @@ camcontrol epc ada0 -c list Display the ATA Power Conditions log (Log Address 0x08) for drive .Pa ada0 . -.Pp .Bd -literal -offset indent camcontrol timestamp sa0 -s -f "%a, %d %b %Y %T %z" \e -T "Wed, 26 Oct 2016 21:43:57 -0600" ___ svn-src-all@freebsd.org mailing list https://lists.freebsd.org/mailman/listinfo/svn-src-all To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"
svn commit: r368381 - stable/12/sbin/devmatch
Author: gbe (doc committer) Date: Sun Dec 6 07:55:12 2020 New Revision: 368381 URL: https://svnweb.freebsd.org/changeset/base/368381 Log: MFC r32 (by imp), r367897 r32: devmatch: First appeared in 12.0 Document that devmatch first appeared in FreeBSD 12.0. Also can't -> can not. But it doesn't help the sentence much. r367897: devmatch(8): Fix section ordering - sections out of conventional order: Sh HISTORY Modified: stable/12/sbin/devmatch/devmatch.8 Directory Properties: stable/12/ (props changed) Modified: stable/12/sbin/devmatch/devmatch.8 == --- stable/12/sbin/devmatch/devmatch.8 Sun Dec 6 07:50:15 2020 (r368380) +++ stable/12/sbin/devmatch/devmatch.8 Sun Dec 6 07:55:12 2020 (r368381) @@ -23,7 +23,7 @@ .\" .\" $FreeBSD$ .\" -.Dd February 16, 2018 +.Dd October 12, 2020 .Dt DEVMATCH 8 .Os .Sh NAME @@ -62,13 +62,17 @@ Parse and use a standard NOMATCH event from for matching instead of searching the device tree. .It Fl u Fl -unbound Attempt to produce a list of those drivers with PNP info whose driver -tables with that PNP info can't be found. +tables with that PNP info can not be found. .It Fl v Fl -verbose Produce more verbose output. .El .Sh SEE ALSO .Xr devinfo 8 , .Xr MODULE_PNP_INFO 9 +.Sh HISTORY +.Nm +first appeared in +.Fx 12.0 . .Sh AUTHORS .An Warner Losh Aq Mt i...@freebsd.org .Sh BUGS ___ svn-src-all@freebsd.org mailing list https://lists.freebsd.org/mailman/listinfo/svn-src-all To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"
svn commit: r368380 - in stable/12: sbin/devmatch sbin/fsck sbin/mount_msdosfs usr.bin/chat usr.bin/du usr.bin/setchannel usr.bin/tftp usr.sbin/ctladm usr.sbin/extattrctl usr.sbin/i2c usr.sbin/moun...
Author: gbe (doc committer) Date: Sun Dec 6 07:50:15 2020 New Revision: 368380 URL: https://svnweb.freebsd.org/changeset/base/368380 Log: MFC r366572: Fix a few mandoc issues - no blank before trailing delimiter - whitespace at end of input line - sections out of conventional order - normalizing date format - AUTHORS section without An macro Modified: stable/12/sbin/devmatch/devmatch.8 stable/12/sbin/fsck/fsck.8 stable/12/sbin/mount_msdosfs/mount_msdosfs.8 stable/12/usr.bin/chat/chat.8 stable/12/usr.bin/du/du.1 stable/12/usr.bin/setchannel/setchannel.1 stable/12/usr.bin/tftp/tftp.1 stable/12/usr.sbin/ctladm/ctladm.8 stable/12/usr.sbin/extattrctl/extattrctl.8 stable/12/usr.sbin/i2c/i2c.8 stable/12/usr.sbin/mountd/exports.5 stable/12/usr.sbin/nfsuserd/nfsuserd.8 stable/12/usr.sbin/pmcstudy/pmcstudy.8 stable/12/usr.sbin/traceroute6/traceroute6.8 Directory Properties: stable/12/ (props changed) Modified: stable/12/sbin/devmatch/devmatch.8 == --- stable/12/sbin/devmatch/devmatch.8 Sun Dec 6 07:47:10 2020 (r368379) +++ stable/12/sbin/devmatch/devmatch.8 Sun Dec 6 07:50:15 2020 (r368380) @@ -69,6 +69,8 @@ Produce more verbose output. .Sh SEE ALSO .Xr devinfo 8 , .Xr MODULE_PNP_INFO 9 +.Sh AUTHORS +.An Warner Losh Aq Mt i...@freebsd.org .Sh BUGS The kernel has hints in it, but we exclude it from the list of modules to suggest for unmatched devices. @@ -92,5 +94,3 @@ logical equivalent in USB, PCI, and others. .Pp Many drivers currently lack proper PNP table decorations and need to be updated. -.Sh AUTHORS -.An Warner Losh Aq Mt i...@freebsd.org Modified: stable/12/sbin/fsck/fsck.8 == --- stable/12/sbin/fsck/fsck.8 Sun Dec 6 07:47:10 2020(r368379) +++ stable/12/sbin/fsck/fsck.8 Sun Dec 6 07:50:15 2020(r368380) @@ -143,7 +143,7 @@ only if is compiled to support it. .It Fl f Force checking of file systems. -Running +Running .Dq Li fsck -f ignores the journal and does a full consistency check of the disk so will find and fix the errors about which the Modified: stable/12/sbin/mount_msdosfs/mount_msdosfs.8 == --- stable/12/sbin/mount_msdosfs/mount_msdosfs.8Sun Dec 6 07:47:10 2020(r368379) +++ stable/12/sbin/mount_msdosfs/mount_msdosfs.8Sun Dec 6 07:50:15 2020(r368380) @@ -202,7 +202,7 @@ and first appeared in was renamed to the more aptly-named .Nm in -.Fx 5.0. +.Fx 5.0 . The character code conversion routine was added in 2003. .Sh AUTHORS Initial implementation as Modified: stable/12/usr.bin/chat/chat.8 == --- stable/12/usr.bin/chat/chat.8 Sun Dec 6 07:47:10 2020 (r368379) +++ stable/12/usr.bin/chat/chat.8 Sun Dec 6 07:50:15 2020 (r368380) @@ -291,7 +291,8 @@ The .Dv SAY strings could be used to give progress messages in sections of the script where you want to have 'ECHO OFF' but still let the user -know what is happening. An example is: +know what is happening. +An example is: .Bd -literal -offset indent ABORT BUSY ECHO OFF Modified: stable/12/usr.bin/du/du.1 == --- stable/12/usr.bin/du/du.1 Sun Dec 6 07:47:10 2020(r368379) +++ stable/12/usr.bin/du/du.1 Sun Dec 6 07:50:15 2020(r368380) @@ -63,7 +63,7 @@ Calculate block counts in .Ar blocksize byte blocks. This is different from the -.Fl h, k, m, +.Fl h , k , m , .Fl Fl si and .Fl g @@ -172,7 +172,7 @@ options override each other and the command's actions by the last one specified. .Pp The -.Fl h, k, m +.Fl h , k , m and .Fl Fl si options all override each other; the last one specified determines @@ -183,7 +183,7 @@ the block counts used. If the environment variable .Ev BLOCKSIZE is set, and the -.Fl h, k, m +.Fl h , k , m or .Fl Fl si options are not specified, the block counts will be displayed in units of @@ -191,7 +191,7 @@ that block size. If .Ev BLOCKSIZE is not set, and the -.Fl h, k, m +.Fl h , k , m or .Fl Fl si options are not specified, the block counts will be displayed in 512-byte Modified: stable/12/usr.bin/setchannel/setchannel.1 == --- stable/12/usr.bin/setchannel/setchannel.1 Sun Dec 6 07:47:10 2020 (r368379) +++ stable/12/usr.bin/setchannel/setchannel.1 Sun Dec 6 07:50:15 2020 (r368380) @@ -61,8 +61,8 @@ Select svideo input. .It Fl t Select tuner. .It Fl g Cm geom -Select geometry. The first resolution is for NTSC, the second for -PAL. +Select geometry. +The first resolution is for NTSC, the second for PAL. .Pp VCD: 352x240 or 35
svn commit: r368379 - stable/12/usr.sbin/mountd
Author: gbe (doc committer) Date: Sun Dec 6 07:47:10 2020 New Revision: 368379 URL: https://svnweb.freebsd.org/changeset/base/368379 Log: MFC r344013 and r344015 (by cracauer) r344013: Clarify NFSv4 /etc/exports semantics, with working example. The existing wording has been confusing users for years. r344015: Bump .Dd for today's edit. Thank you Enji Cooper Modified: stable/12/usr.sbin/mountd/exports.5 Directory Properties: stable/12/ (props changed) Modified: stable/12/usr.sbin/mountd/exports.5 == --- stable/12/usr.sbin/mountd/exports.5 Sun Dec 6 07:38:58 2020 (r368378) +++ stable/12/usr.sbin/mountd/exports.5 Sun Dec 6 07:47:10 2020 (r368379) @@ -28,7 +28,7 @@ .\" @(#)exports.5 8.3 (Berkeley) 3/29/95 .\" $FreeBSD$ .\" -.Dd May 20, 2017 +.Dd Feb 11, 2019 .Dt EXPORTS 5 .Os .Sh NAME @@ -498,6 +498,40 @@ and any client within the 131.104.48 subnet is permitt operations on the server, so long as valid Kerberos credentials are provided. The machine grumpy.cis.uoguelph.ca is permitted to perform NFSv4 state operations on the server using AUTH_SYS credentials, as well as Kerberos ones. +.Pp +In the following example some directories are exported as NFSv3 and NFSv4: +.Bd -literal -offset indent +V4: /wingsdl/nfsv4 +/wingsdl/nfsv4/usr-ports -maproot=root -network 172.16.0.0 -mask 255.255.0.0 +/wingsdl/nfsv4/clasper -maproot=root clasper +.Ed +.Pp +Only one V4: line is needed or allowed to declare where NFSv4 is +rooted. The other lines declare specific exported directories with +their absolute paths given in /etc/exports. +.Pp +The exported directories' paths are used for both v3 and v4. +However, they are interpreted differently for v3 and v4. A client +mount command for usr-ports would use the server-absolute name when +using nfsv3: +.Bd -literal -offset indent +mount server:/wingsdl/nfsv4/usr-ports /mnt/tmp +.Ed +.Pp +A mount command using NFSv4 would use the path relative to the NFSv4 +root: +.Bd -literal -offset indent +mount server:/usr-ports /mnt/tmp +.Ed +.Pp +This also differentiates which version you want if the client can do +both v3 and v4. The former will only ever do a v3 mount and the +latter will only ever do a v4 mount. +.Pp +Note that due to different mount behavior between NFSv3 and NFSv4 a +NFSv4 mount request for a directory that the client does not have +permission for will succeed and read/write access will fail +afterwards, whereas NFSv3 rejects the mount request. .Sh SEE ALSO .Xr nfsv4 4 , .Xr netgroup 5 , ___ svn-src-all@freebsd.org mailing list https://lists.freebsd.org/mailman/listinfo/svn-src-all To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"
svn commit: r368378 - stable/12/sbin/fsck
Author: gbe (doc committer) Date: Sun Dec 6 07:38:58 2020 New Revision: 368378 URL: https://svnweb.freebsd.org/changeset/base/368378 Log: MFC r344922 (by wosch): explain ``fsck -f'' more in detail PR: 223491 Approved by: mckusick, 0mp, imp Differential Revision:https://reviews.freebsd.org/D19437 Modified: stable/12/sbin/fsck/fsck.8 Directory Properties: stable/12/ (props changed) Modified: stable/12/sbin/fsck/fsck.8 == --- stable/12/sbin/fsck/fsck.8 Sun Dec 6 07:22:38 2020(r368377) +++ stable/12/sbin/fsck/fsck.8 Sun Dec 6 07:38:58 2020(r368378) @@ -29,7 +29,7 @@ .\" .\" $FreeBSD$ .\" -.Dd October 5, 2016 +.Dd March 5, 2019 .Dt FSCK 8 .Os .Sh NAME @@ -142,8 +142,12 @@ only if .Nm is compiled to support it. .It Fl f -Force checking of file systems, even when they are marked clean (for file systems -that support this). +Force checking of file systems. +Running +.Dq Li fsck -f +ignores the journal and does a full +consistency check of the disk so will find and fix the errors about which the +journal is unaware. .It Fl n Causes .Nm ___ svn-src-all@freebsd.org mailing list https://lists.freebsd.org/mailman/listinfo/svn-src-all To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"
svn commit: r368377 - in stable/12: usr.bin/iscsictl usr.sbin/bsnmpd/modules/snmp_wlan
Author: gbe (doc committer) Date: Sun Dec 6 07:22:38 2020 New Revision: 368377 URL: https://svnweb.freebsd.org/changeset/base/368377 Log: MFC r367898, r367899 r367898: iscsi.conf(5): Fix a mandoc warning - new sentence, new line r367899: snmp_wlan(3): Fix mandoc warnings - new sentence, new line Modified: stable/12/usr.bin/iscsictl/iscsi.conf.5 stable/12/usr.sbin/bsnmpd/modules/snmp_wlan/snmp_wlan.3 Directory Properties: stable/12/ (props changed) Modified: stable/12/usr.bin/iscsictl/iscsi.conf.5 == --- stable/12/usr.bin/iscsictl/iscsi.conf.5 Sun Dec 6 07:09:34 2020 (r368376) +++ stable/12/usr.bin/iscsictl/iscsi.conf.5 Sun Dec 6 07:22:38 2020 (r368377) @@ -146,9 +146,9 @@ for iSCSI over RDMA, or Default is .Qq Ar iSCSI . .It Cm dscp -The DiffServ Codepoint used for sending data. The DSCP can be -set to numeric, or hexadecimal values directly, as well as the -well-defined +The DiffServ Codepoint used for sending data. +The DSCP can be set to numeric, or hexadecimal values directly, +as well as the well-defined .Qq Ar cs and .Qq Ar af Modified: stable/12/usr.sbin/bsnmpd/modules/snmp_wlan/snmp_wlan.3 == --- stable/12/usr.sbin/bsnmpd/modules/snmp_wlan/snmp_wlan.3 Sun Dec 6 07:09:34 2020(r368376) +++ stable/12/usr.sbin/bsnmpd/modules/snmp_wlan/snmp_wlan.3 Sun Dec 6 07:22:38 2020(r368377) @@ -41,8 +41,8 @@ The .Nm snmp_wlan module implements a private BEGEMOT-WIRELESS-MIB, which allows -management of virtual wireless interfaces. The MIB defines objects similar to the -state data and configuration capabilities of +management of virtual wireless interfaces. +The MIB defines objects similar to the state data and configuration capabilities of .Xr ifconfig 8 for configuring virtual wireless interfaces. Therefore one should consider adding write communities or loading the @@ -52,15 +52,15 @@ module on systems where security is crucial. A short description of the Tables and interesting objects in the MIB follows. .Bl -tag -width "X" .It Va wlanInterfaceTable -The table is used for creation and deletion of virtual wireless interfaces. To -add a new interface, a SET should be executed on the +The table is used for creation and deletion of virtual wireless interfaces. +To add a new interface, a SET should be executed on the .Va wlanIfaceName column with -value the desired name of the interface. Next the parent interface must be set -via +value the desired name of the interface. +Next the parent interface must be set via .Va wlanParentIfName -column. Any optional parameters may be set -via the +column. +Any optional parameters may be set via the .Va wlanIfaceOperatingMode , .Va wlanIfaceFlags , .Va wlanIfaceBssid @@ -78,9 +78,9 @@ The table contains information about the hardware capa a wireless interface. .It Va wlanIfaceConfigTable The table is used to get or set various configuration parameters for a virtual -wireless interface. Depending on the operating mode of the interface and the -hardware capabilities of the underlying hardware interface, not all parameters -and values may be supported. +wireless interface. +Depending on the operating mode of the interface and the hardware capabilities +of the underlying hardware interface, not all parameters and values may be supported. .It Va wlanIfacePeerTable The table contains information about the associated stations for interfaces operating as access points, or the stations identified as neighbors in the IBSS @@ -106,8 +106,9 @@ Access Control configuration for wireless interfaces o The table with Access Control MAC entries for which the configured Access Control Policy on wireless interfaces operating in Host AP mode is applied. .Va wlanMACAccessControlMACStatus -column is used to add or delete MAC ACL entries. A set with value createAndGo(4) -will add new entry, while with value destroy(6) will delete an existing one. +column is used to add or delete MAC ACL entries. +A set with value createAndGo(4) will add new entry, while with value destroy(6) +will delete an existing one. .It Va wlanMeshRoutingConfig The subtree contains system configuration related to Wireless Mesh Routing. .It Va wlanMeshInterfaceTable @@ -121,8 +122,9 @@ The mesh routing table for interfaces operating as mes forwarding packets on a mesh network. .Va wlanMeshRouteStatus column is used to add or delete entries in the mesh routing table for an -interface. A set with value createAndGo(4) will add new entry, while with value -destroy(6) will delete an existing one. +interface. +A set with value createAndGo(4) will add new entry, while with value destroy(6) +will delete an existing one. .It Va wlanMeshStatsTable Summary statistics for each virtual wireless interface operating as mesh point. .It Va wlanMeshHWMPConfig ___
svn commit: r368376 - in stable/12/usr.sbin: crashinfo moused syslogd
Author: gbe (doc committer) Date: Sun Dec 6 07:09:34 2020 New Revision: 368376 URL: https://svnweb.freebsd.org/changeset/base/368376 Log: MFC r367900, r367902, r367903 r367900: syslog.conf(5): Fix a few mandoc warnings - new sentence, new line - skipping paragraph macro: Pp at the end of Sh r367902: crashinfo(8): Fix a few mandoc warnings - new sentence, new line r367903: moused(8): Fix a few mandoc warnings - new sentence, new line Modified: stable/12/usr.sbin/crashinfo/crashinfo.8 stable/12/usr.sbin/moused/moused.8 stable/12/usr.sbin/syslogd/syslog.conf.5 Directory Properties: stable/12/ (props changed) Modified: stable/12/usr.sbin/crashinfo/crashinfo.8 == --- stable/12/usr.sbin/crashinfo/crashinfo.8Sun Dec 6 04:59:24 2020 (r368375) +++ stable/12/usr.sbin/crashinfo/crashinfo.8Sun Dec 6 07:09:34 2020 (r368376) @@ -89,9 +89,11 @@ and The options are as follows: .Bl -tag -width indent .It Fl b -Run in batch mode. Write most messages to the +Run in batch mode. +Write most messages to the .Pa core.txt.XX -file instead of the terminal. This flag is used when +file instead of the terminal. +This flag is used when .Nm is run during boot. .It Fl d Ar crashdir Modified: stable/12/usr.sbin/moused/moused.8 == --- stable/12/usr.sbin/moused/moused.8 Sun Dec 6 04:59:24 2020 (r368375) +++ stable/12/usr.sbin/moused/moused.8 Sun Dec 6 07:09:34 2020 (r368376) @@ -147,7 +147,8 @@ is enabled, the option can be used to set the .Ar distance (in pixels) that the mouse must move before a scroll event -is generated. This effectively controls the scrolling speed. +is generated. +This effectively controls the scrolling speed. The default .Ar distance is 2 pixels. @@ -240,20 +241,21 @@ drive the pointer quickly across the screen. The .Ar exp value specifies the exponent, which is basically -the amount of acceleration. Useful values are in the -range 1.1 to 2.0, but it depends on your mouse hardware -and your personal preference. A value of 1.0 means no -exponential acceleration. A value of 2.0 means squared -acceleration (i.e. if you move the mouse twice as fast, -the pointer will move four times as fast on the screen). +the amount of acceleration. +Useful values are in the range 1.1 to 2.0, but it depends on +your mouse hardware and your personal preference. +A value of 1.0 means no exponential acceleration. +A value of 2.0 means squared acceleration (i.e. if +you move the mouse twice as fast, the pointer will move +four times as fast on the screen). Values beyond 2.0 are possible but not recommended. A good value to start is probably 1.5. .Pp The optional .Ar offset -value specifies the distance at which the acceleration -begins. The default is 1.0, which means that the -acceleration is applied to movements larger than one unit. +value specifies the distance at which the acceleration begins. +The default is 1.0, which means that the acceleration is applied +to movements larger than one unit. If you specify a larger value, it takes more speed for the acceleration to kick in, i.e. the speed range for small and accurate movements is wider. @@ -263,8 +265,8 @@ not satisfied with the behaviour, try a value of 2.0. Note that the .Fl A option interacts badly with the X server's own acceleration, -which doesn't work very well anyway. Therefore it is -recommended to switch it off if necessary: +which doesn't work very well anyway. +Therefore it is recommended to switch it off if necessary: .Dq xset m 1 . .It Fl a Ar X Ns Op , Ns Ar Y Accelerate or decelerate the mouse input. Modified: stable/12/usr.sbin/syslogd/syslog.conf.5 == --- stable/12/usr.sbin/syslogd/syslog.conf.5Sun Dec 6 04:59:24 2020 (r368375) +++ stable/12/usr.sbin/syslogd/syslog.conf.5Sun Dec 6 07:09:34 2020 (r368376) @@ -245,7 +245,8 @@ specification is a line beginning with or .Ql \&: and the following blocks will be applied only when filter value -matches given filter propertie's value. See +matches given filter propertie's value. +See .Sx PROPERTY-BASED FILTERS section for more details. .Pp @@ -464,8 +465,8 @@ or .Ql \&: followed by three comma-separated fields .Em property , operator , \&"value\&" . -Value must be double-quoted. A double quote and backslash must be escaped by -a backslash. +Value must be double-quoted. +A double quote and backslash must be escaped by a backslash. .Pp Following .Em properties @@ -521,7 +522,6 @@ Operator may be prefixed by .Ql icase_ - to make comparison function case insensitive .El -.Pp .Sh IMPLEMENTATION NOTES The .Dq kern ___ svn-src-all@freebsd.org mailing list https://lists.freebsd.org/mailman/listinf
svn commit: r368368 - head/share/man/man9
Author: gbe (doc committer) Date: Sat Dec 5 11:18:37 2020 New Revision: 368368 URL: https://svnweb.freebsd.org/changeset/base/368368 Log: epoch(9): Fix a few mandoc related issues - sections out of conventional order: Sh EXAMPLES - sections out of conventional order: Sh SEE ALSO - skipping end of block that is not open: El Modified: head/share/man/man9/epoch.9 Modified: head/share/man/man9/epoch.9 == --- head/share/man/man9/epoch.9 Sat Dec 5 11:17:54 2020(r368367) +++ head/share/man/man9/epoch.9 Sat Dec 5 11:18:37 2020(r368368) @@ -210,20 +210,6 @@ This function can sleep and is not optimized for perfo .Sh RETURN VALUES .Fn in_epoch curepoch will return 1 if curthread is in curepoch, 0 otherwise. -.Sh CAVEATS -One must be cautious when using -.Fn epoch_wait_preempt . -Threads are pinned during epoch sections, so if a thread in a section is then -preempted by a higher priority compute bound thread on that CPU, it can be -prevented from leaving the section indefinitely. -.Pp -Epochs are not a straight replacement for read locks. -Callers must use safe list and tailq traversal routines in an epoch (see ck_queue). -When modifying a list referenced from an epoch section safe removal -routines must be used and the caller can no longer modify a list entry -in place. -An item to be modified must be handled with copy on write -and frees must be deferred until after a grace period has elapsed. .Sh EXAMPLES Async free example: Thread 1: @@ -280,12 +266,6 @@ free would have to follow a call to The .Nm kernel programming interface is under development and is subject to change. -.El -.Sh HISTORY -The -.Nm -framework first appeared in -.Fx 11.0 . .Sh SEE ALSO .Xr locking 9 , .Xr mtx_pool 9 , @@ -295,3 +275,22 @@ framework first appeared in .Xr sleep 9 , .Xr sx 9 , .Xr timeout 9 +.Sh HISTORY +The +.Nm +framework first appeared in +.Fx 11.0 . +.Sh CAVEATS +One must be cautious when using +.Fn epoch_wait_preempt . +Threads are pinned during epoch sections, so if a thread in a section is then +preempted by a higher priority compute bound thread on that CPU, it can be +prevented from leaving the section indefinitely. +.Pp +Epochs are not a straight replacement for read locks. +Callers must use safe list and tailq traversal routines in an epoch (see ck_queue). +When modifying a list referenced from an epoch section safe removal +routines must be used and the caller can no longer modify a list entry +in place. +An item to be modified must be handled with copy on write +and frees must be deferred until after a grace period has elapsed. ___ svn-src-all@freebsd.org mailing list https://lists.freebsd.org/mailman/listinfo/svn-src-all To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"
svn commit: r368348 - head/sbin/ping
Author: gbe (doc committer) Date: Fri Dec 4 20:47:56 2020 New Revision: 368348 URL: https://svnweb.freebsd.org/changeset/base/368348 Log: ping(8): Fix a few mandoc related issues - new sentence, new line Modified: head/sbin/ping/ping.8 Modified: head/sbin/ping/ping.8 == --- head/sbin/ping/ping.8 Fri Dec 4 20:14:25 2020(r368347) +++ head/sbin/ping/ping.8 Fri Dec 4 20:47:56 2020(r368348) @@ -131,12 +131,11 @@ datagrams have an IPv6 header and .Tn ICMPv6 header formatted as documented in RFC 2463. .Pp -When invoked with a hostname, the version to which the target is -resolved first is used. In that case, the options and arguments used -must be valid for the specific IP version, otherwise +When invoked with a hostname, the version to which the target is resolved first is used. +In that case, the options and arguments used must be valid for the specific IP version, otherwise .Nm -exits with an error. If the target is resolved to both IPv4 and IPv6, -the specific IP version can be requested by +exits with an error. +If the target is resolved to both IPv4 and IPv6, the specific IP version can be requested by .Fl 4 or .Fl 6 @@ -210,15 +209,14 @@ option. .It Fl I Ar iface For an IPv4 target, .Ar iface -is an IP address indentifying an interface from which the packets will -be sent. This flag applies only if the ping target is a multicast -address. +is an IP address indentifying an interface from which the packets will be sent. +This flag applies only if the ping target is a multicast address. .Pp For an IPv6 target, .Ar iface -is a name of an interface (e.g. `em0') from which the packets will be -sent. This flag applies if the ping target is a multicast address, or -link-local/site-local unicast address. +is a name of an interface (e.g. `em0') from which the packets will be sent. +This flag applies if the ping target is a multicast address, or link-local/site-local +unicast address. .It Fl i Ar wait Wait .Ar wait ___ svn-src-all@freebsd.org mailing list https://lists.freebsd.org/mailman/listinfo/svn-src-all To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"
svn commit: r367904 - head/usr.sbin/wpa/hostapd
Author: gbe (doc committer) Date: Fri Nov 20 17:13:13 2020 New Revision: 367904 URL: https://svnweb.freebsd.org/changeset/base/367904 Log: hostapd.conf(5): Add missing 'l' In r367901 I accidentally deleted the 'l' while fixing a few mandoc erros. Spotted by: Yuri Pankov Modified: head/usr.sbin/wpa/hostapd/hostapd.conf.5 Modified: head/usr.sbin/wpa/hostapd/hostapd.conf.5 == --- head/usr.sbin/wpa/hostapd/hostapd.conf.5Fri Nov 20 17:04:49 2020 (r367903) +++ head/usr.sbin/wpa/hostapd/hostapd.conf.5Fri Nov 20 17:13:13 2020 (r367904) @@ -68,7 +68,7 @@ Interface name. Should be set in .Dq hostap mode. -Make certain that there are no spaces after the interface name, or hostapd wil +Make certain that there are no spaces after the interface name, or hostapd will complain that the interface does not exist. .It Va debug Debugging mode: 0 = no, 1 = minimal, 2 = verbose, 3 = msg dumps, 4 = ___ svn-src-all@freebsd.org mailing list https://lists.freebsd.org/mailman/listinfo/svn-src-all To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"
svn commit: r367903 - head/usr.sbin/moused
Author: gbe (doc committer) Date: Fri Nov 20 17:04:49 2020 New Revision: 367903 URL: https://svnweb.freebsd.org/changeset/base/367903 Log: moused(8): Fix a few mandoc warnings - new sentence, new line Modified: head/usr.sbin/moused/moused.8 Modified: head/usr.sbin/moused/moused.8 == --- head/usr.sbin/moused/moused.8 Fri Nov 20 16:59:51 2020 (r367902) +++ head/usr.sbin/moused/moused.8 Fri Nov 20 17:04:49 2020 (r367903) @@ -147,7 +147,8 @@ is enabled, the option can be used to set the .Ar distance (in pixels) that the mouse must move before a scroll event -is generated. This effectively controls the scrolling speed. +is generated. +This effectively controls the scrolling speed. The default .Ar distance is 2 pixels. @@ -240,20 +241,21 @@ drive the pointer quickly across the screen. The .Ar exp value specifies the exponent, which is basically -the amount of acceleration. Useful values are in the -range 1.1 to 2.0, but it depends on your mouse hardware -and your personal preference. A value of 1.0 means no -exponential acceleration. A value of 2.0 means squared -acceleration (i.e. if you move the mouse twice as fast, -the pointer will move four times as fast on the screen). +the amount of acceleration. +Useful values are in the range 1.1 to 2.0, but it depends on +your mouse hardware and your personal preference. +A value of 1.0 means no exponential acceleration. +A value of 2.0 means squared acceleration (i.e. if +you move the mouse twice as fast, the pointer will move +four times as fast on the screen). Values beyond 2.0 are possible but not recommended. A good value to start is probably 1.5. .Pp The optional .Ar offset -value specifies the distance at which the acceleration -begins. The default is 1.0, which means that the -acceleration is applied to movements larger than one unit. +value specifies the distance at which the acceleration begins. +The default is 1.0, which means that the acceleration is applied +to movements larger than one unit. If you specify a larger value, it takes more speed for the acceleration to kick in, i.e. the speed range for small and accurate movements is wider. @@ -263,8 +265,8 @@ not satisfied with the behaviour, try a value of 2.0. Note that the .Fl A option interacts badly with the X server's own acceleration, -which doesn't work very well anyway. Therefore it is -recommended to switch it off if necessary: +which doesn't work very well anyway. +Therefore it is recommended to switch it off if necessary: .Dq xset m 1 . .It Fl a Ar X Ns Op , Ns Ar Y Accelerate or decelerate the mouse input. ___ svn-src-all@freebsd.org mailing list https://lists.freebsd.org/mailman/listinfo/svn-src-all To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"
svn commit: r367902 - head/usr.sbin/crashinfo
Author: gbe (doc committer) Date: Fri Nov 20 16:59:51 2020 New Revision: 367902 URL: https://svnweb.freebsd.org/changeset/base/367902 Log: crashinfo(8): Fix a few mandoc warnings - new sentence, new line Modified: head/usr.sbin/crashinfo/crashinfo.8 Modified: head/usr.sbin/crashinfo/crashinfo.8 == --- head/usr.sbin/crashinfo/crashinfo.8 Fri Nov 20 16:57:06 2020 (r367901) +++ head/usr.sbin/crashinfo/crashinfo.8 Fri Nov 20 16:59:51 2020 (r367902) @@ -89,9 +89,11 @@ and The options are as follows: .Bl -tag -width indent .It Fl b -Run in batch mode. Write most messages to the +Run in batch mode. +Write most messages to the .Pa core.txt.XX -file instead of the terminal. This flag is used when +file instead of the terminal. +This flag is used when .Nm is run during boot. .It Fl d Ar crashdir ___ svn-src-all@freebsd.org mailing list https://lists.freebsd.org/mailman/listinfo/svn-src-all To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"
svn commit: r367901 - head/usr.sbin/wpa/hostapd
Author: gbe (doc committer) Date: Fri Nov 20 16:57:06 2020 New Revision: 367901 URL: https://svnweb.freebsd.org/changeset/base/367901 Log: hostapd.conf(5): Fix a mandoc warning - new sentence, new line Modified: head/usr.sbin/wpa/hostapd/hostapd.conf.5 Modified: head/usr.sbin/wpa/hostapd/hostapd.conf.5 == --- head/usr.sbin/wpa/hostapd/hostapd.conf.5Fri Nov 20 16:50:52 2020 (r367900) +++ head/usr.sbin/wpa/hostapd/hostapd.conf.5Fri Nov 20 16:57:06 2020 (r367901) @@ -67,8 +67,9 @@ The following parameters are recognized: Interface name. Should be set in .Dq hostap -mode. Make certain that there are no spaces after the interface name, -or hostapd will complain that the interface does not exist. +mode. +Make certain that there are no spaces after the interface name, or hostapd wil +complain that the interface does not exist. .It Va debug Debugging mode: 0 = no, 1 = minimal, 2 = verbose, 3 = msg dumps, 4 = excessive. ___ svn-src-all@freebsd.org mailing list https://lists.freebsd.org/mailman/listinfo/svn-src-all To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"
svn commit: r367900 - head/usr.sbin/syslogd
Author: gbe (doc committer) Date: Fri Nov 20 16:50:52 2020 New Revision: 367900 URL: https://svnweb.freebsd.org/changeset/base/367900 Log: syslog.conf(5): Fix a few mandoc warnings - new sentence, new line - skipping paragraph macro: Pp at the end of Sh Modified: head/usr.sbin/syslogd/syslog.conf.5 Modified: head/usr.sbin/syslogd/syslog.conf.5 == --- head/usr.sbin/syslogd/syslog.conf.5 Fri Nov 20 16:46:51 2020 (r367899) +++ head/usr.sbin/syslogd/syslog.conf.5 Fri Nov 20 16:50:52 2020 (r367900) @@ -245,7 +245,8 @@ specification is a line beginning with or .Ql \&: and the following blocks will be applied only when filter value -matches given filter propertie's value. See +matches given filter propertie's value. +See .Sx PROPERTY-BASED FILTERS section for more details. .Pp @@ -464,8 +465,8 @@ or .Ql \&: followed by three comma-separated fields .Em property , operator , \&"value\&" . -Value must be double-quoted. A double quote and backslash must be escaped by -a backslash. +Value must be double-quoted. +A double quote and backslash must be escaped by a backslash. .Pp Following .Em properties @@ -521,7 +522,6 @@ Operator may be prefixed by .Ql icase_ - to make comparison function case insensitive .El -.Pp .Sh IMPLEMENTATION NOTES The .Dq kern ___ svn-src-all@freebsd.org mailing list https://lists.freebsd.org/mailman/listinfo/svn-src-all To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"
svn commit: r367899 - head/usr.sbin/bsnmpd/modules/snmp_wlan
Author: gbe (doc committer) Date: Fri Nov 20 16:46:51 2020 New Revision: 367899 URL: https://svnweb.freebsd.org/changeset/base/367899 Log: snmp_wlan(3): Fix mandoc warnings - new sentence, new line Modified: head/usr.sbin/bsnmpd/modules/snmp_wlan/snmp_wlan.3 Modified: head/usr.sbin/bsnmpd/modules/snmp_wlan/snmp_wlan.3 == --- head/usr.sbin/bsnmpd/modules/snmp_wlan/snmp_wlan.3 Fri Nov 20 16:41:32 2020(r367898) +++ head/usr.sbin/bsnmpd/modules/snmp_wlan/snmp_wlan.3 Fri Nov 20 16:46:51 2020(r367899) @@ -41,8 +41,8 @@ The .Nm snmp_wlan module implements a private BEGEMOT-WIRELESS-MIB, which allows -management of virtual wireless interfaces. The MIB defines objects similar to the -state data and configuration capabilities of +management of virtual wireless interfaces. +The MIB defines objects similar to the state data and configuration capabilities of .Xr ifconfig 8 for configuring virtual wireless interfaces. Therefore one should consider adding write communities or loading the @@ -52,15 +52,15 @@ module on systems where security is crucial. A short description of the Tables and interesting objects in the MIB follows. .Bl -tag -width "X" .It Va wlanInterfaceTable -The table is used for creation and deletion of virtual wireless interfaces. To -add a new interface, a SET should be executed on the +The table is used for creation and deletion of virtual wireless interfaces. +To add a new interface, a SET should be executed on the .Va wlanIfaceName column with -value the desired name of the interface. Next the parent interface must be set -via +value the desired name of the interface. +Next the parent interface must be set via .Va wlanParentIfName -column. Any optional parameters may be set -via the +column. +Any optional parameters may be set via the .Va wlanIfaceOperatingMode , .Va wlanIfaceFlags , .Va wlanIfaceBssid @@ -78,9 +78,9 @@ The table contains information about the hardware capa a wireless interface. .It Va wlanIfaceConfigTable The table is used to get or set various configuration parameters for a virtual -wireless interface. Depending on the operating mode of the interface and the -hardware capabilities of the underlying hardware interface, not all parameters -and values may be supported. +wireless interface. +Depending on the operating mode of the interface and the hardware capabilities +of the underlying hardware interface, not all parameters and values may be supported. .It Va wlanIfacePeerTable The table contains information about the associated stations for interfaces operating as access points, or the stations identified as neighbors in the IBSS @@ -106,8 +106,9 @@ Access Control configuration for wireless interfaces o The table with Access Control MAC entries for which the configured Access Control Policy on wireless interfaces operating in Host AP mode is applied. .Va wlanMACAccessControlMACStatus -column is used to add or delete MAC ACL entries. A set with value createAndGo(4) -will add new entry, while with value destroy(6) will delete an existing one. +column is used to add or delete MAC ACL entries. +A set with value createAndGo(4) will add new entry, while with value destroy(6) +will delete an existing one. .It Va wlanMeshRoutingConfig The subtree contains system configuration related to Wireless Mesh Routing. .It Va wlanMeshInterfaceTable @@ -121,8 +122,9 @@ The mesh routing table for interfaces operating as mes forwarding packets on a mesh network. .Va wlanMeshRouteStatus column is used to add or delete entries in the mesh routing table for an -interface. A set with value createAndGo(4) will add new entry, while with value -destroy(6) will delete an existing one. +interface. +A set with value createAndGo(4) will add new entry, while with value destroy(6) +will delete an existing one. .It Va wlanMeshStatsTable Summary statistics for each virtual wireless interface operating as mesh point. .It Va wlanMeshHWMPConfig ___ svn-src-all@freebsd.org mailing list https://lists.freebsd.org/mailman/listinfo/svn-src-all To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"
svn commit: r367898 - head/usr.bin/iscsictl
Author: gbe (doc committer) Date: Fri Nov 20 16:41:32 2020 New Revision: 367898 URL: https://svnweb.freebsd.org/changeset/base/367898 Log: iscsi.conf(5): Fix a mandoc warning - new sentence, new line Modified: head/usr.bin/iscsictl/iscsi.conf.5 Modified: head/usr.bin/iscsictl/iscsi.conf.5 == --- head/usr.bin/iscsictl/iscsi.conf.5 Fri Nov 20 16:34:01 2020 (r367897) +++ head/usr.bin/iscsictl/iscsi.conf.5 Fri Nov 20 16:41:32 2020 (r367898) @@ -146,9 +146,9 @@ for iSCSI over RDMA, or Default is .Qq Ar iSCSI . .It Cm dscp -The DiffServ Codepoint used for sending data. The DSCP can be -set to numeric, or hexadecimal values directly, as well as the -well-defined +The DiffServ Codepoint used for sending data. +The DSCP can be set to numeric, or hexadecimal values directly, +as well as the well-defined .Qq Ar cs and .Qq Ar af ___ svn-src-all@freebsd.org mailing list https://lists.freebsd.org/mailman/listinfo/svn-src-all To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"
svn commit: r367897 - head/sbin/devmatch
Author: gbe (doc committer) Date: Fri Nov 20 16:34:01 2020 New Revision: 367897 URL: https://svnweb.freebsd.org/changeset/base/367897 Log: devmatch(8): Fix section ordering - sections out of conventional order: Sh HISTORY Modified: head/sbin/devmatch/devmatch.8 Modified: head/sbin/devmatch/devmatch.8 == --- head/sbin/devmatch/devmatch.8 Fri Nov 20 15:21:10 2020 (r367896) +++ head/sbin/devmatch/devmatch.8 Fri Nov 20 16:34:01 2020 (r367897) @@ -69,6 +69,10 @@ Produce more verbose output. .Sh SEE ALSO .Xr devinfo 8 , .Xr MODULE_PNP_INFO 9 +.Sh HISTORY +.Nm +first appeared in +.Fx 12.0 . .Sh AUTHORS .An Warner Losh Aq Mt i...@freebsd.org .Sh BUGS @@ -94,7 +98,3 @@ logical equivalent in USB, PCI, and others. .Pp Many drivers currently lack proper PNP table decorations and need to be updated. -.Sh HISTORY -.Nm -first appeared in -.Fx 12.0 . ___ svn-src-all@freebsd.org mailing list https://lists.freebsd.org/mailman/listinfo/svn-src-all To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"
svn commit: r367889 - head/sbin/camcontrol
Author: gbe (doc committer) Date: Fri Nov 20 11:45:08 2020 New Revision: 367889 URL: https://svnweb.freebsd.org/changeset/base/367889 Log: camcontrol(8): Fix some warnings spotted by mandoc - skipping paragraph macro: Pp before Bl Modified: head/sbin/camcontrol/camcontrol.8 Modified: head/sbin/camcontrol/camcontrol.8 == --- head/sbin/camcontrol/camcontrol.8 Fri Nov 20 11:31:25 2020 (r367888) +++ head/sbin/camcontrol/camcontrol.8 Fri Nov 20 11:45:08 2020 (r367889) @@ -2276,7 +2276,6 @@ These zones must be written sequentially. If they are not written sequentially, starting at the write pointer, the command will fail. .El -.Pp .Bl -tag -width 12n .It Fl c Ar cmd Specify the zone subcommand: @@ -2831,7 +2830,6 @@ This will read and decode the attribute values from pa in tape drive sa0, and will display any .Tn SCSI errors that result. -.Pp .Bd -literal -offset indent camcontrol zone da0 -v -c rz -P summary .Ed @@ -2842,7 +2840,6 @@ summary of the zone parameters, and display any or .Tn ATA errors that result. -.Pp .Bd -literal -offset indent camcontrol zone da0 -v -c rz -o reset .Ed @@ -2853,7 +2850,6 @@ pointer reset from the disk da0, and display any or .Tn ATA errors that result. -.Pp .Bd -literal -offset indent camcontrol zone da0 -v -c rwp -l 0x2c8 .Ed @@ -2864,7 +2860,6 @@ that starts at LBA 0x2c8 and display any or .Tn ATA errors that result. -.Pp .Bd -literal -offset indent camcontrol epc ada0 -c timer -T 60.1 -p Idle_a -e -s .Ed @@ -2873,7 +2868,6 @@ Set the timer for the Idle_a power condition on drive .Pa ada0 to 60.1 seconds, enable that particular power condition, and save the timer value and the enabled state of the power condition. -.Pp .Bd -literal -offset indent camcontrol epc da4 -c goto -p Standby_z -H .Ed @@ -2885,7 +2879,6 @@ the drive's lowest power state) and hold in that state explicitly released by another .Cm goto command. -.Pp .Bd -literal -offset indent camcontrol epc da2 -c status -P .Ed @@ -2903,7 +2896,6 @@ to only send the .Tn ATA CHECK POWER MODE command, which should not trigger a change in the drive's power state. -.Pp .Bd -literal -offset indent camcontrol epc ada0 -c list .Ed @@ -2911,7 +2903,6 @@ camcontrol epc ada0 -c list Display the ATA Power Conditions log (Log Address 0x08) for drive .Pa ada0 . -.Pp .Bd -literal -offset indent camcontrol timestamp sa0 -s -f "%a, %d %b %Y %T %z" \e -T "Wed, 26 Oct 2016 21:43:57 -0600" ___ svn-src-all@freebsd.org mailing list https://lists.freebsd.org/mailman/listinfo/svn-src-all To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"
Re: svn commit: r367686 - head/lib/libutil
Hi Scott, after r367689 the build was fixed, but on arm64 I get the following error, when I try to 'pkg upgrade': $ doas pkg upgrade Cannot determine local path $ Is this error somehow related to this change? --Gordon On Sat, Nov 14, 2020 at 11:44:29AM -0700, Scott Long wrote: > Hi, > > Yeah, I’m working on a fix, sorry. I made a last minute change that I > thought I > had tested, but apparently hadn’t. > > Scott > > > > On Nov 14, 2020, at 11:43 AM, Gordon Bergling wrote: > > > > Hi Scott, > > > > this somehow breaks the build. > > > > - > > ===> lib/msun (obj,all,install) > > /tank/nfs_public/tiny/src/lib/libutil/getlocalbase.c:69:30: error: > > comparison of integers of different signs: 'size_t' (aka 'unsigned long') > > and 'ssize_t' (aka 'long') [-Werror,-Wsign-compare] > >if ((tmplen < 0) || (tmplen >= (ssize_t)pathlen)) { > > ~~ ^ > > 1 error generated. > > --- getlocalbase.o --- > > *** [getlocalbase.o] Error code 1 > > . > > > > Got this on arm64 with the following src.conf: > > > > WITH_MALLOC_PRODUCTION=1 > > WITH_EXTRA_TCP_STACKS=1 > > WITH_BEARSSL=1 > > WITH_PIE=1 > > WITH_RETPOLINE=1 > > > > --Gordon > > > > On Sat, Nov 14, 2020 at 05:57:50PM +, Scott Long wrote: > >> Author: scottl > >> Date: Sat Nov 14 17:57:50 2020 > >> New Revision: 367686 > >> URL: https://svnweb.freebsd.org/changeset/base/367686 > >> > >> Log: > >> Add the library function getlocalbase and its manual page. This helps to > >> unify the retrieval of the various ways that the local software base > >> directory, > >> typically "/usr/local", is expressed in the system. > >> > >> Reviewed by: se > >> Differential Revision:https://reviews.freebsd.org/D27022 > >> > >> Added: > >> head/lib/libutil/getlocalbase.3 (contents, props changed) > >> head/lib/libutil/getlocalbase.c (contents, props changed) > >> Modified: > >> head/lib/libutil/Makefile > >> head/lib/libutil/libutil.h > >> > >> Modified: head/lib/libutil/Makefile > >> == > >> --- head/lib/libutil/Makefile Sat Nov 14 15:44:28 2020 > >> (r367685) > >> +++ head/lib/libutil/Makefile Sat Nov 14 17:57:50 2020 > >> (r367686) > >> @@ -12,7 +12,8 @@ PACKAGE= runtime > >> LIB= util > >> SHLIB_MAJOR= 9 > >> > >> -SRCS= _secure_path.c auth.c expand_number.c flopen.c fparseln.c > >> gr_util.c \ > >> +SRCS= _secure_path.c auth.c expand_number.c flopen.c fparseln.c \ > >> + getlocalbase.c gr_util.c \ > >>hexdump.c humanize_number.c kinfo_getfile.c \ > >>kinfo_getallproc.c kinfo_getproc.c kinfo_getvmmap.c \ > >>kinfo_getvmobject.c kld.c \ > >> @@ -30,7 +31,7 @@ CFLAGS+= -DINET6 > >> > >> CFLAGS+= -I${.CURDIR} -I${SRCTOP}/lib/libc/gen/ > >> > >> -MAN+= expand_number.3 flopen.3 fparseln.3 hexdump.3 \ > >> +MAN+= expand_number.3 flopen.3 fparseln.3 getlocalbase.3 hexdump.3 \ > >>humanize_number.3 kinfo_getallproc.3 kinfo_getfile.3 \ > >>kinfo_getproc.3 kinfo_getvmmap.3 kinfo_getvmobject.3 kld.3 \ > >>login_auth.3 login_cap.3 \ > >> > >> Added: head/lib/libutil/getlocalbase.3 > >> == > >> --- /dev/null 00:00:00 1970 (empty, because file is newly added) > >> +++ head/lib/libutil/getlocalbase.3Sat Nov 14 17:57:50 2020 > >> (r367686) > >> @@ -0,0 +1,110 @@ > >> +.\" > >> +.\" SPDX-License-Identifier: BSD-2-Clause-FreeBSD > >> +.\" > >> +.\" Copyright 2020 Scott Long > >> +.\" > >> +.\" Redistribution and use in source and binary forms, with or without > >> +.\" modification, are permitted provided that the following conditions > >> +.\" are met: > >> +.\" 1. Redistributions of source code must retain the above copyright > >> +.\"notice, this list of conditions and the following disclaimer. > >> +.\" 2. R
Re: svn commit: r367686 - head/lib/libutil
Hi Scott, this somehow breaks the build. - ===> lib/msun (obj,all,install) /tank/nfs_public/tiny/src/lib/libutil/getlocalbase.c:69:30: error: comparison of integers of different signs: 'size_t' (aka 'unsigned long') and 'ssize_t' (aka 'long') [-Werror,-Wsign-compare] if ((tmplen < 0) || (tmplen >= (ssize_t)pathlen)) { ~~ ^ 1 error generated. --- getlocalbase.o --- *** [getlocalbase.o] Error code 1 . Got this on arm64 with the following src.conf: WITH_MALLOC_PRODUCTION=1 WITH_EXTRA_TCP_STACKS=1 WITH_BEARSSL=1 WITH_PIE=1 WITH_RETPOLINE=1 --Gordon On Sat, Nov 14, 2020 at 05:57:50PM +, Scott Long wrote: > Author: scottl > Date: Sat Nov 14 17:57:50 2020 > New Revision: 367686 > URL: https://svnweb.freebsd.org/changeset/base/367686 > > Log: > Add the library function getlocalbase and its manual page. This helps to > unify the retrieval of the various ways that the local software base > directory, > typically "/usr/local", is expressed in the system. > > Reviewed by:se > Differential Revision: https://reviews.freebsd.org/D27022 > > Added: > head/lib/libutil/getlocalbase.3 (contents, props changed) > head/lib/libutil/getlocalbase.c (contents, props changed) > Modified: > head/lib/libutil/Makefile > head/lib/libutil/libutil.h > > Modified: head/lib/libutil/Makefile > == > --- head/lib/libutil/Makefile Sat Nov 14 15:44:28 2020(r367685) > +++ head/lib/libutil/Makefile Sat Nov 14 17:57:50 2020(r367686) > @@ -12,7 +12,8 @@ PACKAGE=runtime > LIB= util > SHLIB_MAJOR= 9 > > -SRCS=_secure_path.c auth.c expand_number.c flopen.c fparseln.c > gr_util.c \ > +SRCS=_secure_path.c auth.c expand_number.c flopen.c fparseln.c \ > + getlocalbase.c gr_util.c \ > hexdump.c humanize_number.c kinfo_getfile.c \ > kinfo_getallproc.c kinfo_getproc.c kinfo_getvmmap.c \ > kinfo_getvmobject.c kld.c \ > @@ -30,7 +31,7 @@ CFLAGS+= -DINET6 > > CFLAGS+= -I${.CURDIR} -I${SRCTOP}/lib/libc/gen/ > > -MAN+=expand_number.3 flopen.3 fparseln.3 hexdump.3 \ > +MAN+=expand_number.3 flopen.3 fparseln.3 getlocalbase.3 hexdump.3 \ > humanize_number.3 kinfo_getallproc.3 kinfo_getfile.3 \ > kinfo_getproc.3 kinfo_getvmmap.3 kinfo_getvmobject.3 kld.3 \ > login_auth.3 login_cap.3 \ > > Added: head/lib/libutil/getlocalbase.3 > == > --- /dev/null 00:00:00 1970 (empty, because file is newly added) > +++ head/lib/libutil/getlocalbase.3 Sat Nov 14 17:57:50 2020 > (r367686) > @@ -0,0 +1,110 @@ > +.\" > +.\" SPDX-License-Identifier: BSD-2-Clause-FreeBSD > +.\" > +.\" Copyright 2020 Scott Long > +.\" > +.\" Redistribution and use in source and binary forms, with or without > +.\" modification, are permitted provided that the following conditions > +.\" are met: > +.\" 1. Redistributions of source code must retain the above copyright > +.\"notice, this list of conditions and the following disclaimer. > +.\" 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 > +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE > +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR > CONSEQUENTIAL > +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS > +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) > +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, > 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 DAMAGE. > +.\" > +.\" $FreeBSD$ > +.\" > +.Dd Oct 28, 2020 > +.Dt GETLOCALBASE 3 > +.Os > +.Sh NAME > +.Nm getlocalbase > +.Nd "return the path to the local software directory" > +.Sh LIBRARY > +.Lb libutil > +.Sh SYNOPSIS > +.In libutil.h > +.Ft ssize_t > +.Fn getlocalbase "char *path" "size_t len" > +.Sh DESCRIPTION > +The > +.Fn getlocalbase > +function returns the path to the local software base directory. > +Normally this is the > +.Pa /usr/local > +directory. > +First the > +.Ev LOCALBASE > +environment variable is checked. > +If that doesn't exist then the > +.Va user.localbase > +sysctl is checked. > +If that also doesn't
svn commit: r367679 - stable/12/share/man/man4
Author: gbe (doc committer) Date: Sat Nov 14 14:15:49 2020 New Revision: 367679 URL: https://svnweb.freebsd.org/changeset/base/367679 Log: MFC r366580: bpf(4): Update the man page to reflect reality PR: 131918 Submitted by: guy at alum dot mit dot edu Reviewed by: gnn, gbe Approved by: gnn Differential Revision:https://reviews.freebsd.org/D25993 Modified: stable/12/share/man/man4/bpf.4 Directory Properties: stable/12/ (props changed) Modified: stable/12/share/man/man4/bpf.4 == --- stable/12/share/man/man4/bpf.4 Sat Nov 14 13:07:41 2020 (r367678) +++ stable/12/share/man/man4/bpf.4 Sat Nov 14 14:15:49 2020 (r367679) @@ -49,7 +49,7 @@ .\" .\" $FreeBSD$ .\" -.Dd October 21, 2016 +.Dd October 9, 2020 .Dt BPF 4 .Os .Sh NAME @@ -73,12 +73,6 @@ ioctl. A given interface can be shared by multiple listeners, and the filter underlying each descriptor will see an identical packet stream. .Pp -A separate device file is required for each minor device. -If a file is in use, the open will fail and -.Va errno -will be set to -.Er EBUSY . -.Pp Associated with each open instance of a .Nm file is a user-settable packet filter. @@ -86,19 +80,6 @@ Whenever a packet is received by an interface, all file descriptors listening on that interface apply their filter. Each descriptor that accepts the packet receives its own copy. .Pp -The packet filter will support any link level protocol that has fixed length -headers. -Currently, only Ethernet, -.Tn SLIP , -and -.Tn PPP -drivers have been modified to interact with -.Nm . -.Pp -Since packet data is in network byte order, applications should use the -.Xr byteorder 3 -macros to extract multi-byte values. -.Pp A packet can be sent out on the network by writing to a .Nm file descriptor. @@ -313,7 +294,7 @@ with If the requested buffer size cannot be accommodated, the closest allowable size will be set and returned in the argument. A read call will result in -.Er EIO +.Er EINVAL if it is passed a buffer that is not this size. .It Dv BIOCGDLT .Pq Li u_int @@ -324,6 +305,43 @@ The device types, prefixed with .Dq Li DLT_ , are defined in .In net/bpf.h . +.It Dv BIOCGDLTLIST +.Pq Li "struct bpf_dltlist" +Returns an array of the available types of the data link layer +underlying the attached interface: +.Bd -literal -offset indent +struct bpf_dltlist { + u_int bfl_len; + u_int *bfl_list; +}; +.Ed +.Pp +The available types are returned in the array pointed to by the +.Va bfl_list +field while their length in u_int is supplied to the +.Va bfl_len +field. +.Er ENOMEM +is returned if there is not enough buffer space and +.Er EFAULT +is returned if a bad address is encountered. +The +.Va bfl_len +field is modified on return to indicate the actual length in u_int +of the array returned. +If +.Va bfl_list +is +.Dv NULL , +the +.Va bfl_len +field is set to indicate the required length of an array in u_int. +.It Dv BIOCSDLT +.Pq Li u_int +Changes the type of the data link layer underlying the attached interface. +.Er EINVAL +is returned if no interface has been specified or the specified +type is not available for the interface. .It Dv BIOCPROMISC Forces the interface into promiscuous mode. All packets, not just those destined for the local host, are processed. @@ -331,6 +349,9 @@ Since more than one file can be listening on a given i a listener that opened its interface non-promiscuously may receive packets promiscuously. This problem can be remedied with an appropriate filter. +.Pp +The interface remains in promiscuous mode until all files listening +promiscuously are closed. .It Dv BIOCFLUSH Flushes the buffer of incoming packets, and resets the statistics that are returned by BIOCGSTATS. @@ -344,7 +365,7 @@ structure. All other fields are undefined. .It Dv BIOCSETIF .Pq Li "struct ifreq" -Sets the hardware interface associate with the file. +Sets the hardware interface associated with the file. This command must be performed before any packets can be read. The device is indicated by name using the @@ -357,7 +378,7 @@ Additionally, performs the actions of .It Dv BIOCSRTIMEOUT .It Dv BIOCGRTIMEOUT .Pq Li "struct timeval" -Set or get the read timeout parameter. +Sets or gets the read timeout parameter. The argument specifies the length of time to wait before timing out on a read request. @@ -387,7 +408,7 @@ kernel because of buffer overflows .El .It Dv BIOCIMMEDIATE .Pq Li u_int -Enable or disable +Enables or disables .Dq immediate mode , based on the truth value of the argument. When immediate mode is enabled, reads return immediately upon packet @@ -407,7 +428,7 @@ An array of instructions and its length is passed in u the following structure: .Bd -literal struct bpf_program { - int bf_len; + u_int bf_len; struct bpf_insn *bf_insns; }; .Ed @@ -469,10 +490,18 @@ An inc
Re: svn commit: r367321 - head/sys/amd64/linux
Shouldn't such a commit be approved by someone? And why you just abandoned the differential [1]? [1] https://reviews.freebsd.org/D25934 --Gordon On Wed, Nov 04, 2020 at 10:38:25AM +, Mateusz Piotrowski wrote: > Author: 0mp (doc,ports committer) > Date: Wed Nov 4 10:38:25 2020 > New Revision: 367321 > URL: https://svnweb.freebsd.org/changeset/base/367321 > > Log: > Fix a typo > > Modified: > head/sys/amd64/linux/linux_machdep.c > > Modified: head/sys/amd64/linux/linux_machdep.c > == > --- head/sys/amd64/linux/linux_machdep.c Wed Nov 4 10:21:30 2020 > (r367320) > +++ head/sys/amd64/linux/linux_machdep.c Wed Nov 4 10:38:25 2020 > (r367321) > @@ -126,7 +126,7 @@ linux_set_upcall_kse(struct thread *td, register_t sta > > /* >* The newly created Linux thread returns > - * to the user space by the same path that a parent do. > + * to the user space by the same path that a parent does. >*/ > td->td_frame->tf_rax = 0; > return (0); > ___ > svn-src-h...@freebsd.org mailing list > https://lists.freebsd.org/mailman/listinfo/svn-src-head > To unsubscribe, send any mail to "svn-src-head-unsubscr...@freebsd.org" -- ___ svn-src-all@freebsd.org mailing list https://lists.freebsd.org/mailman/listinfo/svn-src-all To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"
svn commit: r367202 - stable/12/share/man/man9
Author: gbe (doc committer) Date: Sat Oct 31 12:39:22 2020 New Revision: 367202 URL: https://svnweb.freebsd.org/changeset/base/367202 Log: MFC r366946: socket(9): Remove duplicate word 'is is' Modified: stable/12/share/man/man9/socket.9 Directory Properties: stable/12/ (props changed) Modified: stable/12/share/man/man9/socket.9 == --- stable/12/share/man/man9/socket.9 Sat Oct 31 12:37:26 2020 (r367201) +++ stable/12/share/man/man9/socket.9 Sat Oct 31 12:39:22 2020 (r367202) @@ -378,7 +378,7 @@ or A kernel system can use the .Fn sodtor_set function to set a destructor for a socket. -The destructor is called when the socket is is about to be freed. +The destructor is called when the socket is about to be freed. The destructor is called before the protocol detach routine. The destructor can serve as a callback to initiate additional cleanup actions. .Ss Socket I/O ___ svn-src-all@freebsd.org mailing list https://lists.freebsd.org/mailman/listinfo/svn-src-all To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"
svn commit: r367201 - in stable/12/share/man: man4 man5
Author: gbe (doc committer) Date: Sat Oct 31 12:37:26 2020 New Revision: 367201 URL: https://svnweb.freebsd.org/changeset/base/367201 Log: MFC r367091: Use my FreeBSD.org mail address in man pages I have written Modified: stable/12/share/man/man4/smbios.4 stable/12/share/man/man5/smbfs.5 stable/12/share/man/man5/unionfs.5 Directory Properties: stable/12/ (props changed) Modified: stable/12/share/man/man4/smbios.4 == --- stable/12/share/man/man4/smbios.4 Sat Oct 31 12:36:08 2020 (r367200) +++ stable/12/share/man/man4/smbios.4 Sat Oct 31 12:37:26 2020 (r367201) @@ -62,4 +62,4 @@ The device driver was written by .An Matthew N. Dodd Aq Mt win...@jurai.net . This manual page was written by -.An Gordon Bergling Aq Mt gbergl...@gmail.com . +.An Gordon Bergling Aq Mt g...@freebsd.org . Modified: stable/12/share/man/man5/smbfs.5 == --- stable/12/share/man/man5/smbfs.5Sat Oct 31 12:36:08 2020 (r367200) +++ stable/12/share/man/man5/smbfs.5Sat Oct 31 12:37:26 2020 (r367201) @@ -76,4 +76,4 @@ The device driver was written by .An Boris Popov Aq Mt b...@freebsd.org . The manual page was contributed by -.An Gordon Bergling Aq Mt gbergl...@gmail.com . +.An Gordon Bergling Aq Mt g...@freebsd.org . Modified: stable/12/share/man/man5/unionfs.5 == --- stable/12/share/man/man5/unionfs.5 Sat Oct 31 12:36:08 2020 (r367200) +++ stable/12/share/man/man5/unionfs.5 Sat Oct 31 12:37:26 2020 (r367201) @@ -78,7 +78,7 @@ and reimplemented the handling of the locking for .Fx 7.0 . The manual page was written by -.An Gordon Bergling Aq Mt gbergl...@gmail.com . +.An Gordon Bergling Aq Mt g...@freebsd.org . .Sh BUGS Please see the .Xr mount_unionfs 8 ___ svn-src-all@freebsd.org mailing list https://lists.freebsd.org/mailman/listinfo/svn-src-all To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"
svn commit: r367200 - stable/12/share/man/man5
Author: gbe (doc committer) Date: Sat Oct 31 12:36:08 2020 New Revision: 367200 URL: https://svnweb.freebsd.org/changeset/base/367200 Log: MFC r359731: Add a basic manpage for smbfs(5) Added: stable/12/share/man/man5/smbfs.5 - copied unchanged from r359731, head/share/man/man5/smbfs.5 Modified: stable/12/share/man/man5/Makefile Directory Properties: stable/12/ (props changed) Modified: stable/12/share/man/man5/Makefile == --- stable/12/share/man/man5/Makefile Sat Oct 31 12:10:43 2020 (r367199) +++ stable/12/share/man/man5/Makefile Sat Oct 31 12:36:08 2020 (r367200) @@ -65,6 +65,7 @@ MAN= acct.5 \ resolver.5 \ services.5 \ shells.5 \ + smbfs.5 \ src.conf.5 \ stab.5 \ style.Makefile.5 \ Copied: stable/12/share/man/man5/smbfs.5 (from r359731, head/share/man/man5/smbfs.5) == --- /dev/null 00:00:00 1970 (empty, because file is newly added) +++ stable/12/share/man/man5/smbfs.5Sat Oct 31 12:36:08 2020 (r367200, copy of r359731, head/share/man/man5/smbfs.5) @@ -0,0 +1,79 @@ +.\" Copyright (c) 2020 Gordon Bergling +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\"notice, this list of conditions and the following disclaimer. +.\" 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 +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, 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 DAMAGE. +.\" +.\" $FreeBSD$ +.\" +.Dd April 8, 2020 +.Dt SMBFS 5 +.Os +.Sh NAME +.Nm smbfs +.Nd "SMB FS" +.Sh SYNOPSIS +To compile this driver into the kernel, +place the following lines in your +kernel configuration file: +.Bd -ragged -offset indent +.Cd "option NETSMB" +.Ed +.Pp +Alternatively, to load the driver as a +module at boot time, place the following line in +.Xr loader.conf 5 : +.Bd -literal -offset indent +smbfs_load="YES" +.Ed +.Sh DESCRIPTION +The SMB driver is an implementation of the CIFS (Common Internet Filesystem) +network protocol. +.Sh SEE ALSO +.Xr smbutil 1 , +.Xr mount_smbfs 8 +.Sh STANDARDS +.Rs +.%U https://docs.microsoft.com/en-us/openspecs/windows_protocols/ms-cifs/ +.%T Common Internet File System (CIFS) Protocol +.%R MS-CIFS +.%D December 2018 +.Re +.Pp +.Rs +.%U https://tools.ietf.org/html/draft-heizer-cifs-v1-spec-00 +.%T Common Internet File System Protocol (CIFS/1.0) +.%D June 13, 1996 +.%A I. Heizer +.%A P. Leach +.%A D. Perry +.Re +.Sh HISTORY +The +.Nm +device driver first appeared in +.Fx 4.4 . +.Sh AUTHORS +The +.Nm +device driver was written by +.An Boris Popov Aq Mt b...@freebsd.org . +The manual page was contributed by +.An Gordon Bergling Aq Mt gbergl...@gmail.com . ___ svn-src-all@freebsd.org mailing list https://lists.freebsd.org/mailman/listinfo/svn-src-all To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"
svn commit: r367198 - stable/12/share/man/man5
Author: gbe (doc committer) Date: Sat Oct 31 12:05:00 2020 New Revision: 367198 URL: https://svnweb.freebsd.org/changeset/base/367198 Log: MFC r359608, r359611 elf(5) Updates - expand on NT_FREEBSD_FEATURE_CTL bit definitions - remove commented out leftovers Modified: stable/12/share/man/man5/elf.5 Directory Properties: stable/12/ (props changed) Modified: stable/12/share/man/man5/elf.5 == --- stable/12/share/man/man5/elf.5 Sat Oct 31 11:56:13 2020 (r367197) +++ stable/12/share/man/man5/elf.5 Sat Oct 31 12:05:00 2020 (r367198) @@ -1317,12 +1317,22 @@ is ignored. Contains the MACHINE_ARCH that the executable was built for. .It Dv NT_FREEBSD_FEATURE_CTL Pq Value: 4 Contains a bitmask of mitigations and features to enable: -.Bl -column "NT_FREEBSD_FCTL_PROTMAX_DISABLE" "0x00" "Disable implicit PROT_MAX" -.Sy Name Ta Sy Value Ta Sy Description -.It NT_FREEBSD_FCTL_ASLR_DISABLETa 0x01 Ta Disable ASLR -.It NT_FREEBSD_FCTL_PROTMAX_DISABLE Ta 0x02 Ta Disable implicit PROT_MAX -.It NT_FREEBSD_FCTL_STKGAP_DISABLE Ta 0x04 Ta Disable stack gap -.It NT_FREEBSD_FCTL_WXNEEDEDTa 0x08 Ta Binary makes W+X mappings +.Bl -tag -width 4n +.It NT_FREEBSD_FCTL_ASLR_DISABLE Pq Value: 0x01 +Request that address randomization (ASLR) not be performed. +See +.Xr security 7 . +.It NT_FREEBSD_FCTL_PROTMAX_DISABLE Pq Value: 0x02 +Request that +.Xr mmap 2 +calls not set PROT_MAX to the initial value of the +.Fa prot +argument. +.It NT_FREEBSD_FCTL_STKGAP_DISABLE Pq Value: 0x04 +Disable stack gap. +.It NT_FREEBSD_FCTL_WXNEEDED Pq Value: 0x08 +Indicate that the binary requires mappings that are simultaneously +writeable and executable. .El .El .Sh SEE ALSO ___ svn-src-all@freebsd.org mailing list https://lists.freebsd.org/mailman/listinfo/svn-src-all To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"
svn commit: r367197 - stable/12/share/man/man5
Author: gbe (doc committer) Date: Sat Oct 31 11:56:13 2020 New Revision: 367197 URL: https://svnweb.freebsd.org/changeset/base/367197 Log: MFC r358891, r358894, r359454, r359513, r359550 and r359556 elf(5) Updates: - start documenting ELF note sections - Remove extra Sy from table header - table markup fixes - add definitions of FreeBSD notes - minor update to FreeBSD ELF note descriptions - correct and expand NT_FREEBSD_NOINIT_TAG description - expand on NT_FREEBSD_FEATURE_CTL bit definitions Reviewed by: emaste Approved by: emaste Modified: stable/12/share/man/man5/elf.5 Directory Properties: stable/12/ (props changed) Modified: stable/12/share/man/man5/elf.5 == --- stable/12/share/man/man5/elf.5 Sat Oct 31 11:44:10 2020 (r367196) +++ stable/12/share/man/man5/elf.5 Sat Oct 31 11:56:13 2020 (r367197) @@ -24,7 +24,7 @@ .\" .\" $FreeBSD$ .\" -.Dd December 18, 2005 +.Dd March 11, 2020 .Dt ELF 5 .Os .Sh NAME @@ -1275,6 +1275,55 @@ member. .It Dv r_addend This member specifies a constant addend used to compute the value to be stored into the relocatable field. +.El +.Ss Note Section +ELF note sections consist of entries with the following format: +.Bl -column -offset indent "namesz" "32 bits" "Null-terminated originator name" +.Sy Field Ta Sy SizeTa Sy Description +.It Va namesz Ta 32 bitsTa Size of "name" +.It Va descsz Ta 32 bitsTa Size of "desc" +.It Va type Ta 32 bitsTa OS-dependent note type +.It Va name Ta Va namesz Ta Null-terminated originator name +.It Va desc Ta Va descsz Ta OS-dependent note data +.El +.Pp +The +.Va name +and +.Va desc +fields are padded to ensure 4-byte alignemnt. +.Va namesz +and +.Va descsz +specify the unpadded length. +.Pp +.Fx +defines the following ELF note types +.Po with corresponding interpretation of +.Va desc Pc : +.Bl -tag -width 4n +.It Dv NT_FREEBSD_ABI_TAG Pq Value: 1 +Indicates the OS ABI version in a form of a 32-bit integer containing expected +ABI version +.Po i.e., +.Dv __FreeBSD_version Pc . +.It Dv NT_FREEBSD_NOINIT_TAG Pq Value: 2 +Indicates that the C startup does not call initialization routines, and thus +.Xr rtld 1 +must do so. +.Va desc +is ignored. +.It Dv NT_FREEBSD_ARCH_TAG Pq Value: 3 +Contains the MACHINE_ARCH that the executable was built for. +.It Dv NT_FREEBSD_FEATURE_CTL Pq Value: 4 +Contains a bitmask of mitigations and features to enable: +.Bl -column "NT_FREEBSD_FCTL_PROTMAX_DISABLE" "0x00" "Disable implicit PROT_MAX" +.Sy Name Ta Sy Value Ta Sy Description +.It NT_FREEBSD_FCTL_ASLR_DISABLETa 0x01 Ta Disable ASLR +.It NT_FREEBSD_FCTL_PROTMAX_DISABLE Ta 0x02 Ta Disable implicit PROT_MAX +.It NT_FREEBSD_FCTL_STKGAP_DISABLE Ta 0x04 Ta Disable stack gap +.It NT_FREEBSD_FCTL_WXNEEDEDTa 0x08 Ta Binary makes W+X mappings +.El .El .Sh SEE ALSO .Xr as 1 , ___ svn-src-all@freebsd.org mailing list https://lists.freebsd.org/mailman/listinfo/svn-src-all To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"
svn commit: r367091 - in head/share/man: man4 man5
Author: gbe (doc committer) Date: Tue Oct 27 18:30:43 2020 New Revision: 367091 URL: https://svnweb.freebsd.org/changeset/base/367091 Log: Use my FreeBSD.org mail address in man pages I have written MFC after:3 days Modified: head/share/man/man4/smbios.4 head/share/man/man5/smbfs.5 head/share/man/man5/unionfs.5 Modified: head/share/man/man4/smbios.4 == --- head/share/man/man4/smbios.4Tue Oct 27 18:13:09 2020 (r367090) +++ head/share/man/man4/smbios.4Tue Oct 27 18:30:43 2020 (r367091) @@ -62,4 +62,4 @@ The device driver was written by .An Matthew N. Dodd Aq Mt win...@jurai.net . This manual page was written by -.An Gordon Bergling Aq Mt gbergl...@gmail.com . +.An Gordon Bergling Aq Mt g...@freebsd.org . Modified: head/share/man/man5/smbfs.5 == --- head/share/man/man5/smbfs.5 Tue Oct 27 18:13:09 2020(r367090) +++ head/share/man/man5/smbfs.5 Tue Oct 27 18:30:43 2020(r367091) @@ -76,4 +76,4 @@ The device driver was written by .An Boris Popov Aq Mt b...@freebsd.org . The manual page was contributed by -.An Gordon Bergling Aq Mt gbergl...@gmail.com . +.An Gordon Bergling Aq Mt g...@freebsd.org . Modified: head/share/man/man5/unionfs.5 == --- head/share/man/man5/unionfs.5 Tue Oct 27 18:13:09 2020 (r367090) +++ head/share/man/man5/unionfs.5 Tue Oct 27 18:30:43 2020 (r367091) @@ -78,7 +78,7 @@ and reimplemented the handling of the locking for .Fx 7.0 . The manual page was written by -.An Gordon Bergling Aq Mt gbergl...@gmail.com . +.An Gordon Bergling Aq Mt g...@freebsd.org . .Sh BUGS Please see the .Xr mount_unionfs 8 ___ svn-src-all@freebsd.org mailing list https://lists.freebsd.org/mailman/listinfo/svn-src-all To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"
Re: svn commit: r366949 - head/usr.sbin/nfsd
On Thu, Oct 22, 2020 at 12:28:51PM -0700, Benjamin Kaduk wrote: > On Thu, Oct 22, 2020 at 12:25 PM Gordon Bergling wrote: > > > Author: gbe (doc committer) > > Date: Thu Oct 22 19:25:01 2020 > > New Revision: 366949 > > URL: https://svnweb.freebsd.org/changeset/base/366949 > > > > Log: > > stablerestart(5): Fix some issues reported by mandoc > > > > - New sentence, new line > > > > Modified: > > head/usr.sbin/nfsd/stablerestart.5 > > > > Modified: head/usr.sbin/nfsd/stablerestart.5 > > > > == > > --- head/usr.sbin/nfsd/stablerestart.5 Thu Oct 22 19:22:34 2020 > > (r366948) > > +++ head/usr.sbin/nfsd/stablerestart.5 Thu Oct 22 19:25:01 2020 > > (r366949) > > @@ -52,18 +52,18 @@ first record. > > The lease duration is used to set the grace period. > > The boot times > > are used to avoid the unlikely occurrence of a boot time being reused, > > -due to a TOD clock going backwards. This record and the previous boot > > times with this boot time added is re-written at the > > -end of the grace period. > > +due to a TOD clock going backwards. > > +This record and the previous boot times with this boot time > > +added is re-written at the end of the grace period. > > .Pp > > The rest of the file are appended records, as defined by > > -struct nfst_rec in /usr/include/fs/nfs/nfsrvstate.h and are used > > -represent one of two things. There are records which indicate that a > > +struct nfst_rec in /usr/include/fs/nfs/nfsrvstate.h and are used > > represent one of two things. > > > There are some more markup options here, like (IIRC) .Fa for struct > nfst_rec, and .Pa for /usr/include/fs/nfs/nfsrvstate.h > > -Ben Hi Ben, I'll check further optimizations tomorrow! Thanks for the hint. -- Gordon ___ svn-src-all@freebsd.org mailing list https://lists.freebsd.org/mailman/listinfo/svn-src-all To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"
svn commit: r366949 - head/usr.sbin/nfsd
Author: gbe (doc committer) Date: Thu Oct 22 19:25:01 2020 New Revision: 366949 URL: https://svnweb.freebsd.org/changeset/base/366949 Log: stablerestart(5): Fix some issues reported by mandoc - New sentence, new line Modified: head/usr.sbin/nfsd/stablerestart.5 Modified: head/usr.sbin/nfsd/stablerestart.5 == --- head/usr.sbin/nfsd/stablerestart.5 Thu Oct 22 19:22:34 2020 (r366948) +++ head/usr.sbin/nfsd/stablerestart.5 Thu Oct 22 19:25:01 2020 (r366949) @@ -52,18 +52,18 @@ first record. The lease duration is used to set the grace period. The boot times are used to avoid the unlikely occurrence of a boot time being reused, -due to a TOD clock going backwards. This record and the previous boot times with this boot time added is re-written at the -end of the grace period. +due to a TOD clock going backwards. +This record and the previous boot times with this boot time +added is re-written at the end of the grace period. .Pp The rest of the file are appended records, as defined by -struct nfst_rec in /usr/include/fs/nfs/nfsrvstate.h and are used -represent one of two things. There are records which indicate that a +struct nfst_rec in /usr/include/fs/nfs/nfsrvstate.h and are used represent one of two things. +There are records which indicate that a client successfully acquired state and records that indicate a client's state was revoked. State revoke records indicate that state information for a client was discarded, due to lease expiry and an otherwise conflicting open or lock request being made by a different client. -These records can be used -to determine if clients might have done either of the +These records can be used to determine if clients might have done either of the edge conditions. .Pp If a client might have done either edge condition or this file is @@ -71,8 +71,8 @@ empty or corrupted, the server returns NFSERR_NOGRACE request from the client. .Pp For correct operation of the server, it must be ensured that the file -is written to stable storage by the time a write op with IO_SYNC specified -has returned. This might require hardware level caching to be disabled for +is written to stable storage by the time a write op with IO_SYNC specified has returned. +This might require hardware level caching to be disabled for a local disk drive that holds the file, or similar. .Sh FILES .Bl -tag -width /var/db/nfs-stablerestart.bak -compact @@ -86,12 +86,11 @@ backup copy of the file .Xr nfsd 8 .Sh BUGS If the file is empty, the NFSv4 server has no choice but to return -NFSERR_NOGRACE for all reclaim requests. Although correct, this is -a highly undesirable occurrence, so the file should not be lost if -at all possible. The backup copy of the file is maintained -and used by the +NFSERR_NOGRACE for all reclaim requests. +Although correct, this is a highly undesirable occurrence, so the file should not be lost if +at all possible. +The backup copy of the file is maintained and used by the .Xr nfsd 8 to minimize the risk of this occurring. -To move the file, you must edit -the nfsd sources and recompile it. This was done to discourage -accidental relocation of the file. +To move the file, you must edit the nfsd sources and recompile it. +This was done to discourage accidental relocation of the file. ___ svn-src-all@freebsd.org mailing list https://lists.freebsd.org/mailman/listinfo/svn-src-all To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"
svn commit: r366947 - head/usr.sbin/nfsd
Author: gbe (doc committer) Date: Thu Oct 22 19:19:42 2020 New Revision: 366947 URL: https://svnweb.freebsd.org/changeset/base/366947 Log: pnfsserver(4): Fix some issues reported by mandoc - new sentence, new line Modified: head/usr.sbin/nfsd/pnfsserver.4 Modified: head/usr.sbin/nfsd/pnfsserver.4 == --- head/usr.sbin/nfsd/pnfsserver.4 Thu Oct 22 18:45:49 2020 (r366946) +++ head/usr.sbin/nfsd/pnfsserver.4 Thu Oct 22 19:19:42 2020 (r366947) @@ -248,11 +248,12 @@ after the DS failure or network partitioning occurs. the arguments for a LayoutReturn operation. .sp 3 - The system administrator can perform the pnfsdskill(8) command on the MDS -to disable it. If the system administrator does a pnfsdskill(8) and it fails -with ENXIO (Device not configured) that normally means the DS was already -disabled via #1 or #2. Since doing this is harmless, once a system -administrator knows that there is a problem with a mirrored DS, doing the -command is recommended. +to disable it. +If the system administrator does a pnfsdskill(8) and it fails with ENXIO +(Device not configured) that normally means the DS was already +disabled via #1 or #2. +Since doing this is harmless, once a system administrator knows that +there is a problem with a mirrored DS, doing the command is recommended. .sp Once a system administrator knows that a mirrored DS has malfunctioned or has been network partitioned, they should do the following as root/su @@ -266,9 +267,8 @@ Note that the must be the exac string used when the DS was mounted on the MDS. .Pp Once the mirrored DS has been disabled, the pNFS service should continue to -function, but file updates will only happen on the DS(s) -that have not been disabled. Assuming two way mirroring, that implies -the one DS of the pair stored in the +function, but file updates will only happen on the DS(s) that have not been disabled. +Assuming two way mirroring, that implies the one DS of the pair stored in the .Dq pnfsd.dsfile extended attribute for the file on the MDS, for files stored on the disabled DS. .Pp ___ svn-src-all@freebsd.org mailing list https://lists.freebsd.org/mailman/listinfo/svn-src-all To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"
svn commit: r366946 - head/share/man/man9
Author: gbe (doc committer) Date: Thu Oct 22 18:45:49 2020 New Revision: 366946 URL: https://svnweb.freebsd.org/changeset/base/366946 Log: socket(9): Remove duplicate word 'is is' MFC after:1 week Modified: head/share/man/man9/socket.9 Modified: head/share/man/man9/socket.9 == --- head/share/man/man9/socket.9Thu Oct 22 18:00:07 2020 (r366945) +++ head/share/man/man9/socket.9Thu Oct 22 18:45:49 2020 (r366946) @@ -378,7 +378,7 @@ or A kernel system can use the .Fn sodtor_set function to set a destructor for a socket. -The destructor is called when the socket is is about to be freed. +The destructor is called when the socket is about to be freed. The destructor is called before the protocol detach routine. The destructor can serve as a callback to initiate additional cleanup actions. .Ss Socket I/O ___ svn-src-all@freebsd.org mailing list https://lists.freebsd.org/mailman/listinfo/svn-src-all To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"
svn commit: r366891 - stable/12/share/man/man3
Author: gbe (doc committer) Date: Tue Oct 20 09:51:41 2020 New Revision: 366891 URL: https://svnweb.freebsd.org/changeset/base/366891 Log: MFC r366481: intro(3): Update the list of included libraries - Extend the list of main libraries of section 3 - Extend the library functions that are included in the libc Submitted by: Naga Chaitanya Vellanki Differential Revision:https://reviews.freebsd.org/D26476 Modified: stable/12/share/man/man3/intro.3 Directory Properties: stable/12/ (props changed) Modified: stable/12/share/man/man3/intro.3 == --- stable/12/share/man/man3/intro.3Tue Oct 20 09:46:20 2020 (r366890) +++ stable/12/share/man/man3/intro.3Tue Oct 20 09:51:41 2020 (r366891) @@ -28,12 +28,17 @@ .\" @(#)intro.38.1 (Berkeley) 6/5/93 .\" $FreeBSD$ .\" -.Dd March 22, 2017 +.Dd October 6, 2020 .Dt INTRO 3 .Os .Sh NAME .Nm intro .Nd introduction to the C libraries +.Sh SYNOPSIS +.Nm cc +.Op Ar flags +.Ar +.Op Fl llibrary .Sh DESCRIPTION This section provides an overview of the C library functions, their error returns and other @@ -47,7 +52,11 @@ must be indicated at compile time with the option of the compiler. .Pp The various libraries (followed by the loader flag): -.Bl -tag -width "libc (-lc)" +.Bl -tag -width "libbluetooth (-lbluetooth)" +.It Em libbluetooth Pq Fl l Ns Ar bluetooth +The bluetooth library. +See +.Xr bluetooth 3 . .It Em libc Pq Fl l Ns Ar c Standard C library functions. When using the C compiler @@ -57,21 +66,58 @@ to supply the loader flag .Fl l Ns Ar c for these functions. There are several `libraries' or groups of functions included inside of -.Em libc -: the standard -.Tn I/O -routines, -database routines, -bit operators, -string operators, -character tests and character operators, -des encryption routines, -storage allocation, time functions, signal handling and more. +.Em libc : +.Bl -tag -width "XX" +.It standard I/O routines +see +.Xr stdio 3 +.It database routines +see +.Xr db 3 +.It bit operators +see +.Xr bitstring 3 +.It string operators +see +.Xr string 3 +.It character tests and character operators +.It storage allocation +see +.Xr mpool 3 +.It regular-expressions +see +.Xr regex 3 +.It remote procedure calls (RPC) +see +.Xr rpc 3 +.It time functions +see +.Xr time 3 +.It signal handling +see +.Xr signal 3 +.El +.It Em libcalendar Pq Fl l Ns Ar calendar +The calendar arithmetic library. +See +.Xr calendar 3 . +.It Em libcam Pq Fl l Ns Ar cam +The common access method user library. +See +.Xr cam 3 . +.It Em libcrypt Pq Fl l Ns Ar crypt +The crypt library. +See +.Xr crypt 3 . .It Em libcurses Pq Fl l Ns Ar curses Fl l Ns Ar termcap Terminal independent screen management routines for two dimensional non-bitmap display terminals. -(See -.Xr ncurses 3 . ) +See +.Xr ncurses 3 . +.It Em libcuse Pq Fl l Ns Ar cuse +The userland character device library. +See +.Xr cuse 3 . .It Em libcompat Pq Fl l Ns Ar compat Functions which are obsolete but are available for compatibility with .Bx 4.3 . @@ -82,32 +128,106 @@ have been included for source code compatibility. Use of these routines should, for the most part, be avoided. The manual page entry for each compatibility routine indicates the proper interface to use. +.It Em libdevinfo Pq Fl l Ns Ar devinfo +The Device and Resource Information Utility library. +See +.Xr devinfo 3 . +.It Em libdevstat Pq Fl l Ns Ar devstat +The Device Statistics library. +See +.Xr devstat 3 . +.It Em libdwarf Pq Fl l Ns Ar dwarf +The DWARF access library. +See +.Xr dwarf 3 . +.It Em libelf Pq Fl l Ns Ar elf +The ELF access library. +See +.Xr elf 3 . +.It Em libfetch Pq Fl l Ns Ar fetch +The file transfer library. +See +.Xr fetch 3 . +.It Em libfigpar Pq Fl l Ns Ar figpar +The configuration file parsing library. +See +.Xr figpar 3 . +.It Em libgpio Pq Fl l Ns Ar gpio +The general-purpose input output library (GPIO). +See +.Xr gpio 3 . +.It Em libgssapi Pq Fl l Ns Ar gssapi +The generic security service application programming +interface. +See +.Xr gssapi 3 . +.It Em libjail Pq Fl l Ns Ar jail +The jail library. +See +.Xr jail 3 . .It Em libkvm Pq Fl l Ns Ar kvm Functions used to access kernel memory are in this library. They can be used against both a running system and a crash dump. -(See -.Xr kvm 3 . ) +See +.Xr kvm 3 . .It Em libl Pq Fl l Ns Ar l The library for .Xr lex 1 . .It Em libm Pq Fl l Ns Ar m -The math library, -.Em libm . -The math library is loaded as needed by the Pascal compiler, -but not by the C compiler which requires the -.Fl l Ns Ar m -flag. -(See -.Xr math 3 . ) +The math library. +See +.Xr math 3 . +.It Em libmd Pq Fl l Ns Ar md +The message digest library. +See +.Xr md4 3 , +.Xr md5 3 , +.Xr sha 3 , +.Xr sha256 3 , +.Xr sha512 3 , +.Xr ripemd 3 , +.Xr skein 3 . .It Em libmp Pq Fl l Ns Ar mp +.It Em libpam Pq Fl l Ns Ar pam +The pluggable authentication module
svn commit: r366790 - stable/12/usr.bin/cpuset
Author: gbe (doc committer) Date: Sat Oct 17 09:51:17 2020 New Revision: 366790 URL: https://svnweb.freebsd.org/changeset/base/366790 Log: MFC r366611: cpuset(1): Fix a typo - 'at at' -> 'at a' Modified: stable/12/usr.bin/cpuset/cpuset.1 Directory Properties: stable/12/ (props changed) Modified: stable/12/usr.bin/cpuset/cpuset.1 == --- stable/12/usr.bin/cpuset/cpuset.1 Sat Oct 17 09:50:12 2020 (r366789) +++ stable/12/usr.bin/cpuset/cpuset.1 Sat Oct 17 09:51:17 2020 (r366790) @@ -152,7 +152,7 @@ Ranges may be specified as in Valid policies include first-touch (ft), round-robin (rr), prefer and interleave (il). First-touch allocates on the local domain when memory is available. -Round-robin alternates between every possible domain page at at time. +Round-robin alternates between every possible domain page at a time. The prefer policy accepts only a single domain in the set. The parent of the set is consulted if the preferred domain is unavailable. Interleave operates like round-robin with an implementation defined stripe ___ svn-src-all@freebsd.org mailing list https://lists.freebsd.org/mailman/listinfo/svn-src-all To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"
svn commit: r366789 - stable/12/share/man/man3
Author: gbe (doc committer) Date: Sat Oct 17 09:50:12 2020 New Revision: 366789 URL: https://svnweb.freebsd.org/changeset/base/366789 Log: MFC r366610: sigevent(3): Fix a typo - asychronous -> asynchronous Modified: stable/12/share/man/man3/sigevent.3 Directory Properties: stable/12/ (props changed) Modified: stable/12/share/man/man3/sigevent.3 == --- stable/12/share/man/man3/sigevent.3 Sat Oct 17 09:48:56 2020 (r366788) +++ stable/12/share/man/man3/sigevent.3 Sat Oct 17 09:50:12 2020 (r366789) @@ -35,7 +35,7 @@ .Sh SYNOPSIS .In signal.h .Sh DESCRIPTION -Some operations permit threads to request asychronous notification of events +Some operations permit threads to request asynchronous notification of events via a .Vt struct sigevent structure. ___ svn-src-all@freebsd.org mailing list https://lists.freebsd.org/mailman/listinfo/svn-src-all To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"
svn commit: r366788 - stable/12/usr.sbin/pnfsdsfile
Author: gbe (doc committer) Date: Sat Oct 17 09:48:56 2020 New Revision: 366788 URL: https://svnweb.freebsd.org/changeset/base/366788 Log: MFC r366617: pnfsdsfile(8): Remove dublicate word 'the' Modified: stable/12/usr.sbin/pnfsdsfile/pnfsdsfile.8 Directory Properties: stable/12/ (props changed) Modified: stable/12/usr.sbin/pnfsdsfile/pnfsdsfile.8 == --- stable/12/usr.sbin/pnfsdsfile/pnfsdsfile.8 Sat Oct 17 09:47:56 2020 (r366787) +++ stable/12/usr.sbin/pnfsdsfile/pnfsdsfile.8 Sat Oct 17 09:48:56 2020 (r366788) @@ -117,7 +117,7 @@ After being re-enabled, the command with the .Dq -r option -will be used to copy the the file's data to this repaired DS and then update the +will be used to copy the file's data to this repaired DS and then update the extended attribute to use it. .Pp A typical use of this will be within a ___ svn-src-all@freebsd.org mailing list https://lists.freebsd.org/mailman/listinfo/svn-src-all To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"
svn commit: r366787 - stable/12/share/man/man4
Author: gbe (doc committer) Date: Sat Oct 17 09:47:56 2020 New Revision: 366787 URL: https://svnweb.freebsd.org/changeset/base/366787 Log: MFC r366609: dtrace_audit(4): Fix a typo - asynchonously -> asynchronously Modified: stable/12/share/man/man4/dtrace_audit.4 Directory Properties: stable/12/ (props changed) Modified: stable/12/share/man/man4/dtrace_audit.4 == --- stable/12/share/man/man4/dtrace_audit.4 Sat Oct 17 09:45:05 2020 (r366786) +++ stable/12/share/man/man4/dtrace_audit.4 Sat Oct 17 09:47:56 2020 (r366787) @@ -119,7 +119,7 @@ remains available for capture by the script. .Pp The .Fn audit:event:aue_*:bsm -probes fire asynchonously from system-call return, following BSM conversion +probes fire asynchronously from system-call return, following BSM conversion and just prior to being written to disk, giving access to four arguments: a .Vt char * audit event name, the ___ svn-src-all@freebsd.org mailing list https://lists.freebsd.org/mailman/listinfo/svn-src-all To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"
svn commit: r366786 - stable/12/usr.sbin/cxgbetool
Author: gbe (doc committer) Date: Sat Oct 17 09:45:05 2020 New Revision: 366786 URL: https://svnweb.freebsd.org/changeset/base/366786 Log: MFC r366616: cxgbetool(8): Remove dublicate word 'whether' Modified: stable/12/usr.sbin/cxgbetool/cxgbetool.8 Directory Properties: stable/12/ (props changed) Modified: stable/12/usr.sbin/cxgbetool/cxgbetool.8 == --- stable/12/usr.sbin/cxgbetool/cxgbetool.8Sat Oct 17 08:48:58 2020 (r366785) +++ stable/12/usr.sbin/cxgbetool/cxgbetool.8Sat Oct 17 09:45:05 2020 (r366786) @@ -547,7 +547,7 @@ There is an implicit rule that disables offload for co match anything in the policy. .Pp Each rule consists of a filter part, which determines what connections the -rule applies to, and a settings part, which determines whether whether matching +rule applies to, and a settings part, which determines whether matching connections will be offloaded and, if so, with what settings. The general form of a rule is .Bl -ohang -offset indent ___ svn-src-all@freebsd.org mailing list https://lists.freebsd.org/mailman/listinfo/svn-src-all To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"
Re: svn commit: r366725 - head/lib/geom/eli
Hi Mateusz, On Thu, Oct 15, 2020 at 02:17:45PM +, Mateusz Piotrowski wrote: > Author: 0mp (doc,ports committer) > Date: Thu Oct 15 14:17:45 2020 > New Revision: 366725 > URL: https://svnweb.freebsd.org/changeset/base/366725 > > Log: > Fix formatting of SYNOPSIS > > There was an unnecessary newline being added before Nm. > > MFC after: 3 days > > Modified: > head/lib/geom/eli/geli.8 > > Modified: head/lib/geom/eli/geli.8 > == > --- head/lib/geom/eli/geli.8 Thu Oct 15 13:47:52 2020(r366724) > +++ head/lib/geom/eli/geli.8 Thu Oct 15 14:17:45 2020(r366725) > @@ -24,7 +24,7 @@ > .\" > .\" $FreeBSD$ > .\" > -.Dd July 22, 2020 > +.Dd October 15, 2020 > .Dt GELI 8 > .Os > .Sh NAME > @@ -45,8 +45,7 @@ to your > geom_eli_load="YES" > .Ed > .Pp > -Usage of the > -.Nm > +.No Usage of the Nm > utility: > .Pp > .Nm The formatting of the SYNOPSIS was correct before this change. It's a common practice in man pages to use The .Nm utility ... Your change is looking somewhat strange, since ".No Usage of the Nm" reads like the man page would renders "Nm", since it is not used as macro. A .Dd bump is also not necessary since no user visible changes were made to the man page. -- Gordon ___ svn-src-all@freebsd.org mailing list https://lists.freebsd.org/mailman/listinfo/svn-src-all To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"
svn commit: r366630 - stable/12/bin/ls
Author: gbe (doc committer) Date: Mon Oct 12 08:43:21 2020 New Revision: 366630 URL: https://svnweb.freebsd.org/changeset/base/366630 Log: MFC r366613: ls(1): Use \& as an escape character for the ',' option Reported by: karels@, xtouqh at hotmail dot com Modified: stable/12/bin/ls/ls.1 Directory Properties: stable/12/ (props changed) Modified: stable/12/bin/ls/ls.1 == --- stable/12/bin/ls/ls.1 Mon Oct 12 05:56:29 2020(r366629) +++ stable/12/bin/ls/ls.1 Mon Oct 12 08:43:21 2020(r366630) @@ -40,7 +40,7 @@ .Nd list directory contents .Sh SYNOPSIS .Nm -.Op Fl ABCFGHILPRSTUWZabcdfghiklmnopqrstuwxy1 , +.Op Fl ABCFGHILPRSTUWZabcdfghiklmnopqrstuwxy1\&, .Op Fl -color Ns = Ns Ar when .Op Fl D Ar format .Op Ar ___ svn-src-all@freebsd.org mailing list https://lists.freebsd.org/mailman/listinfo/svn-src-all To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"
Re: svn commit: r366608 - in stable/12: bin/ls sbin/dhclient
On Sat, Oct 10, 2020 at 09:02:50AM -0500, Mike Karels wrote: > > Date: Sat, 10 Oct 2020 15:28:29 +0200 > > From: Gordon Bergling > > On Sat, Oct 10, 2020 at 08:12:43AM -0500, Mike Karels wrote: > > > > Author: gbe (doc committer) > > > > Date: Sat Oct 10 09:52:41 2020 > > > > New Revision: 366608 > > > > URL: https://svnweb.freebsd.org/changeset/base/366608 > > > > > > > Log: > > > > MFC r366407, r366403 > > > > > > > > ls(1): Bugfix for an issue reported by mandoc > > > > dhclient(8): Bugfixes for some issues reported by mandoc > > > > > > > > - no blank before trailing delimiter > > > > - new sentence, new line > > > > > > > Modified: > > > > stable/12/bin/ls/ls.1 > > > > stable/12/sbin/dhclient/dhclient.leases.5 > > > > stable/12/sbin/dhclient/dhcp-options.5 > > > > Directory Properties: > > > > stable/12/ (props changed) > > > > > > > Modified: stable/12/bin/ls/ls.1 > > > > == > > > > --- stable/12/bin/ls/ls.1 Sat Oct 10 09:50:09 2020 > > > > (r366607) > > > > +++ stable/12/bin/ls/ls.1 Sat Oct 10 09:52:41 2020 > > > > (r366608) > > > > @@ -40,7 +40,7 @@ > > > > .Nd list directory contents > > > > .Sh SYNOPSIS > > > > .Nm > > > > -.Op Fl ABCFGHILPRSTUWZabcdfghiklmnopqrstuwxy1, > > > > +.Op Fl ABCFGHILPRSTUWZabcdfghiklmnopqrstuwxy1 , > > > > .Op Fl -color Ns = Ns Ar when > > > > .Op Fl D Ar format > > > > .Op Ar > > > > > > This change is wrong, and should not have been MFC'd. It should be fixed > > > correctly instead. The comma is not a delimiter, it is an option; it > > > should > > > appear inside the brackets, not after. The warning can be fixed by adding > > > \& after the comma rather than inserting a space. > > > > > > Mike > > > Hello Mike, > > > if this change is wrong I'll correct it in head and MFC it afterwards. > > The output of ls(1) is still the same as it was before, checked via mandoc > > and > > man. > > > --Gordon > > In my testing, the comma is inside the brackets in the original version: > > ls [-ABCFGHILPRSTUWZabcdfghiklmnopqrstuwxy1,] [--color=when] [-D format] > [file ...] > > > It is outside the brackets with this change: > > ls [-ABCFGHILPRSTUWZabcdfghiklmnopqrstuwxy1], [--color=when] [-D format] > [file ...] > > The former is correct. Caveat, I'm running mandoc on 12.1. > > Mike That is strange, maybe an localisation problem. I am also running my local tests on 12.2-STABLE. I followed your suggestion in r366613 [1] and MFC it tomorrow. --Gordon [1] https://svnweb.freebsd.org/base?view=revision&revision=366613 ___ svn-src-all@freebsd.org mailing list https://lists.freebsd.org/mailman/listinfo/svn-src-all To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"
svn commit: r366617 - head/usr.sbin/pnfsdsfile
Author: gbe (doc committer) Date: Sat Oct 10 14:38:01 2020 New Revision: 366617 URL: https://svnweb.freebsd.org/changeset/base/366617 Log: pnfsdsfile(8): Remove dublicate word 'the' MFC after:1 week Modified: head/usr.sbin/pnfsdsfile/pnfsdsfile.8 Modified: head/usr.sbin/pnfsdsfile/pnfsdsfile.8 == --- head/usr.sbin/pnfsdsfile/pnfsdsfile.8 Sat Oct 10 14:36:16 2020 (r366616) +++ head/usr.sbin/pnfsdsfile/pnfsdsfile.8 Sat Oct 10 14:38:01 2020 (r366617) @@ -117,7 +117,7 @@ After being re-enabled, the command with the .Dq -r option -will be used to copy the the file's data to this repaired DS and then update the +will be used to copy the file's data to this repaired DS and then update the extended attribute to use it. .Pp A typical use of this will be within a ___ svn-src-all@freebsd.org mailing list https://lists.freebsd.org/mailman/listinfo/svn-src-all To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"
svn commit: r366616 - head/usr.sbin/cxgbetool
Author: gbe (doc committer) Date: Sat Oct 10 14:36:16 2020 New Revision: 366616 URL: https://svnweb.freebsd.org/changeset/base/366616 Log: cxgbetool(8): Remove dublicate word 'whether' MFC after:1 week Modified: head/usr.sbin/cxgbetool/cxgbetool.8 Modified: head/usr.sbin/cxgbetool/cxgbetool.8 == --- head/usr.sbin/cxgbetool/cxgbetool.8 Sat Oct 10 14:20:07 2020 (r366615) +++ head/usr.sbin/cxgbetool/cxgbetool.8 Sat Oct 10 14:36:16 2020 (r366616) @@ -547,7 +547,7 @@ There is an implicit rule that disables offload for co match anything in the policy. .Pp Each rule consists of a filter part, which determines what connections the -rule applies to, and a settings part, which determines whether whether matching +rule applies to, and a settings part, which determines whether matching connections will be offloaded and, if so, with what settings. The general form of a rule is .Bl -ohang -offset indent ___ svn-src-all@freebsd.org mailing list https://lists.freebsd.org/mailman/listinfo/svn-src-all To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"
svn commit: r366615 - head/share/man/man5
Author: gbe (doc committer) Date: Sat Oct 10 14:20:07 2020 New Revision: 366615 URL: https://svnweb.freebsd.org/changeset/base/366615 Log: man5: Fix a few typos spotted by igor - fstab(5): conjuction -> conjunction - mount.conf(5): repeated 'the' - periodic.conf(5): Partion -> Partition MFC after:1 week Modified: head/share/man/man5/fstab.5 head/share/man/man5/mount.conf.5 head/share/man/man5/periodic.conf.5 Modified: head/share/man/man5/fstab.5 == --- head/share/man/man5/fstab.5 Sat Oct 10 13:46:48 2020(r366614) +++ head/share/man/man5/fstab.5 Sat Oct 10 14:20:07 2020(r366615) @@ -205,7 +205,7 @@ is applied automatically. .Pp The .Dq update -option is typically used in conjuction with two +option is typically used in conjunction with two .Nm files. The first Modified: head/share/man/man5/mount.conf.5 == --- head/share/man/man5/mount.conf.5Sat Oct 10 13:46:48 2020 (r366614) +++ head/share/man/man5/mount.conf.5Sat Oct 10 14:20:07 2020 (r366615) @@ -123,8 +123,7 @@ is performed. When the kernel processes this line, a .Li mountroot> command-line prompt is displayed. -At this prompt, the operator can enter the -the root mount. +At this prompt, the operator can enter the root mount. .It Ic .md Ar file Create a memory backed .Xr md 4 Modified: head/share/man/man5/periodic.conf.5 == --- head/share/man/man5/periodic.conf.5 Sat Oct 10 13:46:48 2020 (r366614) +++ head/share/man/man5/periodic.conf.5 Sat Oct 10 14:20:07 2020 (r366615) @@ -256,7 +256,7 @@ as configured in .Pq Vt bool Set to .Dq Li YES -to create backup of EFI System Partion (ESP). +to create backup of EFI System Partition (ESP). .It Va daily_backup_gpart_enable .Pq Vt bool Set to ___ svn-src-all@freebsd.org mailing list https://lists.freebsd.org/mailman/listinfo/svn-src-all To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"
svn commit: r366613 - head/bin/ls
Author: gbe (doc committer) Date: Sat Oct 10 13:39:13 2020 New Revision: 366613 URL: https://svnweb.freebsd.org/changeset/base/366613 Log: ls(1): Use \& as an escape character for the ',' option Reported by: karels@, xtouqh at hotmail dot com MFC after:1 day Modified: head/bin/ls/ls.1 Modified: head/bin/ls/ls.1 == --- head/bin/ls/ls.1Sat Oct 10 13:33:57 2020(r366612) +++ head/bin/ls/ls.1Sat Oct 10 13:39:13 2020(r366613) @@ -40,7 +40,7 @@ .Nd list directory contents .Sh SYNOPSIS .Nm -.Op Fl ABCFGHILPRSTUWZabcdfghiklmnopqrstuwxy1 , +.Op Fl ABCFGHILPRSTUWZabcdfghiklmnopqrstuwxy1\&, .Op Fl -color Ns = Ns Ar when .Op Fl D Ar format .Op Ar ___ svn-src-all@freebsd.org mailing list https://lists.freebsd.org/mailman/listinfo/svn-src-all To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"
Re: svn commit: r366608 - in stable/12: bin/ls sbin/dhclient
On Sat, Oct 10, 2020 at 08:12:43AM -0500, Mike Karels wrote: > > Author: gbe (doc committer) > > Date: Sat Oct 10 09:52:41 2020 > > New Revision: 366608 > > URL: https://svnweb.freebsd.org/changeset/base/366608 > > > Log: > > MFC r366407, r366403 > > > > ls(1): Bugfix for an issue reported by mandoc > > dhclient(8): Bugfixes for some issues reported by mandoc > > > > - no blank before trailing delimiter > > - new sentence, new line > > > Modified: > > stable/12/bin/ls/ls.1 > > stable/12/sbin/dhclient/dhclient.leases.5 > > stable/12/sbin/dhclient/dhcp-options.5 > > Directory Properties: > > stable/12/ (props changed) > > > Modified: stable/12/bin/ls/ls.1 > > == > > --- stable/12/bin/ls/ls.1 Sat Oct 10 09:50:09 2020(r366607) > > +++ stable/12/bin/ls/ls.1 Sat Oct 10 09:52:41 2020(r366608) > > @@ -40,7 +40,7 @@ > > .Nd list directory contents > > .Sh SYNOPSIS > > .Nm > > -.Op Fl ABCFGHILPRSTUWZabcdfghiklmnopqrstuwxy1, > > +.Op Fl ABCFGHILPRSTUWZabcdfghiklmnopqrstuwxy1 , > > .Op Fl -color Ns = Ns Ar when > > .Op Fl D Ar format > > .Op Ar > > This change is wrong, and should not have been MFC'd. It should be fixed > correctly instead. The comma is not a delimiter, it is an option; it should > appear inside the brackets, not after. The warning can be fixed by adding > \& after the comma rather than inserting a space. > > Mike Hello Mike, if this change is wrong I'll correct it in head and MFC it afterwards. The output of ls(1) is still the same as it was before, checked via mandoc and man. --Gordon ___ svn-src-all@freebsd.org mailing list https://lists.freebsd.org/mailman/listinfo/svn-src-all To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"
svn commit: r366611 - head/usr.bin/cpuset
Author: gbe (doc committer) Date: Sat Oct 10 13:01:04 2020 New Revision: 366611 URL: https://svnweb.freebsd.org/changeset/base/366611 Log: cpuset(1): Fix a typo - 'at at' -> 'at a' MFC after:1 week Modified: head/usr.bin/cpuset/cpuset.1 Modified: head/usr.bin/cpuset/cpuset.1 == --- head/usr.bin/cpuset/cpuset.1Sat Oct 10 12:06:39 2020 (r366610) +++ head/usr.bin/cpuset/cpuset.1Sat Oct 10 13:01:04 2020 (r366611) @@ -152,7 +152,7 @@ Ranges may be specified as in Valid policies include first-touch (ft), round-robin (rr), prefer and interleave (il). First-touch allocates on the local domain when memory is available. -Round-robin alternates between every possible domain page at at time. +Round-robin alternates between every possible domain page at a time. The prefer policy accepts only a single domain in the set. The parent of the set is consulted if the preferred domain is unavailable. Interleave operates like round-robin with an implementation defined stripe ___ svn-src-all@freebsd.org mailing list https://lists.freebsd.org/mailman/listinfo/svn-src-all To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"
svn commit: r366610 - head/share/man/man3
Author: gbe (doc committer) Date: Sat Oct 10 12:06:39 2020 New Revision: 366610 URL: https://svnweb.freebsd.org/changeset/base/366610 Log: sigevent(3): Fix a typo - asychronous -> asynchronous MFC after:1 week Modified: head/share/man/man3/sigevent.3 Modified: head/share/man/man3/sigevent.3 == --- head/share/man/man3/sigevent.3 Sat Oct 10 12:05:54 2020 (r366609) +++ head/share/man/man3/sigevent.3 Sat Oct 10 12:06:39 2020 (r366610) @@ -34,7 +34,7 @@ .Sh SYNOPSIS .In signal.h .Sh DESCRIPTION -Some operations permit threads to request asychronous notification of events +Some operations permit threads to request asynchronous notification of events via a .Vt struct sigevent structure. ___ svn-src-all@freebsd.org mailing list https://lists.freebsd.org/mailman/listinfo/svn-src-all To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"
svn commit: r366609 - head/share/man/man4
Author: gbe (doc committer) Date: Sat Oct 10 12:05:54 2020 New Revision: 366609 URL: https://svnweb.freebsd.org/changeset/base/366609 Log: dtrace_audit(4): Fix a typo - asynchonously -> asynchronously MFC after:1 week Modified: head/share/man/man4/dtrace_audit.4 Modified: head/share/man/man4/dtrace_audit.4 == --- head/share/man/man4/dtrace_audit.4 Sat Oct 10 09:52:41 2020 (r366608) +++ head/share/man/man4/dtrace_audit.4 Sat Oct 10 12:05:54 2020 (r366609) @@ -119,7 +119,7 @@ remains available for capture by the script. .Pp The .Fn audit:event:aue_*:bsm -probes fire asynchonously from system-call return, following BSM conversion +probes fire asynchronously from system-call return, following BSM conversion and just prior to being written to disk, giving access to four arguments: a .Vt char * audit event name, the ___ svn-src-all@freebsd.org mailing list https://lists.freebsd.org/mailman/listinfo/svn-src-all To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"
svn commit: r366608 - in stable/12: bin/ls sbin/dhclient
Author: gbe (doc committer) Date: Sat Oct 10 09:52:41 2020 New Revision: 366608 URL: https://svnweb.freebsd.org/changeset/base/366608 Log: MFC r366407, r366403 ls(1): Bugfix for an issue reported by mandoc dhclient(8): Bugfixes for some issues reported by mandoc - no blank before trailing delimiter - new sentence, new line Modified: stable/12/bin/ls/ls.1 stable/12/sbin/dhclient/dhclient.leases.5 stable/12/sbin/dhclient/dhcp-options.5 Directory Properties: stable/12/ (props changed) Modified: stable/12/bin/ls/ls.1 == --- stable/12/bin/ls/ls.1 Sat Oct 10 09:50:09 2020(r366607) +++ stable/12/bin/ls/ls.1 Sat Oct 10 09:52:41 2020(r366608) @@ -40,7 +40,7 @@ .Nd list directory contents .Sh SYNOPSIS .Nm -.Op Fl ABCFGHILPRSTUWZabcdfghiklmnopqrstuwxy1, +.Op Fl ABCFGHILPRSTUWZabcdfghiklmnopqrstuwxy1 , .Op Fl -color Ns = Ns Ar when .Op Fl D Ar format .Op Ar Modified: stable/12/sbin/dhclient/dhclient.leases.5 == --- stable/12/sbin/dhclient/dhclient.leases.5 Sat Oct 10 09:50:09 2020 (r366607) +++ stable/12/sbin/dhclient/dhclient.leases.5 Sat Oct 10 09:52:41 2020 (r366608) @@ -54,7 +54,7 @@ the last one in the file is used. The file is written as a log, so this is not an unusual occurrence. .Pp The lease file is named -.Pa dhclient.leases. Ns Ar IFNAME , +.Pa dhclient.leases . Ns Ar IFNAME , where .Ar IFNAME represents the network interface the DHCP client acquired the lease on. @@ -70,7 +70,7 @@ The format of the lease declarations is described in .Xr dhclient.conf 5 . .Sh FILES .Bl -tag -width ".Pa /var/db/dhclient.leases. Ns Ar IFNAME" -.It Pa /var/db/dhclient.leases. Ns Ar IFNAME +.It Pa /var/db/dhclient.leases . Ns Ar IFNAME Current lease file. .El .Sh SEE ALSO Modified: stable/12/sbin/dhclient/dhcp-options.5 == --- stable/12/sbin/dhclient/dhcp-options.5 Sat Oct 10 09:50:09 2020 (r366607) +++ stable/12/sbin/dhclient/dhcp-options.5 Sat Oct 10 09:52:41 2020 (r366608) @@ -267,8 +267,8 @@ This option specifies the domain name that the client resolving hostnames via the Domain Name System. .It Ic option domain-search Ar string ; This option specifies a list of domain names that the client should use -when resolving hostnames via the Domain Name System. This option is -defined in RFC 3397. +when resolving hostnames via the Domain Name System. +This option is defined in RFC 3397. .It Ic option swap-server Ar ip-address ; This specifies the IP address of the client's swap server. .It Ic option root-path Ar string ; ___ svn-src-all@freebsd.org mailing list https://lists.freebsd.org/mailman/listinfo/svn-src-all To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"
svn commit: r366607 - in stable/12/sbin: devd fsdb mdmfs
Author: gbe (doc committer) Date: Sat Oct 10 09:50:09 2020 New Revision: 366607 URL: https://svnweb.freebsd.org/changeset/base/366607 Log: MFC r366408, r366410, r366405 fsdb(8): Fix an issue reported by mandoc mdmfs(8): Fix an issue reported by mandoc devd.conf(5): Bugfix for an issue reported by mandoc - whitespace at end of input line Modified: stable/12/sbin/devd/devd.conf.5 stable/12/sbin/fsdb/fsdb.8 stable/12/sbin/mdmfs/mdmfs.8 Directory Properties: stable/12/ (props changed) Modified: stable/12/sbin/devd/devd.conf.5 == --- stable/12/sbin/devd/devd.conf.5 Sat Oct 10 09:44:56 2020 (r366606) +++ stable/12/sbin/devd/devd.conf.5 Sat Oct 10 09:50:09 2020 (r366607) @@ -532,7 +532,7 @@ keyboard has been pressed. A brightness level change has been requested. Direction is in the $notify variable. .It Li PMU Ta Li keys Ta mute Ta -The mute key +The mute key .It Li PMU Ta Li keys Ta volume Ta A volume level change has been requested. Direction is in the $notify variable. Modified: stable/12/sbin/fsdb/fsdb.8 == --- stable/12/sbin/fsdb/fsdb.8 Sat Oct 10 09:44:56 2020(r366606) +++ stable/12/sbin/fsdb/fsdb.8 Sat Oct 10 09:50:09 2020(r366607) @@ -251,7 +251,7 @@ appeared in written by .An John T. Kohl . It first appeared in -.Fx 2.1.5 +.Fx 2.1.5 ported by Peter Wemm. .Sh BUGS Manipulation of ``short'' symlinks has no effect. Modified: stable/12/sbin/mdmfs/mdmfs.8 == --- stable/12/sbin/mdmfs/mdmfs.8Sat Oct 10 09:44:56 2020 (r366606) +++ stable/12/sbin/mdmfs/mdmfs.8Sat Oct 10 09:50:09 2020 (r366607) @@ -70,7 +70,7 @@ Based on .Ar md-device , the .Nm -utility either creates a +utility either creates a .Xr tmpfs 5 filesystem, or it configures an .Xr md 4 ___ svn-src-all@freebsd.org mailing list https://lists.freebsd.org/mailman/listinfo/svn-src-all To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"
svn commit: r366606 - stable/12/sbin/gvinum
Author: gbe (doc committer) Date: Sat Oct 10 09:44:56 2020 New Revision: 366606 URL: https://svnweb.freebsd.org/changeset/base/366606 Log: MFC r366411: gvinum(8): Fix an issue reported by mandoc - new sentence, new line Modified: stable/12/sbin/gvinum/gvinum.8 Directory Properties: stable/12/ (props changed) Modified: stable/12/sbin/gvinum/gvinum.8 == --- stable/12/sbin/gvinum/gvinum.8 Sat Oct 10 09:43:35 2020 (r366605) +++ stable/12/sbin/gvinum/gvinum.8 Sat Oct 10 09:44:56 2020 (r366606) @@ -202,8 +202,8 @@ Terminate access to the objects, or stop .Nm if no parameters are specified. .It Ic stripe Oo Fl fv Oc Oo Fl n Ar name Oc Ar drives -Create a striped volume from the specified drives. If no name is specified, -a unique name will be set by +Create a striped volume from the specified drives. +If no name is specified, a unique name will be set by .Ic gvinum . This organization requires at least two drives. .El ___ svn-src-all@freebsd.org mailing list https://lists.freebsd.org/mailman/listinfo/svn-src-all To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"
svn commit: r366605 - stable/12/bin/cp
Author: gbe (doc committer) Date: Sat Oct 10 09:43:35 2020 New Revision: 366605 URL: https://svnweb.freebsd.org/changeset/base/366605 Log: MFC 366404: cp(1): Bugfixes for some issues reported by mandoc - no blank before trailing delimiter Modified: stable/12/bin/cp/cp.1 Directory Properties: stable/12/ (props changed) Modified: stable/12/bin/cp/cp.1 == --- stable/12/bin/cp/cp.1 Sat Oct 10 09:42:24 2020(r366604) +++ stable/12/bin/cp/cp.1 Sat Oct 10 09:43:35 2020(r366605) @@ -300,9 +300,9 @@ differ as they copy special files as normal files while recreating a hierarchy. .Pp The -.Fl l, -.Fl s, -.Fl v, +.Fl l , +.Fl s , +.Fl v , .Fl x and .Fl n ___ svn-src-all@freebsd.org mailing list https://lists.freebsd.org/mailman/listinfo/svn-src-all To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"
svn commit: r366604 - stable/12/sbin/veriexec
Author: gbe (doc committer) Date: Sat Oct 10 09:42:24 2020 New Revision: 366604 URL: https://svnweb.freebsd.org/changeset/base/366604 Log: MFC r366409: veriexec(8): Bugfix for an issue reported by mandoc - consider using OS macro: Nx Modified: stable/12/sbin/veriexec/veriexec.8 Directory Properties: stable/12/ (props changed) Modified: stable/12/sbin/veriexec/veriexec.8 == --- stable/12/sbin/veriexec/veriexec.8 Sat Oct 10 09:41:20 2020 (r366603) +++ stable/12/sbin/veriexec/veriexec.8 Sat Oct 10 09:42:24 2020 (r366604) @@ -138,9 +138,8 @@ they are provided for the use of other .Xr mac 4 modules. .Sh HISTORY -The Verified Exec system first appeared in NetBSD. +The Verified Exec system first appeared in +.Nx . This utility derrives from the one found in Junos. The key difference is the requirement that manifest files be digitally signed. - - ___ svn-src-all@freebsd.org mailing list https://lists.freebsd.org/mailman/listinfo/svn-src-all To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"
svn commit: r366603 - stable/12/sbin/camcontrol
Author: gbe (doc committer) Date: Sat Oct 10 09:41:20 2020 New Revision: 366603 URL: https://svnweb.freebsd.org/changeset/base/366603 Log: MFC r366406: camcontrol(8): Bugfixes for some issues reported by mandoc - new sentence, new line Modified: stable/12/sbin/camcontrol/camcontrol.8 Directory Properties: stable/12/ (props changed) Modified: stable/12/sbin/camcontrol/camcontrol.8 == --- stable/12/sbin/camcontrol/camcontrol.8 Sat Oct 10 09:40:03 2020 (r366602) +++ stable/12/sbin/camcontrol/camcontrol.8 Sat Oct 10 09:41:20 2020 (r366603) @@ -1511,10 +1511,10 @@ user. This option can be combined with other options such as .Fl e Em pwd .Pp -A master password may be set in a addition to the user password. The purpose of -the master password is to allow an administrator to establish a password that -is kept secret from the user, and which may be used to unlock the device if the -user password is lost. +A master password may be set in a addition to the user password. +The purpose of the master password is to allow an administrator to establish +a password that is kept secret from the user, and which may be used to unlock +the device if the user password is lost. .Pp .Em Note: Setting the master password does not enable device security. @@ -2528,7 +2528,8 @@ whether it is enabled and what the timer value is. .It Ic timestamp Issue REPORT TIMESTAMP or SET TIMESTAMP .Tn SCSI -commands. Either the +commands. +Either the .Fl r option or the .Fl s @@ -2552,7 +2553,8 @@ time, but override the system time zone and use UTC in .El .Bl -tag -width 6n .It Fl s -Set the device's timestamp. Either the +Set the device's timestamp. +Either the .Fl f and .Fl T ___ svn-src-all@freebsd.org mailing list https://lists.freebsd.org/mailman/listinfo/svn-src-all To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"
svn commit: r366602 - stable/12/usr.bin/cpuset
Author: gbe (doc committer) Date: Sat Oct 10 09:40:03 2020 New Revision: 366602 URL: https://svnweb.freebsd.org/changeset/base/366602 Log: MFC r366414: cpuset(1): Fix some issues reported by mandoc - whitespace at end of input line - new sentence, new line Modified: stable/12/usr.bin/cpuset/cpuset.1 Directory Properties: stable/12/ (props changed) Modified: stable/12/usr.bin/cpuset/cpuset.1 == --- stable/12/usr.bin/cpuset/cpuset.1 Sat Oct 10 08:02:23 2020 (r366601) +++ stable/12/usr.bin/cpuset/cpuset.1 Sat Oct 10 09:40:03 2020 (r366602) @@ -34,24 +34,24 @@ .Sh SYNOPSIS .Nm .Op Fl l Ar cpu-list -.Op Fl n Ar policy:domain-list +.Op Fl n Ar policy:domain-list .Op Fl s Ar setid .Ar cmd ... .Nm .Op Fl l Ar cpu-list -.Op Fl n Ar policy:domain-list +.Op Fl n Ar policy:domain-list .Op Fl s Ar setid .Fl p Ar pid .Nm .Op Fl c .Op Fl l Ar cpu-list -.Op Fl n Ar policy:domain-list +.Op Fl n Ar policy:domain-list .Fl C .Fl p Ar pid .Nm .Op Fl c .Op Fl l Ar cpu-list -.Op Fl n Ar policy:domain-list +.Op Fl n Ar policy:domain-list .Op Fl j Ar jail | Fl p Ar pid | Fl t Ar tid | Fl s Ar setid | Fl x Ar irq .Nm .Fl g @@ -97,8 +97,8 @@ This last set is the list of all possible CPUs in the queried using .Fl r . .Pp -Most sets include NUMA memory domain and policy information. This can be -inspected with +Most sets include NUMA memory domain and policy information. +This can be inspected with .Fl g and set with .Fl n . @@ -124,8 +124,8 @@ Create a new cpuset and assign the target process to t The requested operation should reference the cpuset available via the target specifier. .It Fl d Ar domain -Specifies a NUMA domain id as the target of the operation. This can only -be used to query the cpus visible in each numberd domain. +Specifies a NUMA domain id as the target of the operation. +This can only be used to query the cpus visible in each numberd domain. .It Fl g Causes .Nm @@ -146,8 +146,8 @@ A special list of .Dq all may be specified in which case the list includes all CPUs from the root set. .It Fl n Ar policy:domain-list -Specifies a list of domains and allocation policy to apply to a target. Ranges -may be specified as in +Specifies a list of domains and allocation policy to apply to a target. +Ranges may be specified as in .Fl l . Valid policies include first-touch (ft), round-robin (rr), prefer and interleave (il). ___ svn-src-all@freebsd.org mailing list https://lists.freebsd.org/mailman/listinfo/svn-src-all To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"
svn commit: r366583 - in head: lib/libc/capability lib/libc/sys lib/libgssapi lib/libmd lib/libmt lib/libpathconv lib/libpmc lib/libradius lib/librpcsec_gss lib/libsysdecode lib/libusb lib/libutil ...
Author: gbe (doc committer) Date: Fri Oct 9 19:12:44 2020 New Revision: 366583 URL: https://svnweb.freebsd.org/changeset/base/366583 Log: Fix a few mandoc issues - skipping paragraph macro: Pp after Sh - sections out of conventional order: Sh EXAMPLES - whitespace at end of input line - normalizing date format Modified: head/lib/libc/capability/cap_rights_init.3 head/lib/libc/sys/cpuset_getaffinity.2 head/lib/libc/sys/cpuset_getdomain.2 head/lib/libc/sys/fhlink.2 head/lib/libc/sys/getitimer.2 head/lib/libc/sys/getsockopt.2 head/lib/libgssapi/gss_accept_sec_context.3 head/lib/libmd/mdX.3 head/lib/libmd/ripemd.3 head/lib/libmd/sha.3 head/lib/libmd/sha256.3 head/lib/libmd/sha512.3 head/lib/libmd/skein.3 head/lib/libmt/mt.3 head/lib/libpathconv/abs2rel.3 head/lib/libpmc/pmc.sandybridge.3 head/lib/libpmc/pmc.sandybridgeuc.3 head/lib/libradius/libradius.3 head/lib/librpcsec_gss/rpc_gss_set_callback.3 head/lib/libsysdecode/sysdecode_mask.3 head/lib/libusb/libusb20.3 head/lib/libutil/login_ok.3 head/lib/msun/man/sincos.3 head/share/man/man4/fdt_pinctrl.4 head/share/man/man4/ig4.4 head/share/man/man4/man4.i386/ce.4 head/share/man/man4/mlx5io.4 head/share/man/man4/mrsas.4 head/share/man/man4/ng_pppoe.4 head/share/man/man4/qlxgbe.4 head/share/man/man4/rtwn.4 head/share/man/man4/sa.4 head/share/man/man4/smartpqi.4 head/share/man/man4/spigen.4 head/share/man/man4/syscons.4 head/share/man/man4/udbp.4 head/share/man/man9/OF_finddevice.9 head/share/man/man9/backlight.9 head/share/man/man9/vnet.9 head/usr.bin/dpv/dpv.1 head/usr.bin/indent/indent.1 head/usr.bin/localedef/localedef.1 head/usr.bin/mkimg/mkimg.1 head/usr.sbin/bsnmpd/tools/bsnmptools/bsnmpget.1 head/usr.sbin/camdd/camdd.8 head/usr.sbin/mlx5tool/mlx5tool.8 head/usr.sbin/nfsd/pnfsserver.4 head/usr.sbin/zonectl/zonectl.8 Modified: head/lib/libc/capability/cap_rights_init.3 == --- head/lib/libc/capability/cap_rights_init.3 Fri Oct 9 19:10:00 2020 (r366582) +++ head/lib/libc/capability/cap_rights_init.3 Fri Oct 9 19:12:44 2020 (r366583) @@ -239,7 +239,7 @@ The functions .Fn cap_rights_is_set , .Fn cap_rights_is_valid , .Fn cap_rights_merge , -.Fn cap_rights_remove +.Fn cap_rights_remove and .Fn cap_rights_contains first appeared in Modified: head/lib/libc/sys/cpuset_getaffinity.2 == --- head/lib/libc/sys/cpuset_getaffinity.2 Fri Oct 9 19:10:00 2020 (r366582) +++ head/lib/libc/sys/cpuset_getaffinity.2 Fri Oct 9 19:12:44 2020 (r366583) @@ -149,7 +149,7 @@ was either preposterously large or smaller than the ke The calling process did not have the credentials required to complete the operation. .It Bq Er ECAPMODE -The calling process attempted to act on a process other than itself, while +The calling process attempted to act on a process other than itself, while in capability mode. See .Xr capsicum 4 . Modified: head/lib/libc/sys/cpuset_getdomain.2 == --- head/lib/libc/sys/cpuset_getdomain.2Fri Oct 9 19:10:00 2020 (r366582) +++ head/lib/libc/sys/cpuset_getdomain.2Fri Oct 9 19:12:44 2020 (r366583) @@ -119,7 +119,8 @@ Memory is allocated on a round-robin basis by cycling .Fa mask . .It Dv DOMAINSET_POLICY_FIRSTTOUCH Memory is allocated on the domain local to the CPU the requesting thread is -running on. Failure to allocate from this domain will fallback to round-robin. +running on. +Failure to allocate from this domain will fallback to round-robin. .It Dv DOMAINSET_POLICY_PREFER Memory is allocated preferentially from the single domain specified in the mask. If memory is unavailable the domains listed in the parent cpuset will be @@ -167,7 +168,7 @@ was either preposterously large or smaller than the ke The calling process did not have the credentials required to complete the operation. .It Bq Er ECAPMODE -The calling process attempted to act on a process other than itself, while +The calling process attempted to act on a process other than itself, while in capability mode. See .Xr capsicum 4 . Modified: head/lib/libc/sys/fhlink.2 == --- head/lib/libc/sys/fhlink.2 Fri Oct 9 19:10:00 2020(r366582) +++ head/lib/libc/sys/fhlink.2 Fri Oct 9 19:12:44 2020(r366583) @@ -178,7 +178,7 @@ The link count of the file pointed at by .Fa fhp would exceed 32767. .It Bq Er EACCES -A component of +A component of .Fa to prefix denies search permission. .It Bq Er EACCES Modified: head/lib/libc/sys/getitimer.2 == --- head/lib/libc/sys/getitimer.2 Fri Oct 9 19:10
svn commit: r366580 - head/share/man/man4
Author: gbe (doc committer) Date: Fri Oct 9 15:50:50 2020 New Revision: 366580 URL: https://svnweb.freebsd.org/changeset/base/366580 Log: bpf(4): Update the man page to reflect reality PR: 131918 Submitted by: guy at alum dot mit dot edu Reviewed by: gnn, gbe Approved by: gnn MFC after:2 weeks Differential Revision:https://reviews.freebsd.org/D25993 Modified: head/share/man/man4/bpf.4 Modified: head/share/man/man4/bpf.4 == --- head/share/man/man4/bpf.4 Fri Oct 9 15:45:34 2020(r366579) +++ head/share/man/man4/bpf.4 Fri Oct 9 15:50:50 2020(r366580) @@ -49,7 +49,7 @@ .\" .\" $FreeBSD$ .\" -.Dd October 21, 2016 +.Dd October 9, 2020 .Dt BPF 4 .Os .Sh NAME @@ -73,12 +73,6 @@ ioctl. A given interface can be shared by multiple listeners, and the filter underlying each descriptor will see an identical packet stream. .Pp -A separate device file is required for each minor device. -If a file is in use, the open will fail and -.Va errno -will be set to -.Er EBUSY . -.Pp Associated with each open instance of a .Nm file is a user-settable packet filter. @@ -86,19 +80,6 @@ Whenever a packet is received by an interface, all file descriptors listening on that interface apply their filter. Each descriptor that accepts the packet receives its own copy. .Pp -The packet filter will support any link level protocol that has fixed length -headers. -Currently, only Ethernet, -.Tn SLIP , -and -.Tn PPP -drivers have been modified to interact with -.Nm . -.Pp -Since packet data is in network byte order, applications should use the -.Xr byteorder 3 -macros to extract multi-byte values. -.Pp A packet can be sent out on the network by writing to a .Nm file descriptor. @@ -313,7 +294,7 @@ with If the requested buffer size cannot be accommodated, the closest allowable size will be set and returned in the argument. A read call will result in -.Er EIO +.Er EINVAL if it is passed a buffer that is not this size. .It Dv BIOCGDLT .Pq Li u_int @@ -324,6 +305,43 @@ The device types, prefixed with .Dq Li DLT_ , are defined in .In net/bpf.h . +.It Dv BIOCGDLTLIST +.Pq Li "struct bpf_dltlist" +Returns an array of the available types of the data link layer +underlying the attached interface: +.Bd -literal -offset indent +struct bpf_dltlist { + u_int bfl_len; + u_int *bfl_list; +}; +.Ed +.Pp +The available types are returned in the array pointed to by the +.Va bfl_list +field while their length in u_int is supplied to the +.Va bfl_len +field. +.Er ENOMEM +is returned if there is not enough buffer space and +.Er EFAULT +is returned if a bad address is encountered. +The +.Va bfl_len +field is modified on return to indicate the actual length in u_int +of the array returned. +If +.Va bfl_list +is +.Dv NULL , +the +.Va bfl_len +field is set to indicate the required length of an array in u_int. +.It Dv BIOCSDLT +.Pq Li u_int +Changes the type of the data link layer underlying the attached interface. +.Er EINVAL +is returned if no interface has been specified or the specified +type is not available for the interface. .It Dv BIOCPROMISC Forces the interface into promiscuous mode. All packets, not just those destined for the local host, are processed. @@ -331,6 +349,9 @@ Since more than one file can be listening on a given i a listener that opened its interface non-promiscuously may receive packets promiscuously. This problem can be remedied with an appropriate filter. +.Pp +The interface remains in promiscuous mode until all files listening +promiscuously are closed. .It Dv BIOCFLUSH Flushes the buffer of incoming packets, and resets the statistics that are returned by BIOCGSTATS. @@ -344,7 +365,7 @@ structure. All other fields are undefined. .It Dv BIOCSETIF .Pq Li "struct ifreq" -Sets the hardware interface associate with the file. +Sets the hardware interface associated with the file. This command must be performed before any packets can be read. The device is indicated by name using the @@ -357,7 +378,7 @@ Additionally, performs the actions of .It Dv BIOCSRTIMEOUT .It Dv BIOCGRTIMEOUT .Pq Li "struct timeval" -Set or get the read timeout parameter. +Sets or gets the read timeout parameter. The argument specifies the length of time to wait before timing out on a read request. @@ -387,7 +408,7 @@ kernel because of buffer overflows .El .It Dv BIOCIMMEDIATE .Pq Li u_int -Enable or disable +Enables or disables .Dq immediate mode , based on the truth value of the argument. When immediate mode is enabled, reads return immediately upon packet @@ -407,7 +428,7 @@ An array of instructions and its length is passed in u the following structure: .Bd -literal struct bpf_program { - int bf_len; + u_int bf_len; struct bpf_insn *bf_insns; }; .Ed @@ -469,10 +490,18 @@ An incompatible filter may result in undefined behavior (most likely, an er
svn commit: r366575 - in head: libexec/rtld-elf share/man/man4 share/man/man4/man4.i386 share/man/man4/man4.powerpc stand/defaults stand/forth tools/tools/ether_reflect tools/tools/vimage
Author: gbe (doc committer) Date: Fri Oct 9 15:14:19 2020 New Revision: 366575 URL: https://svnweb.freebsd.org/changeset/base/366575 Log: Fix a few mandoc issues - whitespace at end of input line - skipping paragraph macro: Pp at the end of Sh - new sentence, new line - consider using OS macro: Fx - AUTHORS section without An macro - skipping paragraph macro: Pp before Ss Modified: head/libexec/rtld-elf/rtld.1 head/share/man/man4/acpi_ibm.4 head/share/man/man4/man4.i386/glxiic.4 head/share/man/man4/man4.powerpc/smu.4 head/share/man/man4/ng_checksum.4 head/stand/defaults/loader.conf.5 head/stand/forth/beastie.4th.8 head/stand/forth/brand.4th.8 head/tools/tools/ether_reflect/ether_reflect.1 head/tools/tools/vimage/vimage.8 Modified: head/libexec/rtld-elf/rtld.1 == --- head/libexec/rtld-elf/rtld.1Fri Oct 9 14:45:41 2020 (r366574) +++ head/libexec/rtld-elf/rtld.1Fri Oct 9 15:14:19 2020 (r366575) @@ -360,7 +360,7 @@ In the direct execution mode, .Nm emulates verification of the binary execute permission for the current user. -This is done to avoid breaking user expectations in naively restricted +This is done to avoid breaking user expectations in naively restricted execution environments. The verification only uses Unix .Dv DACs , Modified: head/share/man/man4/acpi_ibm.4 == --- head/share/man/man4/acpi_ibm.4 Fri Oct 9 14:45:41 2020 (r366574) +++ head/share/man/man4/acpi_ibm.4 Fri Oct 9 15:14:19 2020 (r366575) @@ -274,7 +274,7 @@ Speaker volume. .It Va dev.acpi_ibm.0.mute Indicates, whether the speakers are muted or not. .It Va dev.acpi_ibm.0.mic_mute -Indicates, whether the microphone led (present on some model) is on or not. +Indicates, whether the microphone led (present on some model) is on or not. Note that this does not mean that the microphone input is muted. .It Va dev.acpi_ibm.0.thinklight Indicates, whether the ThinkLight keyboard light is activated or not. @@ -452,8 +452,8 @@ case ${NOTIFY} in if [ $LEVEL -eq 0 ]; then sysctl dev.acpi_ibm.0.mic_led=1 mixer rec 0 - fi - if [ $LEVEL -eq 1 ]; then + fi + if [ $LEVEL -eq 1 ]; then sysctl dev.acpi_ibm.0.mic_led=0 mixer rec 30 fi Modified: head/share/man/man4/man4.i386/glxiic.4 == --- head/share/man/man4/man4.i386/glxiic.4 Fri Oct 9 14:45:41 2020 (r366574) +++ head/share/man/man4/man4.i386/glxiic.4 Fri Oct 9 15:14:19 2020 (r366575) @@ -50,8 +50,8 @@ glxiic_load="YES" The .Nm driver supports the System Management Bus controller of the Geode LX -series CS5536 Companion Device. The Geode LX is a member of the AMD -Geode family of integrated x86 system chips. +series CS5536 Companion Device. +The Geode LX is a member of the AMD Geode family of integrated x86 system chips. .Pp Although AMD refers to this device as a System Management Bus (SMBus) controller, it is really an I2C controller (it lacks SMBus ALERT# and @@ -70,17 +70,18 @@ and tunable: .Bl -tag -width indent .It Va dev.glxiic.0.timeout -This variable controls the I2C bus timeout in milliseconds. The -default timeout is 35 milliseconds. A value of zero disables the -timeout. +This variable controls the I2C bus timeout in milliseconds. +The default timeout is 35 milliseconds. +A value of zero disables the timeout. .El .Sh CAVEAT The .Nm driver uses the interrupt line number configured by the board firmware -by default. If no interrupt line number has been configured by the -board firmware (or to override the interrupt line number configured by -board firmware), place the following line in +by default. +If no interrupt line number has been configured by the board firmware +(or to override the interrupt line number configured by board firmware), +place the following line in .Xr device.hints 5 : .Bd -ragged -offset indent hint.glxiic.0.irq="10" Modified: head/share/man/man4/man4.powerpc/smu.4 == --- head/share/man/man4/man4.powerpc/smu.4 Fri Oct 9 14:45:41 2020 (r366574) +++ head/share/man/man4/man4.powerpc/smu.4 Fri Oct 9 15:14:19 2020 (r366575) @@ -60,45 +60,47 @@ Apple System Management Unit .Sh THERMAL MANAGEMENT The .Nm -driver provides basic automatic thermal management. Without a userspace -daemon providing more advanced control, the driver will attempt to maintain -system temperatures in a conservative range through coarse-grained control of -system cooling devices (see below). Automatic kernel-level thermal control -wi
svn commit: r366572 - in head: sbin/devmatch sbin/fsck sbin/ifconfig sbin/mount_msdosfs usr.bin/chat usr.bin/du usr.bin/setchannel usr.bin/tftp usr.sbin/ctladm usr.sbin/extattrctl usr.sbin/i2c usr....
Author: gbe (doc committer) Date: Fri Oct 9 14:03:45 2020 New Revision: 366572 URL: https://svnweb.freebsd.org/changeset/base/366572 Log: Fix a few mandoc issues - no blank before trailing delimiter - whitespace at end of input line - sections out of conventional order - normalizing date format - AUTHORS section without An macro Modified: head/sbin/devmatch/devmatch.8 head/sbin/fsck/fsck.8 head/sbin/ifconfig/ifconfig.8 head/sbin/mount_msdosfs/mount_msdosfs.8 head/usr.bin/chat/chat.8 head/usr.bin/du/du.1 head/usr.bin/setchannel/setchannel.1 head/usr.bin/tftp/tftp.1 head/usr.sbin/ctladm/ctladm.8 head/usr.sbin/extattrctl/extattrctl.8 head/usr.sbin/i2c/i2c.8 head/usr.sbin/mountd/exports.5 head/usr.sbin/nfsuserd/nfsuserd.8 head/usr.sbin/pmcstudy/pmcstudy.8 head/usr.sbin/traceroute6/traceroute6.8 Modified: head/sbin/devmatch/devmatch.8 == --- head/sbin/devmatch/devmatch.8 Fri Oct 9 13:11:14 2020 (r366571) +++ head/sbin/devmatch/devmatch.8 Fri Oct 9 14:03:45 2020 (r366572) @@ -69,6 +69,8 @@ Produce more verbose output. .Sh SEE ALSO .Xr devinfo 8 , .Xr MODULE_PNP_INFO 9 +.Sh AUTHORS +.An Warner Losh Aq Mt i...@freebsd.org .Sh BUGS The kernel has hints in it, but we exclude it from the list of modules to suggest for unmatched devices. @@ -92,5 +94,3 @@ logical equivalent in USB, PCI, and others. .Pp Many drivers currently lack proper PNP table decorations and need to be updated. -.Sh AUTHORS -.An Warner Losh Aq Mt i...@freebsd.org Modified: head/sbin/fsck/fsck.8 == --- head/sbin/fsck/fsck.8 Fri Oct 9 13:11:14 2020(r366571) +++ head/sbin/fsck/fsck.8 Fri Oct 9 14:03:45 2020(r366572) @@ -143,7 +143,7 @@ only if is compiled to support it. .It Fl f Force checking of file systems. -Running +Running .Dq Li fsck -f ignores the journal and does a full consistency check of the disk so will find and fix the errors about which the Modified: head/sbin/ifconfig/ifconfig.8 == --- head/sbin/ifconfig/ifconfig.8 Fri Oct 9 13:11:14 2020 (r366571) +++ head/sbin/ifconfig/ifconfig.8 Fri Oct 9 14:03:45 2020 (r366572) @@ -592,7 +592,7 @@ Note that this must be configured on a physical interf not on a .Xr vlan 4 interface itself. -.It Fl vlanmtu , vlanhwtag, vlanhwfilter, vlanhwtso +.It Fl vlanmtu , vlanhwtag , vlanhwfilter , vlanhwtso If the driver offers user-configurable VLAN support, disable reception of extended frames, tag processing in hardware, frame filtering in hardware, or TSO on VLAN, Modified: head/sbin/mount_msdosfs/mount_msdosfs.8 == --- head/sbin/mount_msdosfs/mount_msdosfs.8 Fri Oct 9 13:11:14 2020 (r366571) +++ head/sbin/mount_msdosfs/mount_msdosfs.8 Fri Oct 9 14:03:45 2020 (r366572) @@ -202,7 +202,7 @@ and first appeared in was renamed to the more aptly-named .Nm in -.Fx 5.0. +.Fx 5.0 . The character code conversion routine was added in 2003. .Sh AUTHORS Initial implementation as Modified: head/usr.bin/chat/chat.8 == --- head/usr.bin/chat/chat.8Fri Oct 9 13:11:14 2020(r366571) +++ head/usr.bin/chat/chat.8Fri Oct 9 14:03:45 2020(r366572) @@ -291,7 +291,8 @@ The .Dv SAY strings could be used to give progress messages in sections of the script where you want to have 'ECHO OFF' but still let the user -know what is happening. An example is: +know what is happening. +An example is: .Bd -literal -offset indent ABORT BUSY ECHO OFF Modified: head/usr.bin/du/du.1 == --- head/usr.bin/du/du.1Fri Oct 9 13:11:14 2020(r366571) +++ head/usr.bin/du/du.1Fri Oct 9 14:03:45 2020(r366572) @@ -63,7 +63,7 @@ Calculate block counts in .Ar blocksize byte blocks. This is different from the -.Fl h, k, m, +.Fl h , k , m , .Fl Fl si and .Fl g @@ -172,7 +172,7 @@ options override each other and the command's actions by the last one specified. .Pp The -.Fl h, k, m +.Fl h , k , m and .Fl Fl si options all override each other; the last one specified determines @@ -183,7 +183,7 @@ the block counts used. If the environment variable .Ev BLOCKSIZE is set, and the -.Fl h, k, m +.Fl h , k , m or .Fl Fl si options are not specified, the block counts will be displayed in units of @@ -191,7 +191,7 @@ that block size. If .Ev BLOCKSIZE is not set, and the -.Fl h, k, m +.Fl h , k , m or .Fl Fl si options are not specified, the block counts will be displayed in 512-byte Modified: head/usr.bin/setchannel/setchannel.1 =
svn commit: r366481 - head/share/man/man3
Author: gbe (doc committer) Date: Tue Oct 6 10:51:47 2020 New Revision: 366481 URL: https://svnweb.freebsd.org/changeset/base/366481 Log: intro(3): Update the list of included libraries - Extend the list of main libraries of section 3 - Extend the library functions that are included in the libc MFC after:2 weeks Submitted by: Naga Chaitanya Vellanki Approved by: gbe Differential Revision:https://reviews.freebsd.org/D26476 Modified: head/share/man/man3/intro.3 Modified: head/share/man/man3/intro.3 == --- head/share/man/man3/intro.3 Tue Oct 6 10:41:04 2020(r366480) +++ head/share/man/man3/intro.3 Tue Oct 6 10:51:47 2020(r366481) @@ -28,12 +28,17 @@ .\" @(#)intro.38.1 (Berkeley) 6/5/93 .\" $FreeBSD$ .\" -.Dd March 22, 2017 +.Dd October 6, 2020 .Dt INTRO 3 .Os .Sh NAME .Nm intro .Nd introduction to the C libraries +.Sh SYNOPSIS +.Nm cc +.Op Ar flags +.Ar +.Op Fl llibrary .Sh DESCRIPTION This section provides an overview of the C library functions, their error returns and other @@ -47,7 +52,11 @@ must be indicated at compile time with the option of the compiler. .Pp The various libraries (followed by the loader flag): -.Bl -tag -width "libc (-lc)" +.Bl -tag -width "libbluetooth (-lbluetooth)" +.It Em libbluetooth Pq Fl l Ns Ar bluetooth +The bluetooth library. +See +.Xr bluetooth 3 . .It Em libc Pq Fl l Ns Ar c Standard C library functions. When using the C compiler @@ -57,21 +66,58 @@ to supply the loader flag .Fl l Ns Ar c for these functions. There are several `libraries' or groups of functions included inside of -.Em libc -: the standard -.Tn I/O -routines, -database routines, -bit operators, -string operators, -character tests and character operators, -des encryption routines, -storage allocation, time functions, signal handling and more. +.Em libc : +.Bl -tag -width "XX" +.It standard I/O routines +see +.Xr stdio 3 +.It database routines +see +.Xr db 3 +.It bit operators +see +.Xr bitstring 3 +.It string operators +see +.Xr string 3 +.It character tests and character operators +.It storage allocation +see +.Xr mpool 3 +.It regular-expressions +see +.Xr regex 3 +.It remote procedure calls (RPC) +see +.Xr rpc 3 +.It time functions +see +.Xr time 3 +.It signal handling +see +.Xr signal 3 +.El +.It Em libcalendar Pq Fl l Ns Ar calendar +The calendar arithmetic library. +See +.Xr calendar 3 . +.It Em libcam Pq Fl l Ns Ar cam +The common access method user library. +See +.Xr cam 3 . +.It Em libcrypt Pq Fl l Ns Ar crypt +The crypt library. +See +.Xr crypt 3 . .It Em libcurses Pq Fl l Ns Ar curses Fl l Ns Ar termcap Terminal independent screen management routines for two dimensional non-bitmap display terminals. -(See -.Xr ncurses 3 . ) +See +.Xr ncurses 3 . +.It Em libcuse Pq Fl l Ns Ar cuse +The userland character device library. +See +.Xr cuse 3 . .It Em libcompat Pq Fl l Ns Ar compat Functions which are obsolete but are available for compatibility with .Bx 4.3 . @@ -82,32 +128,106 @@ have been included for source code compatibility. Use of these routines should, for the most part, be avoided. The manual page entry for each compatibility routine indicates the proper interface to use. +.It Em libdevinfo Pq Fl l Ns Ar devinfo +The Device and Resource Information Utility library. +See +.Xr devinfo 3 . +.It Em libdevstat Pq Fl l Ns Ar devstat +The Device Statistics library. +See +.Xr devstat 3 . +.It Em libdwarf Pq Fl l Ns Ar dwarf +The DWARF access library. +See +.Xr dwarf 3 . +.It Em libelf Pq Fl l Ns Ar elf +The ELF access library. +See +.Xr elf 3 . +.It Em libfetch Pq Fl l Ns Ar fetch +The file transfer library. +See +.Xr fetch 3 . +.It Em libfigpar Pq Fl l Ns Ar figpar +The configuration file parsing library. +See +.Xr figpar 3 . +.It Em libgpio Pq Fl l Ns Ar gpio +The general-purpose input output library (GPIO). +See +.Xr gpio 3 . +.It Em libgssapi Pq Fl l Ns Ar gssapi +The generic security service application programming +interface. +See +.Xr gssapi 3 . +.It Em libjail Pq Fl l Ns Ar jail +The jail library. +See +.Xr jail 3 . .It Em libkvm Pq Fl l Ns Ar kvm Functions used to access kernel memory are in this library. They can be used against both a running system and a crash dump. -(See -.Xr kvm 3 . ) +See +.Xr kvm 3 . .It Em libl Pq Fl l Ns Ar l The library for .Xr lex 1 . .It Em libm Pq Fl l Ns Ar m -The math library, -.Em libm . -The math library is loaded as needed by the Pascal compiler, -but not by the C compiler which requires the -.Fl l Ns Ar m -flag. -(See -.Xr math 3 . ) +The math library. +See +.Xr math 3 . +.It Em libmd Pq Fl l Ns Ar md +The message digest library. +See +.Xr md4 3 , +.Xr md5 3 , +.Xr sha 3 , +.Xr sha256 3 , +.Xr sha512 3 , +.Xr ripemd 3 , +.Xr skein 3 . .It Em libmp Pq Fl l Ns Ar mp +.It Em libpam Pq Fl l Ns Ar pam +The pluggable authentication module library. +See +.Xr pam 3 . +.It Em libpcap Pq Fl