svn commit: r368748 - stable/12/usr.bin/locate/locate

2020-12-17 Thread Guangyuan Yang
Author: ygy (doc committer)
Date: Fri Dec 18 02:41:12 2020
New Revision: 368748
URL: https://svnweb.freebsd.org/changeset/base/368748

Log:
  MFC r368550:
  
  Fix a grammar error on locate(1).
  
  While here, also fix a useless .Tn reported by mandoc.
  
  PR:   251746
  Sumbitted by: David Schlachter 

Modified:
  stable/12/usr.bin/locate/locate/locate.1
Directory Properties:
  stable/12/   (props changed)

Modified: stable/12/usr.bin/locate/locate/locate.1
==
--- stable/12/usr.bin/locate/locate/locate.1Fri Dec 18 00:38:48 2020
(r368747)
+++ stable/12/usr.bin/locate/locate/locate.1Fri Dec 18 02:41:12 2020
(r368748)
@@ -29,7 +29,7 @@
 .\"@(#)locate.18.1 (Berkeley) 6/6/93
 .\" $FreeBSD$
 .\"
-.Dd August 17, 2006
+.Dd December 11, 2020
 .Dt LOCATE 1
 .Os
 .Sh NAME
@@ -75,7 +75,7 @@ is matched as though it were
 .Pp
 Historically, locate only stored characters between 32 and 127.
 The
-current implementation store any character except newline
+current implementation stores any character except newline
 .Pq Sq \en
 and
 .Dv NUL
@@ -88,8 +88,7 @@ are stored in 2 bytes.
 The following options are available:
 .Bl -tag -width 10n
 .It Fl 0
-Print pathnames separated by an
-.Tn ASCII
+Print pathnames separated by an ASCII
 .Dv NUL
 character (character code 0) instead of default NL
 (newline, character code 10).
___
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: r368550 - head/usr.bin/locate/locate

2020-12-11 Thread Guangyuan Yang
Author: ygy (doc committer)
Date: Fri Dec 11 08:04:54 2020
New Revision: 368550
URL: https://svnweb.freebsd.org/changeset/base/368550

Log:
  Fix a grammar error on locate(1).
  
  While here, also fix a useless .Tn reported by mandoc.
  
  PR:   251746
  MFC after:1 week
  Sumbitted by: David Schlachter 

Modified:
  head/usr.bin/locate/locate/locate.1

Modified: head/usr.bin/locate/locate/locate.1
==
--- head/usr.bin/locate/locate/locate.1 Fri Dec 11 04:02:19 2020
(r368549)
+++ head/usr.bin/locate/locate/locate.1 Fri Dec 11 08:04:54 2020
(r368550)
@@ -29,7 +29,7 @@
 .\"@(#)locate.18.1 (Berkeley) 6/6/93
 .\" $FreeBSD$
 .\"
-.Dd August 17, 2006
+.Dd December 11, 2020
 .Dt LOCATE 1
 .Os
 .Sh NAME
@@ -75,7 +75,7 @@ is matched as though it were
 .Pp
 Historically, locate only stored characters between 32 and 127.
 The
-current implementation store any character except newline
+current implementation stores any character except newline
 .Pq Sq \en
 and
 .Dv NUL
@@ -88,8 +88,7 @@ are stored in 2 bytes.
 The following options are available:
 .Bl -tag -width 10n
 .It Fl 0
-Print pathnames separated by an
-.Tn ASCII
+Print pathnames separated by an ASCII
 .Dv NUL
 character (character code 0) instead of default NL
 (newline, character code 10).
___
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: r346111 - stable/12/share/man/man4

2019-09-03 Thread Guangyuan Yang
Author: ygy (doc committer)
Date: Thu Apr 11 00:41:07 2019
New Revision: 346111
URL: https://svnweb.freebsd.org/changeset/base/346111

Log:
  MFC r345887:
  
  Rewrite intro(4) man page.
  
  - Remove issues that no longer apply thanks to devfs
  - Add language pointing out devfs's role and referencing its config
  - Add a "historical notes" section and move discussion of block vs character 
devs to it, including pointing out the removal of block devs
  - Modernize some examples
  
  PR:   236970
  Submitted by: and...@tao173.riddles.org.uk
  Reviewed by:  0mp
  Differential Revision:https://reviews.freebsd.org/D19799

Modified:
  stable/12/share/man/man4/intro.4
Directory Properties:
  stable/12/   (props changed)

Modified: stable/12/share/man/man4/intro.4
==
--- stable/12/share/man/man4/intro.4Thu Apr 11 00:39:06 2019
(r346110)
+++ stable/12/share/man/man4/intro.4Thu Apr 11 00:41:07 2019
(r346111)
@@ -1,5 +1,6 @@
 .\"
 .\" Copyright (c) 1996 David E. O'Brien, Joerg Wunsch
+.\" Copyright (c) 2019 Andrew Gierth
 .\"
 .\" All rights reserved.
 .\"
@@ -25,7 +26,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd January 20, 1996
+.Dd April 3, 2019
 .Dt INTRO 4
 .Os
 .Sh NAME
@@ -45,14 +46,13 @@ without any particular underlying hardware.
 A typical example for
 the latter class is
 .Pa /dev/mem ,
-a loophole where the physical memory can be accessed using the regular
-file access semantics.
+a mechanism whereby the physical memory can be accessed using file
+access semantics.
 .Pp
-The device abstraction generally provides a common set of system calls
-layered on top of them, which are dispatched to the corresponding
-device driver by the upper layers of the kernel.
-The set of system
-calls available for devices is chosen from
+The device abstraction generally provides a common set of system
+calls, which are dispatched to the corresponding device driver by the
+upper layers of the kernel.
+The set of system calls available for devices is chosen from
 .Xr open 2 ,
 .Xr close 2 ,
 .Xr read 2 ,
@@ -61,77 +61,56 @@ calls available for devices is chosen from
 .Xr select 2 ,
 and
 .Xr mmap 2 .
-Not all drivers implement all system calls, for example, calling
+Not all drivers implement all system calls; for example, calling
 .Xr mmap 2
-on terminal devices is likely to be not useful at all.
+on a keyboard device is not likely to be useful.
+.Pp
+Aspects of the device abstraction have changed significantly in
+.Fx
+over the past two decades.
+The section
+.Sx Historical Notes
+describes some of the more important differences.
 .Ss Accessing Devices
-Most of the devices in a
-.Ux Ns
--like operating system are accessed
-through so-called
+Most of the devices in
+.Fx
+are accessed through
 .Em device nodes ,
 sometimes also called
 .Em special files .
-They are usually located under the directory
+They are located within instances of the
+.Xr devfs 5
+filesystem, which is conventionally mounted on the directory
 .Pa /dev
 in the file system hierarchy
 (see also
 .Xr hier 7 ) .
 .Pp
-Note that this could lead to an inconsistent state, where either there
-are device nodes that do not have a configured driver associated with
-them, or there may be drivers that have successfully probed for their
-devices, but cannot be accessed since the corresponding device node is
-still missing.
-In the first case, any attempt to reference the device
-through the device node will result in an error, returned by the upper
-layers of the kernel, usually
-.Er ENXIO .
-In the second case, the device node needs to be created before the
-driver and its device will be usable.
+The
+.Xr devfs 5
+filesystem creates or removes device nodes automatically according to
+the physical hardware recognized as present at any given time.
+For pseudo-devices, device nodes may be created and removed dynamically
+as required, depending on the nature of the device.
 .Pp
-Some devices come in two flavors:
-.Em block
-and
-.Em character
-devices, or to use better terms, buffered and unbuffered
-(raw)
-devices.
-The traditional names are reflected by the letters
-.Ql b
-and
-.Ql c
-as the file type identification in the output of
-.Ql ls -l .
-Buffered devices are being accessed through the buffer cache of the
-operating system, and they are solely intended to layer a file system
-on top of them.
-They are normally implemented for disks and disk-like
-devices only and, for historical reasons, for tape devices.
-.Pp
-Raw devices are available for all drivers, including those that also
-implement a buffered device.
-For the latter group of devices, the
-differentiation is conventionally done by prepending the letter
-.Ql r
-to the path name of the device node, for example
-.Pa /dev/rda0
-denotes the raw device for the first SCSI disk, while
-.Pa /dev/da0
-is the corresponding device node for the buffered device.
-.Pp
-Unbuffered devices should be used for all act

svn commit: r345961 - stable/12/share/man/man4

2019-09-03 Thread Guangyuan Yang
Author: ygy (doc committer)
Date: Fri Apr  5 18:17:11 2019
New Revision: 345961
URL: https://svnweb.freebsd.org/changeset/base/345961

Log:
  MFC r345816:
  
  Correct SMC definition in asmc(4) man page.
  
  PR:   236954
  Submitted by: fbsdbu...@sentry.org

Modified:
  stable/12/share/man/man4/asmc.4
Directory Properties:
  stable/12/   (props changed)

Modified: stable/12/share/man/man4/asmc.4
==
--- stable/12/share/man/man4/asmc.4 Fri Apr  5 18:09:22 2019
(r345960)
+++ stable/12/share/man/man4/asmc.4 Fri Apr  5 18:17:11 2019
(r345961)
@@ -25,12 +25,12 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd July 27, 2009
+.Dd April 2, 2019
 .Dt ASMC 4
 .Os
 .Sh NAME
 .Nm asmc
-.Nd device driver for the Apple System Management Console (SMC)
+.Nd device driver for the Apple System Management Controller (SMC)
 .Sh SYNOPSIS
 To compile this driver into the kernel, place the following line in your
 kernel configuration file:
@@ -47,7 +47,7 @@ asmc_load="YES"
 .Sh DESCRIPTION
 The
 .Nm
-driver controls the Apple System Management Console (SMC for short)
+driver controls the Apple System Management Controller (SMC for short)
 found on Intel Apple systems.
 .Pp
 The SMC is known to be found on the following systems:


___
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: r345887 - head/share/man/man4

2019-09-03 Thread Guangyuan Yang
Author: ygy (doc committer)
Date: Thu Apr  4 18:52:03 2019
New Revision: 345887
URL: https://svnweb.freebsd.org/changeset/base/345887

Log:
  Rewrite intro(4) man page.
  
  - Remove issues that no longer apply thanks to devfs
  - Add language pointing out devfs's role and referencing its config
  - Add a "historical notes" section and move discussion of block vs character 
devs to it, including pointing out the removal of block devs
  - Modernize some examples
  
  MFC after:1 week
  PR:   236970
  Submitted by: and...@tao173.riddles.org.uk
  Reviewed by:  0mp
  Differential Revision:https://reviews.freebsd.org/D19799

Modified:
  head/share/man/man4/intro.4

Modified: head/share/man/man4/intro.4
==
--- head/share/man/man4/intro.4 Thu Apr  4 18:37:30 2019(r345886)
+++ head/share/man/man4/intro.4 Thu Apr  4 18:52:03 2019(r345887)
@@ -1,5 +1,6 @@
 .\"
 .\" Copyright (c) 1996 David E. O'Brien, Joerg Wunsch
+.\" Copyright (c) 2019 Andrew Gierth
 .\"
 .\" All rights reserved.
 .\"
@@ -25,7 +26,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd January 20, 1996
+.Dd April 3, 2019
 .Dt INTRO 4
 .Os
 .Sh NAME
@@ -45,14 +46,13 @@ without any particular underlying hardware.
 A typical example for
 the latter class is
 .Pa /dev/mem ,
-a loophole where the physical memory can be accessed using the regular
-file access semantics.
+a mechanism whereby the physical memory can be accessed using file
+access semantics.
 .Pp
-The device abstraction generally provides a common set of system calls
-layered on top of them, which are dispatched to the corresponding
-device driver by the upper layers of the kernel.
-The set of system
-calls available for devices is chosen from
+The device abstraction generally provides a common set of system
+calls, which are dispatched to the corresponding device driver by the
+upper layers of the kernel.
+The set of system calls available for devices is chosen from
 .Xr open 2 ,
 .Xr close 2 ,
 .Xr read 2 ,
@@ -61,77 +61,56 @@ calls available for devices is chosen from
 .Xr select 2 ,
 and
 .Xr mmap 2 .
-Not all drivers implement all system calls, for example, calling
+Not all drivers implement all system calls; for example, calling
 .Xr mmap 2
-on terminal devices is likely to be not useful at all.
+on a keyboard device is not likely to be useful.
+.Pp
+Aspects of the device abstraction have changed significantly in
+.Fx
+over the past two decades.
+The section
+.Sx Historical Notes
+describes some of the more important differences.
 .Ss Accessing Devices
-Most of the devices in a
-.Ux Ns
--like operating system are accessed
-through so-called
+Most of the devices in
+.Fx
+are accessed through
 .Em device nodes ,
 sometimes also called
 .Em special files .
-They are usually located under the directory
+They are located within instances of the
+.Xr devfs 5
+filesystem, which is conventionally mounted on the directory
 .Pa /dev
 in the file system hierarchy
 (see also
 .Xr hier 7 ) .
 .Pp
-Note that this could lead to an inconsistent state, where either there
-are device nodes that do not have a configured driver associated with
-them, or there may be drivers that have successfully probed for their
-devices, but cannot be accessed since the corresponding device node is
-still missing.
-In the first case, any attempt to reference the device
-through the device node will result in an error, returned by the upper
-layers of the kernel, usually
-.Er ENXIO .
-In the second case, the device node needs to be created before the
-driver and its device will be usable.
+The
+.Xr devfs 5
+filesystem creates or removes device nodes automatically according to
+the physical hardware recognized as present at any given time.
+For pseudo-devices, device nodes may be created and removed dynamically
+as required, depending on the nature of the device.
 .Pp
-Some devices come in two flavors:
-.Em block
-and
-.Em character
-devices, or to use better terms, buffered and unbuffered
-(raw)
-devices.
-The traditional names are reflected by the letters
-.Ql b
-and
-.Ql c
-as the file type identification in the output of
-.Ql ls -l .
-Buffered devices are being accessed through the buffer cache of the
-operating system, and they are solely intended to layer a file system
-on top of them.
-They are normally implemented for disks and disk-like
-devices only and, for historical reasons, for tape devices.
-.Pp
-Raw devices are available for all drivers, including those that also
-implement a buffered device.
-For the latter group of devices, the
-differentiation is conventionally done by prepending the letter
-.Ql r
-to the path name of the device node, for example
-.Pa /dev/rda0
-denotes the raw device for the first SCSI disk, while
-.Pa /dev/da0
-is the corresponding device node for the buffered device.
-.Pp
-Unbuffered devices should be used for all actions that are not related
-to file system operations, even if the device in 

svn commit: r345816 - head/share/man/man4

2019-09-03 Thread Guangyuan Yang
Author: ygy (doc committer)
Date: Tue Apr  2 20:03:03 2019
New Revision: 345816
URL: https://svnweb.freebsd.org/changeset/base/345816

Log:
  Correct SMC definition in asmc(4) man page.
  
  MFC after:3 days
  PR:   236954
  Submitted by: fbsdbu...@sentry.org

Modified:
  head/share/man/man4/asmc.4

Modified: head/share/man/man4/asmc.4
==
--- head/share/man/man4/asmc.4  Tue Apr  2 19:37:52 2019(r345815)
+++ head/share/man/man4/asmc.4  Tue Apr  2 20:03:03 2019(r345816)
@@ -25,12 +25,12 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd July 27, 2009
+.Dd April 2, 2019
 .Dt ASMC 4
 .Os
 .Sh NAME
 .Nm asmc
-.Nd device driver for the Apple System Management Console (SMC)
+.Nd device driver for the Apple System Management Controller (SMC)
 .Sh SYNOPSIS
 To compile this driver into the kernel, place the following line in your
 kernel configuration file:
@@ -47,7 +47,7 @@ asmc_load="YES"
 .Sh DESCRIPTION
 The
 .Nm
-driver controls the Apple System Management Console (SMC for short)
+driver controls the Apple System Management Controller (SMC for short)
 found on Intel Apple systems.
 .Pp
 The SMC is known to be found on the following systems:


___
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: r347983 - stable/12/share/man/man4

2019-05-19 Thread Guangyuan Yang
Author: ygy (doc committer)
Date: Sun May 19 23:56:04 2019
New Revision: 347983
URL: https://svnweb.freebsd.org/changeset/base/347983

Log:
  MFC r347565:
  
  Fix some spelling errors in ng_eiface(4).
  
  PR:   237764
  Submitted by: Tom Marcoen 

Modified:
  stable/12/share/man/man4/ng_eiface.4
Directory Properties:
  stable/12/   (props changed)

Modified: stable/12/share/man/man4/ng_eiface.4
==
--- stable/12/share/man/man4/ng_eiface.4Sun May 19 21:49:56 2019
(r347982)
+++ stable/12/share/man/man4/ng_eiface.4Sun May 19 23:56:04 2019
(r347983)
@@ -24,7 +24,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd February 3, 2005
+.Dd May 14, 2019
 .Dt NG_EIFACE 4
 .Os
 .Sh NAME
@@ -36,7 +36,7 @@
 The
 .Vt eiface
 netgraph node implements the generic Ethernet interface.
-When
+When an
 .Vt eiface
 node is created, a new interface appears which is accessible via
 .Xr ifconfig 8 .
@@ -78,7 +78,7 @@ which requires as an argument an
 string consisting of 6 colon-separated hex digits.
 .It Dv NGM_EIFACE_GET_IFNAME Pq Ic getifname
 Return the name of the associated interface as a
-.Dv NUL Ns -terminated
+.Dv NULL Ns -terminated
 .Tn ASCII
 string.
 .It Dv NGM_EIFACE_GET_IFADDRS
@@ -97,7 +97,7 @@ Unlike most other node types, an
 .Vt eiface
 node does
 .Em not
-go away when all hooks have been disconnected; rather, and explicit
+go away when all hooks have been disconnected; rather, an explicit
 .Dv NGM_SHUTDOWN
 control message is required.
 .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: r347565 - head/share/man/man4

2019-05-14 Thread Guangyuan Yang
Author: ygy (doc committer)
Date: Tue May 14 15:41:34 2019
New Revision: 347565
URL: https://svnweb.freebsd.org/changeset/base/347565

Log:
  Fix some spelling errors in ng_eiface(4).
  
  MFC after:3 days
  PR:   237764
  Submitted by: Tom Marcoen 

Modified:
  head/share/man/man4/ng_eiface.4

Modified: head/share/man/man4/ng_eiface.4
==
--- head/share/man/man4/ng_eiface.4 Tue May 14 15:19:48 2019
(r347564)
+++ head/share/man/man4/ng_eiface.4 Tue May 14 15:41:34 2019
(r347565)
@@ -24,7 +24,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd February 3, 2005
+.Dd May 14, 2019
 .Dt NG_EIFACE 4
 .Os
 .Sh NAME
@@ -36,7 +36,7 @@
 The
 .Vt eiface
 netgraph node implements the generic Ethernet interface.
-When
+When an
 .Vt eiface
 node is created, a new interface appears which is accessible via
 .Xr ifconfig 8 .
@@ -78,7 +78,7 @@ which requires as an argument an
 string consisting of 6 colon-separated hex digits.
 .It Dv NGM_EIFACE_GET_IFNAME Pq Ic getifname
 Return the name of the associated interface as a
-.Dv NUL Ns -terminated
+.Dv NULL Ns -terminated
 .Tn ASCII
 string.
 .It Dv NGM_EIFACE_GET_IFADDRS
@@ -97,7 +97,7 @@ Unlike most other node types, an
 .Vt eiface
 node does
 .Em not
-go away when all hooks have been disconnected; rather, and explicit
+go away when all hooks have been disconnected; rather, an explicit
 .Dv NGM_SHUTDOWN
 control message is required.
 .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: r346111 - stable/12/share/man/man4

2019-04-10 Thread Guangyuan Yang
Author: ygy (doc committer)
Date: Thu Apr 11 00:41:07 2019
New Revision: 346111
URL: https://svnweb.freebsd.org/changeset/base/346111

Log:
  MFC r345887:
  
  Rewrite intro(4) man page.
  
  - Remove issues that no longer apply thanks to devfs
  - Add language pointing out devfs's role and referencing its config
  - Add a "historical notes" section and move discussion of block vs character 
devs to it, including pointing out the removal of block devs
  - Modernize some examples
  
  PR:   236970
  Submitted by: and...@tao173.riddles.org.uk
  Reviewed by:  0mp
  Differential Revision:https://reviews.freebsd.org/D19799

Modified:
  stable/12/share/man/man4/intro.4
Directory Properties:
  stable/12/   (props changed)

Modified: stable/12/share/man/man4/intro.4
==
--- stable/12/share/man/man4/intro.4Thu Apr 11 00:39:06 2019
(r346110)
+++ stable/12/share/man/man4/intro.4Thu Apr 11 00:41:07 2019
(r346111)
@@ -1,5 +1,6 @@
 .\"
 .\" Copyright (c) 1996 David E. O'Brien, Joerg Wunsch
+.\" Copyright (c) 2019 Andrew Gierth
 .\"
 .\" All rights reserved.
 .\"
@@ -25,7 +26,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd January 20, 1996
+.Dd April 3, 2019
 .Dt INTRO 4
 .Os
 .Sh NAME
@@ -45,14 +46,13 @@ without any particular underlying hardware.
 A typical example for
 the latter class is
 .Pa /dev/mem ,
-a loophole where the physical memory can be accessed using the regular
-file access semantics.
+a mechanism whereby the physical memory can be accessed using file
+access semantics.
 .Pp
-The device abstraction generally provides a common set of system calls
-layered on top of them, which are dispatched to the corresponding
-device driver by the upper layers of the kernel.
-The set of system
-calls available for devices is chosen from
+The device abstraction generally provides a common set of system
+calls, which are dispatched to the corresponding device driver by the
+upper layers of the kernel.
+The set of system calls available for devices is chosen from
 .Xr open 2 ,
 .Xr close 2 ,
 .Xr read 2 ,
@@ -61,77 +61,56 @@ calls available for devices is chosen from
 .Xr select 2 ,
 and
 .Xr mmap 2 .
-Not all drivers implement all system calls, for example, calling
+Not all drivers implement all system calls; for example, calling
 .Xr mmap 2
-on terminal devices is likely to be not useful at all.
+on a keyboard device is not likely to be useful.
+.Pp
+Aspects of the device abstraction have changed significantly in
+.Fx
+over the past two decades.
+The section
+.Sx Historical Notes
+describes some of the more important differences.
 .Ss Accessing Devices
-Most of the devices in a
-.Ux Ns
--like operating system are accessed
-through so-called
+Most of the devices in
+.Fx
+are accessed through
 .Em device nodes ,
 sometimes also called
 .Em special files .
-They are usually located under the directory
+They are located within instances of the
+.Xr devfs 5
+filesystem, which is conventionally mounted on the directory
 .Pa /dev
 in the file system hierarchy
 (see also
 .Xr hier 7 ) .
 .Pp
-Note that this could lead to an inconsistent state, where either there
-are device nodes that do not have a configured driver associated with
-them, or there may be drivers that have successfully probed for their
-devices, but cannot be accessed since the corresponding device node is
-still missing.
-In the first case, any attempt to reference the device
-through the device node will result in an error, returned by the upper
-layers of the kernel, usually
-.Er ENXIO .
-In the second case, the device node needs to be created before the
-driver and its device will be usable.
+The
+.Xr devfs 5
+filesystem creates or removes device nodes automatically according to
+the physical hardware recognized as present at any given time.
+For pseudo-devices, device nodes may be created and removed dynamically
+as required, depending on the nature of the device.
 .Pp
-Some devices come in two flavors:
-.Em block
-and
-.Em character
-devices, or to use better terms, buffered and unbuffered
-(raw)
-devices.
-The traditional names are reflected by the letters
-.Ql b
-and
-.Ql c
-as the file type identification in the output of
-.Ql ls -l .
-Buffered devices are being accessed through the buffer cache of the
-operating system, and they are solely intended to layer a file system
-on top of them.
-They are normally implemented for disks and disk-like
-devices only and, for historical reasons, for tape devices.
-.Pp
-Raw devices are available for all drivers, including those that also
-implement a buffered device.
-For the latter group of devices, the
-differentiation is conventionally done by prepending the letter
-.Ql r
-to the path name of the device node, for example
-.Pa /dev/rda0
-denotes the raw device for the first SCSI disk, while
-.Pa /dev/da0
-is the corresponding device node for the buffered device.
-.Pp
-Unbuffered devices should be used for all act

svn commit: r345961 - stable/12/share/man/man4

2019-04-05 Thread Guangyuan Yang
Author: ygy (doc committer)
Date: Fri Apr  5 18:17:11 2019
New Revision: 345961
URL: https://svnweb.freebsd.org/changeset/base/345961

Log:
  MFC r345816:
  
  Correct SMC definition in asmc(4) man page.
  
  PR:   236954
  Submitted by: fbsdbu...@sentry.org

Modified:
  stable/12/share/man/man4/asmc.4
Directory Properties:
  stable/12/   (props changed)

Modified: stable/12/share/man/man4/asmc.4
==
--- stable/12/share/man/man4/asmc.4 Fri Apr  5 18:09:22 2019
(r345960)
+++ stable/12/share/man/man4/asmc.4 Fri Apr  5 18:17:11 2019
(r345961)
@@ -25,12 +25,12 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd July 27, 2009
+.Dd April 2, 2019
 .Dt ASMC 4
 .Os
 .Sh NAME
 .Nm asmc
-.Nd device driver for the Apple System Management Console (SMC)
+.Nd device driver for the Apple System Management Controller (SMC)
 .Sh SYNOPSIS
 To compile this driver into the kernel, place the following line in your
 kernel configuration file:
@@ -47,7 +47,7 @@ asmc_load="YES"
 .Sh DESCRIPTION
 The
 .Nm
-driver controls the Apple System Management Console (SMC for short)
+driver controls the Apple System Management Controller (SMC for short)
 found on Intel Apple systems.
 .Pp
 The SMC is known to be found on the following systems:
___
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: r345887 - head/share/man/man4

2019-04-04 Thread Guangyuan Yang
Author: ygy (doc committer)
Date: Thu Apr  4 18:52:03 2019
New Revision: 345887
URL: https://svnweb.freebsd.org/changeset/base/345887

Log:
  Rewrite intro(4) man page.
  
  - Remove issues that no longer apply thanks to devfs
  - Add language pointing out devfs's role and referencing its config
  - Add a "historical notes" section and move discussion of block vs character 
devs to it, including pointing out the removal of block devs
  - Modernize some examples
  
  MFC after:1 week
  PR:   236970
  Submitted by: and...@tao173.riddles.org.uk
  Reviewed by:  0mp
  Differential Revision:https://reviews.freebsd.org/D19799

Modified:
  head/share/man/man4/intro.4

Modified: head/share/man/man4/intro.4
==
--- head/share/man/man4/intro.4 Thu Apr  4 18:37:30 2019(r345886)
+++ head/share/man/man4/intro.4 Thu Apr  4 18:52:03 2019(r345887)
@@ -1,5 +1,6 @@
 .\"
 .\" Copyright (c) 1996 David E. O'Brien, Joerg Wunsch
+.\" Copyright (c) 2019 Andrew Gierth
 .\"
 .\" All rights reserved.
 .\"
@@ -25,7 +26,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd January 20, 1996
+.Dd April 3, 2019
 .Dt INTRO 4
 .Os
 .Sh NAME
@@ -45,14 +46,13 @@ without any particular underlying hardware.
 A typical example for
 the latter class is
 .Pa /dev/mem ,
-a loophole where the physical memory can be accessed using the regular
-file access semantics.
+a mechanism whereby the physical memory can be accessed using file
+access semantics.
 .Pp
-The device abstraction generally provides a common set of system calls
-layered on top of them, which are dispatched to the corresponding
-device driver by the upper layers of the kernel.
-The set of system
-calls available for devices is chosen from
+The device abstraction generally provides a common set of system
+calls, which are dispatched to the corresponding device driver by the
+upper layers of the kernel.
+The set of system calls available for devices is chosen from
 .Xr open 2 ,
 .Xr close 2 ,
 .Xr read 2 ,
@@ -61,77 +61,56 @@ calls available for devices is chosen from
 .Xr select 2 ,
 and
 .Xr mmap 2 .
-Not all drivers implement all system calls, for example, calling
+Not all drivers implement all system calls; for example, calling
 .Xr mmap 2
-on terminal devices is likely to be not useful at all.
+on a keyboard device is not likely to be useful.
+.Pp
+Aspects of the device abstraction have changed significantly in
+.Fx
+over the past two decades.
+The section
+.Sx Historical Notes
+describes some of the more important differences.
 .Ss Accessing Devices
-Most of the devices in a
-.Ux Ns
--like operating system are accessed
-through so-called
+Most of the devices in
+.Fx
+are accessed through
 .Em device nodes ,
 sometimes also called
 .Em special files .
-They are usually located under the directory
+They are located within instances of the
+.Xr devfs 5
+filesystem, which is conventionally mounted on the directory
 .Pa /dev
 in the file system hierarchy
 (see also
 .Xr hier 7 ) .
 .Pp
-Note that this could lead to an inconsistent state, where either there
-are device nodes that do not have a configured driver associated with
-them, or there may be drivers that have successfully probed for their
-devices, but cannot be accessed since the corresponding device node is
-still missing.
-In the first case, any attempt to reference the device
-through the device node will result in an error, returned by the upper
-layers of the kernel, usually
-.Er ENXIO .
-In the second case, the device node needs to be created before the
-driver and its device will be usable.
+The
+.Xr devfs 5
+filesystem creates or removes device nodes automatically according to
+the physical hardware recognized as present at any given time.
+For pseudo-devices, device nodes may be created and removed dynamically
+as required, depending on the nature of the device.
 .Pp
-Some devices come in two flavors:
-.Em block
-and
-.Em character
-devices, or to use better terms, buffered and unbuffered
-(raw)
-devices.
-The traditional names are reflected by the letters
-.Ql b
-and
-.Ql c
-as the file type identification in the output of
-.Ql ls -l .
-Buffered devices are being accessed through the buffer cache of the
-operating system, and they are solely intended to layer a file system
-on top of them.
-They are normally implemented for disks and disk-like
-devices only and, for historical reasons, for tape devices.
-.Pp
-Raw devices are available for all drivers, including those that also
-implement a buffered device.
-For the latter group of devices, the
-differentiation is conventionally done by prepending the letter
-.Ql r
-to the path name of the device node, for example
-.Pa /dev/rda0
-denotes the raw device for the first SCSI disk, while
-.Pa /dev/da0
-is the corresponding device node for the buffered device.
-.Pp
-Unbuffered devices should be used for all actions that are not related
-to file system operations, even if the device in 

svn commit: r345816 - head/share/man/man4

2019-04-02 Thread Guangyuan Yang
Author: ygy (doc committer)
Date: Tue Apr  2 20:03:03 2019
New Revision: 345816
URL: https://svnweb.freebsd.org/changeset/base/345816

Log:
  Correct SMC definition in asmc(4) man page.
  
  MFC after:3 days
  PR:   236954
  Submitted by: fbsdbu...@sentry.org

Modified:
  head/share/man/man4/asmc.4

Modified: head/share/man/man4/asmc.4
==
--- head/share/man/man4/asmc.4  Tue Apr  2 19:37:52 2019(r345815)
+++ head/share/man/man4/asmc.4  Tue Apr  2 20:03:03 2019(r345816)
@@ -25,12 +25,12 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd July 27, 2009
+.Dd April 2, 2019
 .Dt ASMC 4
 .Os
 .Sh NAME
 .Nm asmc
-.Nd device driver for the Apple System Management Console (SMC)
+.Nd device driver for the Apple System Management Controller (SMC)
 .Sh SYNOPSIS
 To compile this driver into the kernel, place the following line in your
 kernel configuration file:
@@ -47,7 +47,7 @@ asmc_load="YES"
 .Sh DESCRIPTION
 The
 .Nm
-driver controls the Apple System Management Console (SMC for short)
+driver controls the Apple System Management Controller (SMC for short)
 found on Intel Apple systems.
 .Pp
 The SMC is known to be found on the following systems:
___
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: r345168 - head/share/misc

2019-03-14 Thread Guangyuan Yang
Author: ygy (doc committer)
Date: Fri Mar 15 00:20:28 2019
New Revision: 345168
URL: https://svnweb.freebsd.org/changeset/base/345168

Log:
  Add myself to committers-doc.dot.
  
  Reminded by:  rgrimes

Modified:
  head/share/misc/committers-doc.dot

Modified: head/share/misc/committers-doc.dot
==
--- head/share/misc/committers-doc.dot  Thu Mar 14 23:05:59 2019
(r345167)
+++ head/share/misc/committers-doc.dot  Fri Mar 15 00:20:28 2019
(r345168)
@@ -92,6 +92,7 @@ skreuzer [label="Steven Kreuzer\nskreu...@freebsd.org\
 taras [label="Taras Korenko\nta...@freebsd.org\n2010/06/25"]
 trhodes [label="Tom Rhodes\ntrho...@freebsd.org\n2002/03/25"]
 wblock [label="Warren Block\nwbl...@freebsd.org\n2011/09/12"]
+ygy [label="Guangyuan Yang\n...@freebsd.org\n2017/09/18"]
 zeising [label="Niclas Zeising\nzeis...@freebsd.org\n2012/07/03"]
 
 # Here are the mentor/mentee relationships.
___
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: r345001 - stable/12/sbin/ipfw

2019-03-11 Thread Guangyuan Yang
Author: ygy (doc committer)
Date: Mon Mar 11 07:18:40 2019
New Revision: 345001
URL: https://svnweb.freebsd.org/changeset/base/345001

Log:
  MFC r344709:
  
  Fix typos and caps for ipfw(8) man page.
  
  PR:   236030
  Submitted by: olgeni

Modified:
  stable/12/sbin/ipfw/ipfw.8
Directory Properties:
  stable/12/   (props changed)

Modified: stable/12/sbin/ipfw/ipfw.8
==
--- stable/12/sbin/ipfw/ipfw.8  Mon Mar 11 03:07:05 2019(r345000)
+++ stable/12/sbin/ipfw/ipfw.8  Mon Mar 11 07:18:40 2019(r345001)
@@ -1,7 +1,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd December 4, 2018
+.Dd March 1, 2019
 .Dt IPFW 8
 .Os
 .Sh NAME
@@ -1329,11 +1329,11 @@ its use is discouraged.
 .Brc
 .Bl -tag -width indent
 .It Cm any
-matches any IP address.
+Matches any IP address.
 .It Cm me
-matches any IP address configured on an interface in the system.
+Matches any IP address configured on an interface in the system.
 .It Cm me6
-matches any IPv6 address configured on an interface in the system.
+Matches any IPv6 address configured on an interface in the system.
 The address list is evaluated at the time the packet is
 analysed.
 .It Cm table Ns Pq Ar name Ns Op , Ns Ar value
@@ -2083,7 +2083,7 @@ The following table types are supported:
 .It Ar flow-spec : Ar flow-field Ns Op , Ns Ar flow-spec
 .It Ar flow-field : src-ip | proto | src-port | dst-ip | dst-port
 .It Cm addr
-matches IPv4 or IPv6 address.
+Matches IPv4 or IPv6 address.
 Each entry is represented by an
 .Ar addr Ns Op / Ns Ar masklen
 and will match all addresses with base
@@ -2097,11 +2097,11 @@ is not specified, it defaults to 32 for IPv4 and 128 f
 When looking up an IP address in a table, the most specific
 entry will match.
 .It Cm iface
-matches interface names.
+Matches interface names.
 Each entry is represented by string treated as interface name.
 Wildcards are not supported.
 .It Cm number
-maches protocol ports, uids/gids or jail IDs.
+Matches protocol ports, uids/gids or jail IDs.
 Each entry is represented by 32-bit unsigned integer.
 Ranges are not supported.
 .It Cm flow
@@ -2792,7 +2792,7 @@ specifies the quantum (credit) of the scheduler.
 .Ar m
 is the number of bytes a queue can serve before being moved to the tail
 of old queues list.
-The default is 1514 bytes, and the maximum accepable value
+The default is 1514 bytes, and the maximum acceptable value
 is 9000 bytes.
 .It Cm limit
 .Ar m
@@ -2800,14 +2800,14 @@ specifies the hard size limit (in unit of packets) of 
 instance of the scheduler.
 The default value of
 .Ar m
-is 10240 packets, and the maximum accepable value is 20480 packets.
+is 10240 packets, and the maximum acceptable value is 20480 packets.
 .It Cm flows
 .Ar m
 specifies the total number of flow queues (sub-queues) that fq_*
 creates and manages.
 By default, 1024 sub-queues are created when an instance
 of the fq_{codel/pie} scheduler is created.
-The maximum accepable value is
+The maximum acceptable value is
 65536.
 .El
 .Pp
@@ -2906,7 +2906,7 @@ is the typical queue size for Ethernet devices.
 Note that for slow speed links you should keep the queue
 size short or your traffic might be affected by a significant
 queueing delay.
-E.g., 50 max-sized ethernet packets (1500 bytes) mean 600Kbit
+E.g., 50 max-sized Ethernet packets (1500 bytes) mean 600Kbit
 or 20s of queue on a 30Kbit/s pipe.
 Even worse effects can result if you get packets from an
 interface with a much larger MTU, e.g.\& the loopback interface
@@ -3053,7 +3053,7 @@ De-randomisation is enabled by default.
 .It Cm onoff
 enable turning PIE on and off depending on queue load.
 If this option is enabled,
-PIE turnes on when over 1/3 of queue becomes full.
+PIE turns on when over 1/3 of queue becomes full.
 This option is disabled by
 default.
 .It Cm dre | ts
@@ -4089,7 +4089,7 @@ by adding the following to the appropriate place in ru
 If your network has network traffic analyzer
 connected to your host directly via dedicated interface
 or remotely via RSPAN vlan, you can selectively mirror
-some ethernet layer2 frames to the analyzer.
+some Ethernet layer2 frames to the analyzer.
 .Pp
 First, make sure your firewall is already configured and runs.
 Then, enable layer2 processing if not already enabled:
@@ -4434,7 +4434,7 @@ or it could be split in:
 .Dl "ipfw nat 5 config redirect_port tcp"
 .Dl "  192.168.0.1:80,192.168.0.10:22,192.168.0.20:25 500"
 .Pp
-Sometimes you may want to mix NAT and dynamic rules. It could be achived with
+Sometimes you may want to mix NAT and dynamic rules. It could be achieved with
 .Cm record-state
 and
 .Cm defer-action
@@ -4447,8 +4447,8 @@ rule will be performed as soon as rule is matched. In 
 .Cm allow
 rule packet need to be passed to NAT, not allowed as soon is possible.
 .Pp
-There is example of set of rules to achive this. Bear in mind that this
-is exmaple only and it is not very usefult by itself.
+There is exam

svn commit: r344709 - head/sbin/ipfw

2019-03-01 Thread Guangyuan Yang
Author: ygy (doc committer)
Date: Fri Mar  1 19:06:13 2019
New Revision: 344709
URL: https://svnweb.freebsd.org/changeset/base/344709

Log:
  Fix typos and caps for ipfw(8) man page.
  
  MFC after:3 days
  PR:   236030
  Submitted by: olgeni

Modified:
  head/sbin/ipfw/ipfw.8

Modified: head/sbin/ipfw/ipfw.8
==
--- head/sbin/ipfw/ipfw.8   Fri Mar  1 18:47:41 2019(r344708)
+++ head/sbin/ipfw/ipfw.8   Fri Mar  1 19:06:13 2019(r344709)
@@ -1,7 +1,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd December 4, 2018
+.Dd March 1, 2019
 .Dt IPFW 8
 .Os
 .Sh NAME
@@ -1329,11 +1329,11 @@ its use is discouraged.
 .Brc
 .Bl -tag -width indent
 .It Cm any
-matches any IP address.
+Matches any IP address.
 .It Cm me
-matches any IP address configured on an interface in the system.
+Matches any IP address configured on an interface in the system.
 .It Cm me6
-matches any IPv6 address configured on an interface in the system.
+Matches any IPv6 address configured on an interface in the system.
 The address list is evaluated at the time the packet is
 analysed.
 .It Cm table Ns Pq Ar name Ns Op , Ns Ar value
@@ -2083,7 +2083,7 @@ The following table types are supported:
 .It Ar flow-spec : Ar flow-field Ns Op , Ns Ar flow-spec
 .It Ar flow-field : src-ip | proto | src-port | dst-ip | dst-port
 .It Cm addr
-matches IPv4 or IPv6 address.
+Matches IPv4 or IPv6 address.
 Each entry is represented by an
 .Ar addr Ns Op / Ns Ar masklen
 and will match all addresses with base
@@ -2097,11 +2097,11 @@ is not specified, it defaults to 32 for IPv4 and 128 f
 When looking up an IP address in a table, the most specific
 entry will match.
 .It Cm iface
-matches interface names.
+Matches interface names.
 Each entry is represented by string treated as interface name.
 Wildcards are not supported.
 .It Cm number
-maches protocol ports, uids/gids or jail IDs.
+Matches protocol ports, uids/gids or jail IDs.
 Each entry is represented by 32-bit unsigned integer.
 Ranges are not supported.
 .It Cm flow
@@ -2792,7 +2792,7 @@ specifies the quantum (credit) of the scheduler.
 .Ar m
 is the number of bytes a queue can serve before being moved to the tail
 of old queues list.
-The default is 1514 bytes, and the maximum accepable value
+The default is 1514 bytes, and the maximum acceptable value
 is 9000 bytes.
 .It Cm limit
 .Ar m
@@ -2800,14 +2800,14 @@ specifies the hard size limit (in unit of packets) of 
 instance of the scheduler.
 The default value of
 .Ar m
-is 10240 packets, and the maximum accepable value is 20480 packets.
+is 10240 packets, and the maximum acceptable value is 20480 packets.
 .It Cm flows
 .Ar m
 specifies the total number of flow queues (sub-queues) that fq_*
 creates and manages.
 By default, 1024 sub-queues are created when an instance
 of the fq_{codel/pie} scheduler is created.
-The maximum accepable value is
+The maximum acceptable value is
 65536.
 .El
 .Pp
@@ -2906,7 +2906,7 @@ is the typical queue size for Ethernet devices.
 Note that for slow speed links you should keep the queue
 size short or your traffic might be affected by a significant
 queueing delay.
-E.g., 50 max-sized ethernet packets (1500 bytes) mean 600Kbit
+E.g., 50 max-sized Ethernet packets (1500 bytes) mean 600Kbit
 or 20s of queue on a 30Kbit/s pipe.
 Even worse effects can result if you get packets from an
 interface with a much larger MTU, e.g.\& the loopback interface
@@ -3053,7 +3053,7 @@ De-randomisation is enabled by default.
 .It Cm onoff
 enable turning PIE on and off depending on queue load.
 If this option is enabled,
-PIE turnes on when over 1/3 of queue becomes full.
+PIE turns on when over 1/3 of queue becomes full.
 This option is disabled by
 default.
 .It Cm dre | ts
@@ -4089,7 +4089,7 @@ by adding the following to the appropriate place in ru
 If your network has network traffic analyzer
 connected to your host directly via dedicated interface
 or remotely via RSPAN vlan, you can selectively mirror
-some ethernet layer2 frames to the analyzer.
+some Ethernet layer2 frames to the analyzer.
 .Pp
 First, make sure your firewall is already configured and runs.
 Then, enable layer2 processing if not already enabled:
@@ -4434,7 +4434,7 @@ or it could be split in:
 .Dl "ipfw nat 5 config redirect_port tcp"
 .Dl "  192.168.0.1:80,192.168.0.10:22,192.168.0.20:25 500"
 .Pp
-Sometimes you may want to mix NAT and dynamic rules. It could be achived with
+Sometimes you may want to mix NAT and dynamic rules. It could be achieved with
 .Cm record-state
 and
 .Cm defer-action
@@ -4447,8 +4447,8 @@ rule will be performed as soon as rule is matched. In 
 .Cm allow
 rule packet need to be passed to NAT, not allowed as soon is possible.
 .Pp
-There is example of set of rules to achive this. Bear in mind that this
-is exmaple only and it is not very usefult by itself.
+There is example of set of rules to achieve this. Bear in mind that thi

svn commit: r344114 - stable/12/sbin/sysctl

2019-02-14 Thread Guangyuan Yang
Author: ygy (doc committer)
Date: Thu Feb 14 09:12:19 2019
New Revision: 344114
URL: https://svnweb.freebsd.org/changeset/base/344114

Log:
  MFC r343930:
  
  Remove -R option which was added to sysctl(8) man page per r244106, but it is 
not implemented.
  
  Submitted by: Alfonso Siciliano 
  Reviewed by:  0mp, imp
  Differential Revision:https://reviews.freebsd.org/D19012

Modified:
  stable/12/sbin/sysctl/sysctl.8
Directory Properties:
  stable/12/   (props changed)

Modified: stable/12/sbin/sysctl/sysctl.8
==
--- stable/12/sbin/sysctl/sysctl.8  Thu Feb 14 00:52:03 2019
(r344113)
+++ stable/12/sbin/sysctl/sysctl.8  Thu Feb 14 09:12:19 2019
(r344114)
@@ -28,7 +28,7 @@
 .\"From: @(#)sysctl.8  8.1 (Berkeley) 6/6/93
 .\" $FreeBSD$
 .\"
-.Dd September 24, 2018
+.Dd February 8, 2019
 .Dt SYSCTL 8
 .Os
 .Sh NAME
@@ -36,13 +36,13 @@
 .Nd get or set kernel state
 .Sh SYNOPSIS
 .Nm
-.Op Fl bdehiNnoRTtqx
+.Op Fl bdehiNnoTtqWx
 .Op Fl B Ar bufsize
 .Op Fl f Ar filename
 .Ar name Ns Op = Ns Ar value Ns Op , Ns Ar value
 .Ar ...
 .Nm
-.Op Fl bdehNnoRTtqx
+.Op Fl bdehNnoTtqWx
 .Op Fl B Ar bufsize
 .Fl a
 .Sh DESCRIPTION
___
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: r343930 - head/sbin/sysctl

2019-02-08 Thread Guangyuan Yang
Author: ygy (doc committer)
Date: Sat Feb  9 04:36:02 2019
New Revision: 343930
URL: https://svnweb.freebsd.org/changeset/base/343930

Log:
  Remove -R option which was added to sysctl(8) man page per r244106, but it is 
not implemented.
  
  MFC after:3 days
  Submitted by: Alfonso Siciliano 
  Reviewed by:  0mp, imp
  Differential Revision:https://reviews.freebsd.org/D19012

Modified:
  head/sbin/sysctl/sysctl.8

Modified: head/sbin/sysctl/sysctl.8
==
--- head/sbin/sysctl/sysctl.8   Sat Feb  9 03:56:48 2019(r343929)
+++ head/sbin/sysctl/sysctl.8   Sat Feb  9 04:36:02 2019(r343930)
@@ -28,7 +28,7 @@
 .\"From: @(#)sysctl.8  8.1 (Berkeley) 6/6/93
 .\" $FreeBSD$
 .\"
-.Dd September 24, 2018
+.Dd February 8, 2019
 .Dt SYSCTL 8
 .Os
 .Sh NAME
@@ -36,13 +36,13 @@
 .Nd get or set kernel state
 .Sh SYNOPSIS
 .Nm
-.Op Fl bdehiNnoRTtqx
+.Op Fl bdehiNnoTtqWx
 .Op Fl B Ar bufsize
 .Op Fl f Ar filename
 .Ar name Ns Op = Ns Ar value Ns Op , Ns Ar value
 .Ar ...
 .Nm
-.Op Fl bdehNnoRTtqx
+.Op Fl bdehNnoTtqWx
 .Op Fl B Ar bufsize
 .Fl a
 .Sh DESCRIPTION
___
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: r341452 - stable/12/bin/pkill

2018-12-03 Thread Guangyuan Yang
Author: ygy (doc committer)
Date: Tue Dec  4 02:30:11 2018
New Revision: 341452
URL: https://svnweb.freebsd.org/changeset/base/341452

Log:
  MFC r341357:
  
  Clarify that patterns are extended regular expressions in pkill(1) manual 
page.
  
  PR:   231060
  Submitted by: naddy

Modified:
  stable/12/bin/pkill/pkill.1
Directory Properties:
  stable/12/   (props changed)

Modified: stable/12/bin/pkill/pkill.1
==
--- stable/12/bin/pkill/pkill.1 Tue Dec  4 00:41:12 2018(r341451)
+++ stable/12/bin/pkill/pkill.1 Tue Dec  4 02:30:11 2018(r341452)
@@ -29,7 +29,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd June 5, 2017
+.Dd December 1, 2018
 .Dt PKILL 1
 .Os
 .Sh NAME
@@ -221,7 +221,7 @@ This option is valid only when given as the first argu
 .Pp
 If any
 .Ar pattern
-operands are specified, they are used as regular expressions to match
+operands are specified, they are used as extended regular expressions to match
 the command name or full argument list of each process.
 If the
 .Fl f
___
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: r341403 - stable/12/stand/i386/pxeldr

2018-12-02 Thread Guangyuan Yang
Author: ygy (doc committer)
Date: Sun Dec  2 19:08:51 2018
New Revision: 341403
URL: https://svnweb.freebsd.org/changeset/base/341403

Log:
  MFC r340917, r341007
  
  r340917:
  Update pxeboot(8) manual page to reflect the next-server change in the ISC 
DHCP v3 server.
  
  r341007:
  Bump the date of pxeboot(8) manual page for r340917.
  
  PR:   123484
  Submitted by: ed...@mavetju.org
  Reviewed by:  AllanJude

Modified:
  stable/12/stand/i386/pxeldr/pxeboot.8
Directory Properties:
  stable/12/   (props changed)

Modified: stable/12/stand/i386/pxeldr/pxeboot.8
==
--- stable/12/stand/i386/pxeldr/pxeboot.8   Sun Dec  2 18:30:58 2018
(r341402)
+++ stable/12/stand/i386/pxeldr/pxeboot.8   Sun Dec  2 19:08:51 2018
(r341403)
@@ -24,7 +24,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd May 27, 2017
+.Dd November 25, 2018
 .Dt PXEBOOT 8
 .Os
 .Sh NAME
@@ -58,7 +58,7 @@ The
 .Nm
 binary is loaded just like any other boot file,
 by specifying it in the DHCP server's configuration file.
-Below is a sample configuration for the ISC DHCP v2 server:
+Below is a sample configuration for the ISC DHCP v3 server:
 .Bd -literal -offset indent
 option domain-name "example.com";
 option routers 10.0.0.1;
@@ -67,6 +67,7 @@ option broadcast-address 10.0.0.255;
 option domain-name-servers 10.0.0.1;
 server-name "DHCPserver";
 server-identifier 10.0.0.1;
+next-server 10.0.0.1;
 
 default-lease-time 120;
 max-lease-time 120;
@@ -80,10 +81,11 @@ subnet 10.0.0.0 netmask 255.255.255.0 {
 }
 
 .Ed
+.Va next-server
+is the IP address of the next server in the bootstrap process, i.e.
+your TFTP server or NFS server.
 .Nm
 recognizes
-.Va next-server
-and
 .Va option root-path
 directives as the server and path to NFS mount for file requests,
 respectively, or the server to make TFTP requests 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: r341357 - head/bin/pkill

2018-12-01 Thread Guangyuan Yang
Author: ygy (doc committer)
Date: Sat Dec  1 05:58:33 2018
New Revision: 341357
URL: https://svnweb.freebsd.org/changeset/base/341357

Log:
  Clarify that patterns are extended regular expressions in pkill(1) manual 
page.
  
  PR:   231060
  Submitted by: naddy
  MFC after:3 days

Modified:
  head/bin/pkill/pkill.1

Modified: head/bin/pkill/pkill.1
==
--- head/bin/pkill/pkill.1  Sat Dec  1 03:20:10 2018(r341356)
+++ head/bin/pkill/pkill.1  Sat Dec  1 05:58:33 2018(r341357)
@@ -29,7 +29,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd June 5, 2017
+.Dd December 1, 2018
 .Dt PKILL 1
 .Os
 .Sh NAME
@@ -221,7 +221,7 @@ This option is valid only when given as the first argu
 .Pp
 If any
 .Ar pattern
-operands are specified, they are used as regular expressions to match
+operands are specified, they are used as extended regular expressions to match
 the command name or full argument list of each process.
 If the
 .Fl f
___
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: r341355 - stable/12/sbin/ipfw

2018-11-30 Thread Guangyuan Yang
Author: ygy (doc committer)
Date: Fri Nov 30 23:51:53 2018
New Revision: 341355
URL: https://svnweb.freebsd.org/changeset/base/341355

Log:
  MFC r340792:
  
  Fix a minor typo in ipfw(8) manual page.
  
  PR:   230747
  Submitted by: f.tos...@hotmail.it

Modified:
  stable/12/sbin/ipfw/ipfw.8
Directory Properties:
  stable/12/   (props changed)

Modified: stable/12/sbin/ipfw/ipfw.8
==
--- stable/12/sbin/ipfw/ipfw.8  Fri Nov 30 23:47:57 2018(r341354)
+++ stable/12/sbin/ipfw/ipfw.8  Fri Nov 30 23:51:53 2018(r341355)
@@ -4588,7 +4588,7 @@ The ipfw core (ipfw2) has been completely redesigned a
 reimplemented by Luigi Rizzo in summer 2002.
 Further
 actions and
-options have been added by various developer over the years.
+options have been added by various developers over the years.
 .Pp
 .An -nosplit
 In-kernel NAT support written by
___
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: r341121 - stable/12/sbin/ipfw

2018-11-28 Thread Guangyuan Yang
Author: ygy (doc committer)
Date: Wed Nov 28 09:10:28 2018
New Revision: 341121
URL: https://svnweb.freebsd.org/changeset/base/341121

Log:
  MFC r340717:
  
  Fix incorrect DSCP value range from 0..64 to 0..63.
  
  PR:   232786
  Submitted by: Sergey Akhmatov 
  Reviewed by:  AllanJude

Modified:
  stable/12/sbin/ipfw/ipfw.8
Directory Properties:
  stable/12/   (props changed)

Modified: stable/12/sbin/ipfw/ipfw.8
==
--- stable/12/sbin/ipfw/ipfw.8  Wed Nov 28 06:56:34 2018(r341120)
+++ stable/12/sbin/ipfw/ipfw.8  Wed Nov 28 09:10:28 2018(r341121)
@@ -1138,11 +1138,11 @@ Supported values are:
 .Pq Dv 101110 ,
 .Cm be
 .Pq Dv 00 .
-Additionally, DSCP value can be specified by number (0..64).
+Additionally, DSCP value can be specified by number (0..63).
 It is also possible to use the
 .Cm tablearg
 keyword with setdscp.
-If the tablearg value is not within the 0..64 range, lower 6 bits of supplied
+If the tablearg value is not within the 0..63 range, lower 6 bits of supplied
 value are used.
 .It Cm tcp-setmss Ar mss
 Set the Maximum Segment Size (MSS) in the TCP segment to value
___
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: r341007 - head/stand/i386/pxeldr

2018-11-27 Thread Guangyuan Yang
Author: ygy (doc committer)
Date: Tue Nov 27 08:51:15 2018
New Revision: 341007
URL: https://svnweb.freebsd.org/changeset/base/341007

Log:
  Bump the date of pxeboot(8) manual page for r340917.
  
  PR:   123484
  MFC after:5 days

Modified:
  head/stand/i386/pxeldr/pxeboot.8

Modified: head/stand/i386/pxeldr/pxeboot.8
==
--- head/stand/i386/pxeldr/pxeboot.8Tue Nov 27 04:05:38 2018
(r341006)
+++ head/stand/i386/pxeldr/pxeboot.8Tue Nov 27 08:51:15 2018
(r341007)
@@ -24,7 +24,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd May 27, 2017
+.Dd November 25, 2018
 .Dt PXEBOOT 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: r340917 - head/stand/i386/pxeldr

2018-11-25 Thread Guangyuan Yang
Author: ygy (doc committer)
Date: Sun Nov 25 09:37:57 2018
New Revision: 340917
URL: https://svnweb.freebsd.org/changeset/base/340917

Log:
  Update pxeboot(8) manual page to reflect the next-server change in the ISC 
DHCP v3 server.
  
  PR:   123484
  Submitted by: ed...@mavetju.org
  Reviewed by:  AllanJude
  MFC after:1 week

Modified:
  head/stand/i386/pxeldr/pxeboot.8

Modified: head/stand/i386/pxeldr/pxeboot.8
==
--- head/stand/i386/pxeldr/pxeboot.8Sun Nov 25 00:34:00 2018
(r340916)
+++ head/stand/i386/pxeldr/pxeboot.8Sun Nov 25 09:37:57 2018
(r340917)
@@ -58,7 +58,7 @@ The
 .Nm
 binary is loaded just like any other boot file,
 by specifying it in the DHCP server's configuration file.
-Below is a sample configuration for the ISC DHCP v2 server:
+Below is a sample configuration for the ISC DHCP v3 server:
 .Bd -literal -offset indent
 option domain-name "example.com";
 option routers 10.0.0.1;
@@ -67,6 +67,7 @@ option broadcast-address 10.0.0.255;
 option domain-name-servers 10.0.0.1;
 server-name "DHCPserver";
 server-identifier 10.0.0.1;
+next-server 10.0.0.1;
 
 default-lease-time 120;
 max-lease-time 120;
@@ -80,10 +81,11 @@ subnet 10.0.0.0 netmask 255.255.255.0 {
 }
 
 .Ed
+.Va next-server
+is the IP address of the next server in the bootstrap process, i.e.
+your TFTP server or NFS server.
 .Nm
 recognizes
-.Va next-server
-and
 .Va option root-path
 directives as the server and path to NFS mount for file requests,
 respectively, or the server to make TFTP requests 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: r340792 - head/sbin/ipfw

2018-11-22 Thread Guangyuan Yang
Author: ygy (doc committer)
Date: Fri Nov 23 03:42:05 2018
New Revision: 340792
URL: https://svnweb.freebsd.org/changeset/base/340792

Log:
  Fix a minor typo in ipfw(8) manual page.
  
  PR:   230747
  Submitted by: f.tos...@hotmail.it
  MFC after:1 week

Modified:
  head/sbin/ipfw/ipfw.8

Modified: head/sbin/ipfw/ipfw.8
==
--- head/sbin/ipfw/ipfw.8   Fri Nov 23 01:07:12 2018(r340791)
+++ head/sbin/ipfw/ipfw.8   Fri Nov 23 03:42:05 2018(r340792)
@@ -4567,7 +4567,7 @@ The ipfw core (ipfw2) has been completely redesigned a
 reimplemented by Luigi Rizzo in summer 2002.
 Further
 actions and
-options have been added by various developer over the years.
+options have been added by various developers over the years.
 .Pp
 .An -nosplit
 In-kernel NAT support written by
___
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: r340717 - head/sbin/ipfw

2018-11-20 Thread Guangyuan Yang
Author: ygy (doc committer)
Date: Wed Nov 21 00:22:31 2018
New Revision: 340717
URL: https://svnweb.freebsd.org/changeset/base/340717

Log:
  Fix incorrect DSCP value range from 0..64 to 0..63.
  
  PR:   232786
  Submitted by: Sergey Akhmatov 
  Reviewed by:  AllanJude
  MFC after:1 week

Modified:
  head/sbin/ipfw/ipfw.8

Modified: head/sbin/ipfw/ipfw.8
==
--- head/sbin/ipfw/ipfw.8   Wed Nov 21 00:21:58 2018(r340716)
+++ head/sbin/ipfw/ipfw.8   Wed Nov 21 00:22:31 2018(r340717)
@@ -1159,11 +1159,11 @@ Supported values are:
 .Pq Dv 101110 ,
 .Cm be
 .Pq Dv 00 .
-Additionally, DSCP value can be specified by number (0..64).
+Additionally, DSCP value can be specified by number (0..63).
 It is also possible to use the
 .Cm tablearg
 keyword with setdscp.
-If the tablearg value is not within the 0..64 range, lower 6 bits of supplied
+If the tablearg value is not within the 0..63 range, lower 6 bits of supplied
 value are used.
 .It Cm tcp-setmss Ar mss
 Set the Maximum Segment Size (MSS) in the TCP segment to value
___
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: r340449 - stable/11/sbin/ipfw

2018-11-15 Thread Guangyuan Yang
Author: ygy (doc committer)
Date: Thu Nov 15 08:43:17 2018
New Revision: 340449
URL: https://svnweb.freebsd.org/changeset/base/340449

Log:
  MFC r338977:
  
  Add description, parameters, options, sysctl and examples of using AQMs to 
ipfw man page. CoDel, PIE, FQ-CoDel and FQ-PIE AQM for Dummynet exist in 
FreeBSD 11 and 10.3.
  
  Submitted by: ralsa...@swin.edu.au
  Reviewed by:  AllanJude
  Differential Revision:https://reviews.freebsd.org/D12507

Modified:
  stable/11/sbin/ipfw/ipfw.8
Directory Properties:
  stable/11/   (props changed)

Modified: stable/11/sbin/ipfw/ipfw.8
==
--- stable/11/sbin/ipfw/ipfw.8  Wed Nov 14 23:15:50 2018(r340448)
+++ stable/11/sbin/ipfw/ipfw.8  Thu Nov 15 08:43:17 2018(r340449)
@@ -1,7 +1,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd August 10, 2018
+.Dd September 27, 2018
 .Dt IPFW 8
 .Os
 .Sh NAME
@@ -2711,7 +2711,7 @@ The following case-insensitive parameters can be confi
 scheduler:
 .Pp
 .Bl -tag -width indent -compact
-.It Cm type Ar {fifo | wf2q+ | rr | qfq}
+.It Cm type Ar {fifo | wf2q+ | rr | qfq | fq_codel | fq_pie}
 specifies the scheduling algorithm to use.
 .Bl -tag -width indent -compact
 .It Cm fifo
@@ -2738,9 +2738,70 @@ with poor service guarantees.
 implements the QFQ algorithm, which is a very fast variant of
 WF2Q+, with similar service guarantees and O(1) processing
 costs (roughly, 200-250ns per packet).
+.It Cm fq_codel
+implements the FQ-CoDel (FlowQueue-CoDel) scheduler/AQM algorithm, which
+uses a modified Deficit Round Robin scheduler to manage two lists of sub-queues
+(old sub-queues and new sub-queues) for providing brief periods of priority to
+lightweight or short burst flows.
+By default, the total number of sub-queues is 1024.
+FQ-CoDel's internal, dynamically
+created sub-queues are controlled by separate instances of CoDel AQM.
+.It Cm fq_pie
+implements the FQ-PIE (FlowQueue-PIE) scheduler/AQM algorithm, which similar to
+.Cm fq_codel
+but uses per sub-queue PIE AQM instance to control the queue delay.
 .El
+.Pp
+.Cm fq_codel
+inherits AQM parameters and options from
+.Cm codel
+(see below), and
+.Cm fq_pie
+inherits AQM parameters and options from
+.Cm pie
+(see below).
+Additionally, both of
+.Cm fq_codel
+and
+.Cm fq_pie
+have shared scheduler parameters which are:
+.Bl -tag -width indent
+.It Cm quantum
+.Ar m
+specifies the quantum (credit) of the scheduler.
+.Ar m
+is the number of bytes a queue can serve before being moved to the tail
+of old queues list.
+The default is 1514 bytes, and the maximum accepable value
+is 9000 bytes.
+.It Cm limit
+.Ar m
+specifies the hard size limit (in unit of packets) of all queues managed by an
+instance of the scheduler.
+The default value of
+.Ar m
+is 10240 packets, and the maximum accepable value is 20480 packets.
+.It Cm flows
+.Ar m
+specifies the total number of flow queues (sub-queues) that fq_*
+creates and manages.
+By default, 1024 sub-queues are created when an instance
+of the fq_{codel/pie} scheduler is created.
+The maximum accepable value is
+65536.
 .El
 .Pp
+Note that any token after
+.Cm fq_codel
+or
+.Cm fq_pie
+is considered a parameter for fq_{codel/pie}.
+So, ensure all scheduler
+configuration options not related to fq_{codel/pie} are written before
+.Cm fq_codel/fq_pie
+tokens.
+.El
+.Pp
 In addition to the type, all parameters allowed for a pipe can also
 be specified for a scheduler.
 .Pp
@@ -2869,8 +2930,137 @@ greater than zero)
 specifies the expected maximum packet size, only used when queue
 thresholds are in bytes (defaults to 1500, must be greater than zero).
 .El
+.Pp
+.It Cm codel Oo Cm target Ar time Oc Oo Cm interval Ar time Oc Oo Cm ecn |
+.Cm noecn Oc
+Make use of the CoDel (Controlled-Delay) queue management algorithm.
+.Ar time
+is interpreted as milliseconds by default but seconds (s), milliseconds (ms) or
+microseconds (us) can be specified instead.
+CoDel drops or marks (ECN) packets
+depending on packet sojourn time in the queue.
+.Cm target
+.Ar time
+(5ms by default) is the minimum acceptable persistent queue delay that CoDel
+allows.
+CoDel does not drop packets directly after packets sojourn time becomes
+higher than
+.Cm target
+.Ar time
+but waits for
+.Cm interval
+.Ar time
+(100ms default) before dropping.
+.Cm interval
+.Ar time
+should be set to maximum RTT for all expected connections.
+.Cm ecn
+enables (disabled by default) packet marking (instead of dropping) for
+ECN-enabled TCP flows when queue delay becomes high.
+.Pp
+Note that any token after
+.Cm codel
+is considered a parameter for CoDel.
+So, ensure all pipe/queue
+configuration options are written before
+.Cm codel
+token.
+.Pp
+The
+.Xr sysctl 8
+variables
+.Va net.inet.ip.dummynet.codel.target
+and
+.Va net.inet.ip.dummynet.codel.interval
+can be used to set CoDel default parameters.
+.Pp
+.It Cm pie Oo Cm target Ar time Oc Oo Cm tupdate Ar time Oc Oo
+.Cm alpha Ar n Oc Oo Cm beta Ar n Oc 

svn commit: r338977 - head/sbin/ipfw

2018-09-27 Thread Guangyuan Yang
Author: ygy (doc committer)
Date: Thu Sep 27 18:14:01 2018
New Revision: 338977
URL: https://svnweb.freebsd.org/changeset/base/338977

Log:
  Add description, parameters, options, sysctl and examples of using AQMs to 
ipfw man page. CoDel, PIE, FQ-CoDel and FQ-PIE AQM for Dummynet exist in 
FreeBSD 11 and 10.3.
  
  Submitted by: ralsa...@swin.edu.au
  Reviewed by:  AllanJude
  Approved by:  re (gjb)
  MFC after:1 week
  Differential Revision:https://reviews.freebsd.org/D12507

Modified:
  head/sbin/ipfw/ipfw.8

Modified: head/sbin/ipfw/ipfw.8
==
--- head/sbin/ipfw/ipfw.8   Thu Sep 27 17:33:59 2018(r338976)
+++ head/sbin/ipfw/ipfw.8   Thu Sep 27 18:14:01 2018(r338977)
@@ -1,7 +1,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd August 10, 2018
+.Dd September 27, 2018
 .Dt IPFW 8
 .Os
 .Sh NAME
@@ -2711,7 +2711,7 @@ The following case-insensitive parameters can be confi
 scheduler:
 .Pp
 .Bl -tag -width indent -compact
-.It Cm type Ar {fifo | wf2q+ | rr | qfq}
+.It Cm type Ar {fifo | wf2q+ | rr | qfq | fq_codel | fq_pie}
 specifies the scheduling algorithm to use.
 .Bl -tag -width indent -compact
 .It Cm fifo
@@ -2738,9 +2738,70 @@ with poor service guarantees.
 implements the QFQ algorithm, which is a very fast variant of
 WF2Q+, with similar service guarantees and O(1) processing
 costs (roughly, 200-250ns per packet).
+.It Cm fq_codel
+implements the FQ-CoDel (FlowQueue-CoDel) scheduler/AQM algorithm, which
+uses a modified Deficit Round Robin scheduler to manage two lists of sub-queues
+(old sub-queues and new sub-queues) for providing brief periods of priority to
+lightweight or short burst flows.
+By default, the total number of sub-queues is 1024.
+FQ-CoDel's internal, dynamically
+created sub-queues are controlled by separate instances of CoDel AQM.
+.It Cm fq_pie
+implements the FQ-PIE (FlowQueue-PIE) scheduler/AQM algorithm, which similar to
+.Cm fq_codel
+but uses per sub-queue PIE AQM instance to control the queue delay.
 .El
+.Pp
+.Cm fq_codel
+inherits AQM parameters and options from
+.Cm codel
+(see below), and
+.Cm fq_pie
+inherits AQM parameters and options from
+.Cm pie
+(see below).
+Additionally, both of
+.Cm fq_codel
+and
+.Cm fq_pie
+have shared scheduler parameters which are:
+.Bl -tag -width indent
+.It Cm quantum
+.Ar m
+specifies the quantum (credit) of the scheduler.
+.Ar m
+is the number of bytes a queue can serve before being moved to the tail
+of old queues list.
+The default is 1514 bytes, and the maximum accepable value
+is 9000 bytes.
+.It Cm limit
+.Ar m
+specifies the hard size limit (in unit of packets) of all queues managed by an
+instance of the scheduler.
+The default value of
+.Ar m
+is 10240 packets, and the maximum accepable value is 20480 packets.
+.It Cm flows
+.Ar m
+specifies the total number of flow queues (sub-queues) that fq_*
+creates and manages.
+By default, 1024 sub-queues are created when an instance
+of the fq_{codel/pie} scheduler is created.
+The maximum accepable value is
+65536.
 .El
 .Pp
+Note that any token after
+.Cm fq_codel
+or
+.Cm fq_pie
+is considered a parameter for fq_{codel/pie}.
+So, ensure all scheduler
+configuration options not related to fq_{codel/pie} are written before
+.Cm fq_codel/fq_pie
+tokens.
+.El
+.Pp
 In addition to the type, all parameters allowed for a pipe can also
 be specified for a scheduler.
 .Pp
@@ -2869,8 +2930,137 @@ greater than zero)
 specifies the expected maximum packet size, only used when queue
 thresholds are in bytes (defaults to 1500, must be greater than zero).
 .El
+.Pp
+.It Cm codel Oo Cm target Ar time Oc Oo Cm interval Ar time Oc Oo Cm ecn |
+.Cm noecn Oc
+Make use of the CoDel (Controlled-Delay) queue management algorithm.
+.Ar time
+is interpreted as milliseconds by default but seconds (s), milliseconds (ms) or
+microseconds (us) can be specified instead.
+CoDel drops or marks (ECN) packets
+depending on packet sojourn time in the queue.
+.Cm target
+.Ar time
+(5ms by default) is the minimum acceptable persistent queue delay that CoDel
+allows.
+CoDel does not drop packets directly after packets sojourn time becomes
+higher than
+.Cm target
+.Ar time
+but waits for
+.Cm interval
+.Ar time
+(100ms default) before dropping.
+.Cm interval
+.Ar time
+should be set to maximum RTT for all expected connections.
+.Cm ecn
+enables (disabled by default) packet marking (instead of dropping) for
+ECN-enabled TCP flows when queue delay becomes high.
+.Pp
+Note that any token after
+.Cm codel
+is considered a parameter for CoDel.
+So, ensure all pipe/queue
+configuration options are written before
+.Cm codel
+token.
+.Pp
+The
+.Xr sysctl 8
+variables
+.Va net.inet.ip.dummynet.codel.target
+and
+.Va net.inet.ip.dummynet.codel.interval
+can be used to set CoDel default parameters.
+.Pp
+.It Cm pie Oo Cm target Ar time Oc Oo Cm tupdate Ar time Oc Oo
+.Cm alpha Ar n Oc Oo Cm beta Ar n Oc Oo Cm max_burst Ar time Oc Oo
+.C

svn commit: r334895 - head/usr.bin/calendar/calendars

2018-06-09 Thread Guangyuan Yang
Author: ygy (doc committer)
Date: Sat Jun  9 21:05:25 2018
New Revision: 334895
URL: https://svnweb.freebsd.org/changeset/base/334895

Log:
  Add myself to the calendar
  
  Requested by: mckusick
  Reviewed by:  emaste

Modified:
  head/usr.bin/calendar/calendars/calendar.freebsd

Modified: head/usr.bin/calendar/calendars/calendar.freebsd
==
--- head/usr.bin/calendar/calendars/calendar.freebsdSat Jun  9 20:24:17 
2018(r334894)
+++ head/usr.bin/calendar/calendars/calendar.freebsdSat Jun  9 21:05:25 
2018(r334895)
@@ -17,6 +17,7 @@
 01/06  Philippe Audeoud  born in Bretigny-Sur-Orge, 
France, 1980
 01/08  Michael L. Hostbaek  born in Copenhagen, Denmark, 1977
 01/10  Jean-Yves Lefort  born in Charleroi, Belgium, 1980
+01/10  Guangyuan Yang  born in Yangzhou, Jiangsu, People's 
Republic of China, 1997
 01/12  Yen-Ming Lee  born in Taipei, Taiwan, Republic of 
China, 1977
 01/12  Ying-Chieh Liao  born in Taipei, Taiwan, Republic 
of China, 1979
 01/12  Kristof Provost  born in Aalst, Belgium, 1983
___
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: r324441 - head/usr.sbin/freebsd-update

2017-10-09 Thread Guangyuan Yang
Author: ygy (doc committer)
Date: Mon Oct  9 16:33:37 2017
New Revision: 324441
URL: https://svnweb.freebsd.org/changeset/base/324441

Log:
  Fix freebsd-update(8) erroneous message and exit status when "fetch install" 
used.
  
  PR:   190660
  Reviewed by:  allanjude
  Approved by:  emaste
  Differential Revision:https://reviews.freebsd.org/D12037

Modified:
  head/usr.sbin/freebsd-update/freebsd-update.sh

Modified: head/usr.sbin/freebsd-update/freebsd-update.sh
==
--- head/usr.sbin/freebsd-update/freebsd-update.sh  Mon Oct  9 16:27:31 
2017(r324440)
+++ head/usr.sbin/freebsd-update/freebsd-update.sh  Mon Oct  9 16:33:37 
2017(r324441)
@@ -418,6 +418,9 @@ init_params () {
 
# Run without a TTY
NOTTYOK=0
+
+   # Fetched first in a chain of commands
+   ISFETCHED=0
 }
 
 # Parse the command line
@@ -783,8 +786,10 @@ install_check_params () {
# Check that we have updates ready to install
if ! [ -L ${BDHASH}-install ]; then
echo "No updates are available to install."
-   echo "Run '$0 fetch' first."
-   exit 1
+   if [ $ISFETCHED -eq 0 ]; then
+   echo "Run '$0 fetch' first."
+   fi
+   exit 0
fi
if ! [ -f ${BDHASH}-install/INDEX-OLD ] ||
! [ -f ${BDHASH}-install/INDEX-NEW ]; then
@@ -3241,6 +3246,7 @@ cmd_fetch () {
fi
fetch_check_params
fetch_run || exit 1
+   ISFETCHED=1
 }
 
 # Cron command.  Make sure the parameters are sensible; 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"