CVS commit: src/usr.bin/ktrace
Module Name:src Committed By: uwe Date: Sat May 6 10:45:14 UTC 2023 Modified Files: src/usr.bin/ktrace: ktrace.1 Log Message: ktrace(1): tweak -c wording for clarity To generate a diff of this commit: cvs rdiff -u -r1.47 -r1.48 src/usr.bin/ktrace/ktrace.1 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/usr.bin/ktrace/ktrace.1 diff -u src/usr.bin/ktrace/ktrace.1:1.47 src/usr.bin/ktrace/ktrace.1:1.48 --- src/usr.bin/ktrace/ktrace.1:1.47 Fri Sep 2 03:43:53 2022 +++ src/usr.bin/ktrace/ktrace.1 Sat May 6 10:45:14 2023 @@ -1,4 +1,4 @@ -.\" $NetBSD: ktrace.1,v 1.47 2022/09/02 03:43:53 gutteridge Exp $ +.\" $NetBSD: ktrace.1,v 1.48 2023/05/06 10:45:14 uwe Exp $ .\" .\" Copyright (c) 1990, 1993 .\" The Regents of the University of California. All rights reserved. @@ -103,10 +103,14 @@ The options are as follows: .It Fl a Append to the trace file instead of truncating it. .It Fl C -Disable tracing on all user owned processes, and, if executed by root, all +Clear +.Pq disable +tracing on all user owned processes, and, if executed by root, all processes in the system. .It Fl c -Clear the trace points associated with the specified file or processes. +Clear +.Pq disable +the trace points associated with the specified file or processes. .It Fl d Descendants; perform the operation for all current children of the designated processes. @@ -124,9 +128,12 @@ Read the trace records from .Ar infile and print them in a human readable format to standard out. .It Fl g Ar pgid -Enable (disable) tracing on all processes in the process group (only one +Enable +.Pq disable with Fl c +tracing on all processes in the process group. +Only one .Fl g -flag is permitted). +flag is permitted. .It Fl i Inherit; pass the trace flags to all future children of the designated processes. @@ -161,9 +168,12 @@ Without this option will print its output in a human readable format to standard out. .It Fl p Ar pid -Enable (disable) tracing on the indicated process id (only one +Enable +.Pq disable with Fl c +tracing on the indicated process id. +Only one .Fl p -flag is permitted). +flag is permitted. .It Fl R Display relative time stamps to output. .It Fl s
CVS commit: src/usr.bin/ktrace
Module Name:src Committed By: uwe Date: Sat May 6 10:45:14 UTC 2023 Modified Files: src/usr.bin/ktrace: ktrace.1 Log Message: ktrace(1): tweak -c wording for clarity To generate a diff of this commit: cvs rdiff -u -r1.47 -r1.48 src/usr.bin/ktrace/ktrace.1 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src
Module Name:src Committed By: uwe Date: Thu May 4 11:30:25 UTC 2023 Modified Files: src/lib/libcurses/PSD.doc: twinkle1.c src/share/man/man0: title.cdrom title.urm Log Message: Fix spelling of Kurt Shoens surname. PR misc/57389 To generate a diff of this commit: cvs rdiff -u -r1.6 -r1.7 src/lib/libcurses/PSD.doc/twinkle1.c cvs rdiff -u -r1.7 -r1.8 src/share/man/man0/title.cdrom cvs rdiff -u -r1.9 -r1.10 src/share/man/man0/title.urm Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/lib/libcurses/PSD.doc/twinkle1.c diff -u src/lib/libcurses/PSD.doc/twinkle1.c:1.6 src/lib/libcurses/PSD.doc/twinkle1.c:1.7 --- src/lib/libcurses/PSD.doc/twinkle1.c:1.6 Mon May 23 04:04:49 2005 +++ src/lib/libcurses/PSD.doc/twinkle1.c Thu May 4 11:30:25 2023 @@ -1,4 +1,4 @@ -/* $NetBSD: twinkle1.c,v 1.6 2005/05/23 04:04:49 christos Exp $ */ +/* $NetBSD: twinkle1.c,v 1.7 2023/05/04 11:30:25 uwe Exp $ */ /* * @@ -36,7 +36,7 @@ /* * the idea for this program was a product of the imagination of - * Kurt Schoens. Not responsible for minds lost or stolen. + * Kurt Shoens. Not responsible for minds lost or stolen. */ #define NCOLS 80 Index: src/share/man/man0/title.cdrom diff -u src/share/man/man0/title.cdrom:1.7 src/share/man/man0/title.cdrom:1.8 --- src/share/man/man0/title.cdrom:1.7 Thu Dec 16 17:42:28 2010 +++ src/share/man/man0/title.cdrom Thu May 4 11:30:25 2023 @@ -1,4 +1,4 @@ -.\" $NetBSD: title.cdrom,v 1.7 2010/12/16 17:42:28 wiz Exp $ +.\" $NetBSD: title.cdrom,v 1.8 2023/05/04 11:30:25 uwe Exp $ .\" .\" Copyright (c) 1994 Regents of the University of California. .\" All rights reserved. @@ -410,7 +410,7 @@ adventure(6) Will Crowther ls(1) Elan Am apply(1) Rob Pike ls(1) Michael Fischbein apply(1) Jan-Simon Pendry lsearch(3) Roger L. Snyder ar(1) Hugh A. Smith m4(1) Ozan Yigit -arithmetic(6) Eamonn McManus mail(1) Kurt Schoens +arithmetic(6) Eamonn McManus mail(1) Kurt Shoens arp(8) Sun Microsystems Inc. make(1) Adam de Boor at(1) Steve Wall me(7) Eric Allman atc(6) Ed James mergesort(3) Peter McIlroy @@ -474,7 +474,7 @@ file(1) Ian Darwin swab(3) Jeffrey Mogul find(1) Cimarron Taylor sysconf(3) Sean Eric Fagan finger(1) Tony Nardo sysline(1) J.K. Foderaro fish(6) Muffy Barkocy syslog(3) Eric Allman -fmt(1) Kurt Schoens systat(1) Bill Reeves +fmt(1) Kurt Shoens systat(1) Bill Reeves fnmatch(3) Guido van Rossum systat(1) Robert Elz fold(1) Kevin Ruddy tail(1) Edward Sze-Tyan Wang fortune(6) Ken Arnold talk(1) Clem Cole Index: src/share/man/man0/title.urm diff -u src/share/man/man0/title.urm:1.9 src/share/man/man0/title.urm:1.10 --- src/share/man/man0/title.urm:1.9 Thu Dec 16 17:42:28 2010 +++ src/share/man/man0/title.urm Thu May 4 11:30:25 2023 @@ -1,4 +1,4 @@ -.\" $NetBSD: title.urm,v 1.9 2010/12/16 17:42:28 wiz Exp $ +.\" $NetBSD: title.urm,v 1.10 2023/05/04 11:30:25 uwe Exp $ .\" .\" Copyright (c) 1980, 1993, 1994 Regents of the University of California. .\" All rights reserved. @@ -436,7 +436,7 @@ adventure(6) Will Crowther ls(1) Elan Am apply(1) Rob Pike ls(1) Michael Fischbein apply(1) Jan-Simon Pendry lsearch(3) Roger L. Snyder ar(1) Hugh A. Smith m4(1) Ozan Yigit -arithmetic(6) Eamonn McManus mail(1) Kurt Schoens +arithmetic(6) Eamonn McManus mail(1) Kurt Shoens arp(8) Sun Microsystems Inc. make(1) Adam de Boor at(1) Steve Wall me(7) Eric Allman atc(6) Ed James mergesort(3) Peter McIlroy @@ -500,7 +500,7 @@ file(1) Ian Darwin swab(3) Jeffrey Mogul find(1) Cimarron Taylor sysconf(3) Sean Eric Fagan finger(1) Tony Nardo sysline(1) J.K. Foderaro fish(6) Muffy Barkocy syslog(3) Eric Allman -fmt(1) Kurt Schoens systat(1) Bill Reeves +fmt(1) Kurt Shoens systat(1) Bill Reeves fnmatch(3) Guido van Rossum systat(1) Robert Elz fold(1) Kevin Ruddy tail(1) Edward Sze-Tyan Wang fortune(6) Ken Arnold talk(1) Clem Cole
CVS commit: src
Module Name:src Committed By: uwe Date: Thu May 4 11:30:25 UTC 2023 Modified Files: src/lib/libcurses/PSD.doc: twinkle1.c src/share/man/man0: title.cdrom title.urm Log Message: Fix spelling of Kurt Shoens surname. PR misc/57389 To generate a diff of this commit: cvs rdiff -u -r1.6 -r1.7 src/lib/libcurses/PSD.doc/twinkle1.c cvs rdiff -u -r1.7 -r1.8 src/share/man/man0/title.cdrom cvs rdiff -u -r1.9 -r1.10 src/share/man/man0/title.urm Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/lib/libpthread
Module Name:src Committed By: uwe Date: Sat Apr 29 21:37:07 UTC 2023 Modified Files: src/lib/libpthread: pthread_create.3 Log Message: pthread_create(3): minor markup tweaks To generate a diff of this commit: cvs rdiff -u -r1.8 -r1.9 src/lib/libpthread/pthread_create.3 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/lib/libpthread/pthread_create.3 diff -u src/lib/libpthread/pthread_create.3:1.8 src/lib/libpthread/pthread_create.3:1.9 --- src/lib/libpthread/pthread_create.3:1.8 Sat Apr 29 20:51:45 2023 +++ src/lib/libpthread/pthread_create.3 Sat Apr 29 21:37:07 2023 @@ -1,4 +1,4 @@ -.\" $NetBSD: pthread_create.3,v 1.8 2023/04/29 20:51:45 jschauma Exp $ +.\" $NetBSD: pthread_create.3,v 1.9 2023/04/29 21:37:07 uwe Exp $ .\" .\" Copyright (c) 2002 The NetBSD Foundation, Inc. .\" All rights reserved. @@ -64,8 +64,15 @@ .Lb libpthread .Sh SYNOPSIS .In pthread.h +. .Ft int -.Fn pthread_create "pthread_t * restrict thread" "const pthread_attr_t * restrict attr" "void *(*start_routine)(void *)" "void * restrict arg" +.Fo pthread_create +.Fa "pthread_t * restrict thread" +.Fa "const pthread_attr_t * restrict attr" +.Fa "void *(*start_routine)(void *)" +.Fa "void * restrict arg" +.Fc +. .Sh DESCRIPTION The .Fn pthread_create @@ -103,7 +110,7 @@ as its sole argument. If the .Fa start_routine returns, the effect is as if there was an implicit call to -.Fn pthread_exit +.Xr pthread_exit 3 using the return value of .Fa start_routine as the exit status. @@ -113,7 +120,7 @@ was originally invoked differs from this When it returns from .Fn main , the effect is as if there was an implicit call to -.Fn exit +.Xr exit 3 using the return value of .Fn main as the exit status.
CVS commit: src/lib/libpthread
Module Name:src Committed By: uwe Date: Sat Apr 29 21:37:07 UTC 2023 Modified Files: src/lib/libpthread: pthread_create.3 Log Message: pthread_create(3): minor markup tweaks To generate a diff of this commit: cvs rdiff -u -r1.8 -r1.9 src/lib/libpthread/pthread_create.3 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/tests/rump/modautoload
Module Name:src Committed By: uwe Date: Mon Apr 24 20:55:53 UTC 2023 Modified Files: src/tests/rump/modautoload: Makefile Log Message: tests/rump/modautoload: reorder -lrumpvfs_nofifofs Make the way we spell "-lrumpvfs -lrumpvfs_nofifofs" hack consistent. The order doesn't matter here because of --whole-archive. To generate a diff of this commit: cvs rdiff -u -r1.13 -r1.14 src/tests/rump/modautoload/Makefile Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/tests/rump/modautoload/Makefile diff -u src/tests/rump/modautoload/Makefile:1.13 src/tests/rump/modautoload/Makefile:1.14 --- src/tests/rump/modautoload/Makefile:1.13 Wed Jul 7 11:51:45 2021 +++ src/tests/rump/modautoload/Makefile Mon Apr 24 20:55:53 2023 @@ -1,4 +1,4 @@ -# $NetBSD: Makefile,v 1.13 2021/07/07 11:51:45 martin Exp $ +# $NetBSD: Makefile,v 1.14 2023/04/24 20:55:53 uwe Exp $ # .include @@ -19,7 +19,7 @@ LDFLAGS+= -Wl,--no-relax .endif LDADD+= \ -Wl,--whole-archive -Wl,-Bstatic \ - -lrumpvfs_nofifofs -lrumpvfs -lrump \ + -lrumpvfs -lrumpvfs_nofifofs -lrump \ -Wl,-Bdynamic -Wl,--no-whole-archive LDADD+= -lrumpuser -lpthread
CVS commit: src/tests/rump/modautoload
Module Name:src Committed By: uwe Date: Mon Apr 24 20:55:53 UTC 2023 Modified Files: src/tests/rump/modautoload: Makefile Log Message: tests/rump/modautoload: reorder -lrumpvfs_nofifofs Make the way we spell "-lrumpvfs -lrumpvfs_nofifofs" hack consistent. The order doesn't matter here because of --whole-archive. To generate a diff of this commit: cvs rdiff -u -r1.13 -r1.14 src/tests/rump/modautoload/Makefile Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/tests
Module Name:src Committed By: uwe Date: Mon Apr 24 20:35:49 UTC 2023 Modified Files: src/tests: Makefile.inc Log Message: tests: trim down the list of LIBRUMPBASE libraries Now that cyclic dependencies are (mostly) broken, we can drop repeated -l instances that worked around those cycles. Links on sun2. To generate a diff of this commit: cvs rdiff -u -r1.10 -r1.11 src/tests/Makefile.inc Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/tests
Module Name:src
Committed By: uwe
Date: Mon Apr 24 20:35:49 UTC 2023
Modified Files:
src/tests: Makefile.inc
Log Message:
tests: trim down the list of LIBRUMPBASE libraries
Now that cyclic dependencies are (mostly) broken, we can drop repeated
-l instances that worked around those cycles. Links on sun2.
To generate a diff of this commit:
cvs rdiff -u -r1.10 -r1.11 src/tests/Makefile.inc
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/tests/Makefile.inc
diff -u src/tests/Makefile.inc:1.10 src/tests/Makefile.inc:1.11
--- src/tests/Makefile.inc:1.10 Wed Jul 7 11:51:45 2021
+++ src/tests/Makefile.inc Mon Apr 24 20:35:49 2023
@@ -1,4 +1,4 @@
-# $NetBSD: Makefile.inc,v 1.10 2021/07/07 11:51:45 martin Exp $
+# $NetBSD: Makefile.inc,v 1.11 2023/04/24 20:35:49 uwe Exp $
WARNS ?= 4
CWARNFLAGS+= -Wno-missing-noreturn
TOOLSSRCDIR:= ${.PARSEDIR}
@@ -7,7 +7,7 @@ CPPFLAGS+= -I${TOOLSSRCDIR}
LIBRUMPFIFO_PRE = -lrumpvfs_fifofs -lrumpnet_local -lrumpnet_net -lrumpnet
.endif
LIBRUMPFIFO = -lrumpvfs_nofifofs
-LIBRUMPBASE = ${LIBRUMPFIFO_PRE} -lrumpvfs -lrump -lrumpvfs -lrumpvfs_nofifofs -lrumpuser -lrump -lpthread
+LIBRUMPBASE = ${LIBRUMPFIFO_PRE} -lrumpvfs -lrumpvfs_nofifofs -lrump -lrumpuser -lpthread
.if ${RUMP_SANITIZE:Uno} != "no"
LIBRUMPBASE+= -fsanitize=${RUMP_SANITIZE}
CVS commit: src/usr.bin/rump_wmd
Module Name:src Committed By: uwe Date: Mon Apr 24 19:12:33 UTC 2023 Modified Files: src/usr.bin/rump_wmd: rump_wmd.1 Log Message: rump_wmd(1): there is no space in -lcomponent A couple of minor markup tweaks while here. To generate a diff of this commit: cvs rdiff -u -r1.3 -r1.4 src/usr.bin/rump_wmd/rump_wmd.1 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/usr.bin/rump_wmd/rump_wmd.1 diff -u src/usr.bin/rump_wmd/rump_wmd.1:1.3 src/usr.bin/rump_wmd/rump_wmd.1:1.4 --- src/usr.bin/rump_wmd/rump_wmd.1:1.3 Tue Jan 28 14:02:54 2014 +++ src/usr.bin/rump_wmd/rump_wmd.1 Mon Apr 24 19:12:33 2023 @@ -1,4 +1,4 @@ -.\" $NetBSD: rump_wmd.1,v 1.3 2014/01/28 14:02:54 pooka Exp $ +.\" $NetBSD: rump_wmd.1,v 1.4 2023/04/24 19:12:33 uwe Exp $ .\" .\" Copyright (c) 2014 Antti Kantee. All rights reserved. .\" @@ -33,7 +33,7 @@ .Nm .Op Fl hv .Op Fl L Ar dir -.Fl l Ar component +.Fl l Ns Ar component Ar \&... .Sh DESCRIPTION The .Nm @@ -48,7 +48,7 @@ is accepted as command line input by .Xr rump_server 1 . .Pp The command line options are: -.Bl -tag -width indent +.Bl -tag -width Fl .It Fl h Print the usage. .It Fl L Ar dir @@ -64,7 +64,7 @@ This option may be given multiple times. .El .Pp The desired components are given using -.Fl l Ar component . +.Fl l Ns Ar component . This parameter may be specified multiple time and must be the last set of parameters. .Sh EXAMPLES @@ -95,4 +95,5 @@ a rump kernel booting in 10ms is somewha Caching the output is highly recommended. .Sh FUN FACTS .Nm -is short for "rump, where's my dependency". +is short for +.Dq rump, where's my dependency .
CVS commit: src/usr.bin/rump_wmd
Module Name:src Committed By: uwe Date: Mon Apr 24 19:12:33 UTC 2023 Modified Files: src/usr.bin/rump_wmd: rump_wmd.1 Log Message: rump_wmd(1): there is no space in -lcomponent A couple of minor markup tweaks while here. To generate a diff of this commit: cvs rdiff -u -r1.3 -r1.4 src/usr.bin/rump_wmd/rump_wmd.1 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/usr.bin/rump_allserver
Module Name:src
Committed By: uwe
Date: Mon Apr 24 18:54:22 UTC 2023
Modified Files:
src/usr.bin/rump_allserver: Makefile
Log Message:
rump_allserver: trim down the list of libraries
Now that cyclic dependencies are (mostly) broken, we can drop repeated
-l instances that worked around those cycles. Links on sun2.
To generate a diff of this commit:
cvs rdiff -u -r1.15 -r1.16 src/usr.bin/rump_allserver/Makefile
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/usr.bin/rump_allserver/Makefile
diff -u src/usr.bin/rump_allserver/Makefile:1.15 src/usr.bin/rump_allserver/Makefile:1.16
--- src/usr.bin/rump_allserver/Makefile:1.15 Mon Nov 1 21:37:33 2021
+++ src/usr.bin/rump_allserver/Makefile Mon Apr 24 18:54:22 2023
@@ -1,4 +1,4 @@
-# $NetBSD: Makefile,v 1.15 2021/11/01 21:37:33 nia Exp $
+# $NetBSD: Makefile,v 1.16 2023/04/24 18:54:22 uwe Exp $
#
PROG= rump_allserver
@@ -14,7 +14,8 @@ RUMPTOP=${.CURDIR}/../../sys/rump
.include "${RUMPTOP}/net/Makefile.rumpnetcomp"
LDADD+= ${RUMPDEVLDADD} ${RUMPFSLDADD} ${RUMPKERNLDADD} ${RUMPNETLDADD}
-LDADD+= -lrumpdev -lrumpnet -lrumpvfs -lrump -lrumpvfs -lrumpvfs_nofifofs -lrump -lrumpuser -lpthread
+LDADD+= -lrumpdev -lrumpnet -lrumpvfs -lrumpvfs_nofifofs
+LDADD+= -lrump -lrumpuser -lpthread
.if ${RUMP_SANITIZE:Uno} != "no"
LDADD+= -fsanitize=${RUMP_SANITIZE}
CVS commit: src/usr.bin/rump_allserver
Module Name:src Committed By: uwe Date: Mon Apr 24 18:54:22 UTC 2023 Modified Files: src/usr.bin/rump_allserver: Makefile Log Message: rump_allserver: trim down the list of libraries Now that cyclic dependencies are (mostly) broken, we can drop repeated -l instances that worked around those cycles. Links on sun2. To generate a diff of this commit: cvs rdiff -u -r1.15 -r1.16 src/usr.bin/rump_allserver/Makefile Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/usr.bin/rump_allserver
Module Name:src Committed By: uwe Date: Mon Apr 24 00:07:04 UTC 2023 Modified Files: src/usr.bin/rump_allserver: rump_allserver.1 Log Message: rump_allserver(1): fix markup, clarify Reorder text for the -d option to hopefully make it easier to follow. Clarify that the "disklabel" keyword takes partion letter (from RTFS). To generate a diff of this commit: cvs rdiff -u -r1.23 -r1.24 src/usr.bin/rump_allserver/rump_allserver.1 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/usr.bin/rump_allserver/rump_allserver.1 diff -u src/usr.bin/rump_allserver/rump_allserver.1:1.23 src/usr.bin/rump_allserver/rump_allserver.1:1.24 --- src/usr.bin/rump_allserver/rump_allserver.1:1.23 Thu Nov 5 14:02:07 2015 +++ src/usr.bin/rump_allserver/rump_allserver.1 Mon Apr 24 00:07:04 2023 @@ -1,4 +1,4 @@ -.\" $NetBSD: rump_allserver.1,v 1.23 2015/11/05 14:02:07 wiz Exp $ +.\" $NetBSD: rump_allserver.1,v 1.24 2023/04/24 00:07:04 uwe Exp $ .\" .\" Copyright (c) 2010 Antti Kantee. All rights reserved. .\" @@ -23,7 +23,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.Dd January 15, 2014 +.Dd April 24, 2023 .Dt RUMP_SERVER 1 .Os .Sh NAME @@ -61,7 +61,7 @@ provides all rump kernel components whic system was built. At execution time it is possible to load components from the command line as described in the options section. -.Bl -tag -width indent +.Bl -tag -width Fl .It Fl c Ar ncpu Configure .Ar ncpu @@ -75,76 +75,91 @@ maps a host file in the rump kernel fs n The string .Ar drivespec must be of comma-separated -.Dq name=value +.Sm off +.Ar name\^ Li = Ar value +.Sm on format and must contain the following tokens: -.Bl -tag -width hostpath1234 -.It Ar key +. +.Bl -tag -width Ic -offset indent +. +.It Ic key Block device path in rump kernel namespace. This must be specified according to the rules for a key in .Xr rump_etfs 3 . -.It Ar hostpath +. +.It Ic hostpath Host file used for storage. If the file does not exist, it will be created. -.It Ar size -Size of the mapping. -Similar to -.Xr dd 1 , -this argument accepts a suffix as the multiplier for the number. -The special value -.Dq host -indicates that the current size of -.Ar hostpath -will be used. -In this case it is assumed that -.Ar hostpath -exists and is a regular file. -.It OR -.It Ar disklabel -Use a disklabel partition identifier to specify the offset and size -of the mapping. -.Ar hostpath -must contain an existing and valid disklabel within the first 64k. .El +. .Pp -The following are optional: -.Bl -tag -width hostpath1234 -.It Ar offset -Offset of the mapping. -The window into -.Ar hostpath -therefore is -.Fa [ offset , offset+size ] . -In case this parameter is not given, the default value 0 is used. -.It Ar type The type of file that -.Ar key -is exposed as within the rump kernel. -The possibilities are -.Dq blk , -.Dq chr , +.Ic key +is exposed as within the rump kernel is specified with: +. +.Bl -tag -width Ic -offset indent +.It Ic type +Possible values are +.Ql blk , +.Ql chr , and -.Dq reg +.Ql reg for block device, character device and regular file, respectively. -The default is a block device. +The default is a block device +.Pq Ql blk . .Pp -Note: the contents of block devices are cached in the rump kernel's +.Sy Note : +the contents of block devices are cached in the rump kernel's buffer cache. To avoid cache incoherency, it is advisable not to access a file through the host namespace while it is mapped as a block device in a rump kernel. .El +. +.Pp +For block and character devices the +.Bq Va offset Ns \&,\~ Ns Va offset Ns + Ns Va size +region of the file must be specified with: +. +.Bl -tag -width Ic -offset indent +. +.It Ic disklabel +Use a disklabel partition letter to specify the offset and size +of the mapping. +.Ic hostpath +must contain a valid disklabel within the first 64k. +. +.It Ic offset +Offset of the mapping. +The default is 0. +. +.It Ic size +Size of the mapping. +Similar to +.Xr dd 1 , +this argument accepts a suffix as the multiplier for the number. +The special value +.Ql host +indicates that the current size of +.Ic hostpath +will be used. +In this case it is assumed that +.Ic hostpath +exists and is a regular file. +.El +. .Pp In case -.Ar hostpath +.Ic hostpath does not exist, it will be created as a regular file with mode 0644 (plus any restrictions placed by umask). In case -.Ar hostpath +.Ic hostpath is a regular file and is not large enough to accommodate the specified size, it will be extended to the specified size. .It Fl l Ar library Call -.Fn dlopen +.Xr dlopen 3 on library before initializing the rump kernel. In case .Ar library @@ -163,13 +178,13 @@ error due to missing components. To test a configuration, run .Nm with -.Ev LD_BIND_NOW=1 -(see examples). +.Ev LD_BIND_NOW Ns Li \&=1 +.Pq see Sx
CVS commit: src/usr.bin/rump_allserver
Module Name:src Committed By: uwe Date: Mon Apr 24 00:07:04 UTC 2023 Modified Files: src/usr.bin/rump_allserver: rump_allserver.1 Log Message: rump_allserver(1): fix markup, clarify Reorder text for the -d option to hopefully make it easier to follow. Clarify that the "disklabel" keyword takes partion letter (from RTFS). To generate a diff of this commit: cvs rdiff -u -r1.23 -r1.24 src/usr.bin/rump_allserver/rump_allserver.1 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src
Module Name:src Committed By: uwe Date: Sun Apr 23 09:54:15 UTC 2023 Modified Files: src: build.sh Log Message: build.sh: drop -lrumpdev hack introduced in previous The existing trick in sys/rump/librump/rumpdev/rump_dev.c was not updated after the renames in the kernel. kudos to riastradh. PR kern/56599 To generate a diff of this commit: cvs rdiff -u -r1.367 -r1.368 src/build.sh Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/build.sh diff -u src/build.sh:1.367 src/build.sh:1.368 --- src/build.sh:1.367 Sun Apr 23 02:01:33 2023 +++ src/build.sh Sun Apr 23 09:54:15 2023 @@ -1,5 +1,5 @@ #! /usr/bin/env sh -# $NetBSD: build.sh,v 1.367 2023/04/23 02:01:33 uwe Exp $ +# $NetBSD: build.sh,v 1.368 2023/04/23 09:54:15 uwe Exp $ # # Copyright (c) 2001-2022 The NetBSD Foundation, Inc. # All rights reserved. @@ -2010,7 +2010,7 @@ createmakewrapper() eval cat < net_net #vfs -> fifo -#dev -> vfs # -lrumpvfs -> $LRUMPVFS for now LRUMPVFS="-lrumpvfs -lrumpvfs_nofifofs" -# -lrumpdev -> $LRUMPDEV -# XXX: this may hide problems with other rump libraries that are not -# supposed to depend on vfs but accidentally do -LRUMPDEV="-lrumpdev $LRUMPVFS" - RUMP_LIBSETS=" -lrump, -lrumpvfs --no-whole-archive -lrumpvfs_nofifofs -lrump, - -lrumpdev ---no-whole-archive $LRUMPVFS -lrump, -lrumpkern_tty --no-whole-archive $LRUMPVFS -lrump, -lrumpfs_tmpfs --no-whole-archive $LRUMPVFS -lrump, -lrumpfs_ffs -lrumpfs_msdos ---no-whole-archive $LRUMPVFS -lrumpdev_disk $LRUMPDEV -lrump, +--no-whole-archive $LRUMPVFS -lrumpdev_disk -lrumpdev -lrump, -lrumpnet_virtif -lrumpnet_netinet -lrumpnet_net -lrumpnet --no-whole-archive -lrump, -lrumpfs_nfs @@ -2289,7 +2281,7 @@ RUMP_LIBSETS=" -lrumpnet_sockin -lrumpnet_virtif -lrumpnet_netinet --start-group -lrumpnet_net -lrumpnet --end-group -lrump, -lrumpdev_cgd -lrumpdev_raidframe -lrumpdev_rnd -lrumpdev_dm ---no-whole-archive $LRUMPVFS -lrumpdev_disk $LRUMPDEV -lrumpkern_crypto -lrump +--no-whole-archive $LRUMPVFS -lrumpdev_disk -lrumpdev -lrumpkern_crypto -lrump " dorump()
CVS commit: src
Module Name:src Committed By: uwe Date: Sun Apr 23 09:54:15 UTC 2023 Modified Files: src: build.sh Log Message: build.sh: drop -lrumpdev hack introduced in previous The existing trick in sys/rump/librump/rumpdev/rump_dev.c was not updated after the renames in the kernel. kudos to riastradh. PR kern/56599 To generate a diff of this commit: cvs rdiff -u -r1.367 -r1.368 src/build.sh Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src
Module Name:src
Committed By: uwe
Date: Sun Apr 23 02:01:33 UTC 2023
Modified Files:
src: build.sh
Log Message:
build.sh: tweak rumptest and RUMP_LIBSETS
Use --no-whole-archive to keep us as honest as currently possible.
PR kern/56599
To generate a diff of this commit:
cvs rdiff -u -r1.366 -r1.367 src/build.sh
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/build.sh
diff -u src/build.sh:1.366 src/build.sh:1.367
--- src/build.sh:1.366 Mon Mar 13 11:52:29 2023
+++ src/build.sh Sun Apr 23 02:01:33 2023
@@ -1,5 +1,5 @@
#! /usr/bin/env sh
-# $NetBSD: build.sh,v 1.366 2023/03/13 11:52:29 martin Exp $
+# $NetBSD: build.sh,v 1.367 2023/04/23 02:01:33 uwe Exp $
#
# Copyright (c) 2001-2022 The NetBSD Foundation, Inc.
# All rights reserved.
@@ -2010,7 +2010,7 @@ createmakewrapper()
eval cat <&1 -o /tmp/rumptest.$$ | \
+ -static --whole-archive ${set} --no-whole-archive -lpthread -lc 2>&1 -o /tmp/rumptest.$$ | \
awk -v quirks="${md_quirks}" '
/undefined reference/ &&
!/more undefined references.*follow/{
CVS commit: src
Module Name:src Committed By: uwe Date: Sun Apr 23 02:01:33 UTC 2023 Modified Files: src: build.sh Log Message: build.sh: tweak rumptest and RUMP_LIBSETS Use --no-whole-archive to keep us as honest as currently possible. PR kern/56599 To generate a diff of this commit: cvs rdiff -u -r1.366 -r1.367 src/build.sh Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/share/man/man9
Module Name:src Committed By: uwe Date: Thu Apr 20 10:43:17 UTC 2023 Modified Files: src/share/man/man9: optstr.9 Log Message: optstr(9): markup fixes While here, wrap long .Fn lines for readability and make the optstr_get_item list compact. To generate a diff of this commit: cvs rdiff -u -r1.5 -r1.6 src/share/man/man9/optstr.9 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man9/optstr.9 diff -u src/share/man/man9/optstr.9:1.5 src/share/man/man9/optstr.9:1.6 --- src/share/man/man9/optstr.9:1.5 Thu Apr 20 09:06:02 2023 +++ src/share/man/man9/optstr.9 Thu Apr 20 10:43:17 2023 @@ -1,4 +1,4 @@ -.\" $NetBSD: optstr.9,v 1.5 2023/04/20 09:06:02 skrll Exp $ +.\" $NetBSD: optstr.9,v 1.6 2023/04/20 10:43:17 uwe Exp $ .\" .\" Copyright (c) 2006 The NetBSD Foundation, Inc. .\" All rights reserved. @@ -30,6 +30,7 @@ .Dd May 20, 2023 .Dt OPTSTR 9 .Os +. .Sh NAME .Nm optstr_get , .Nm optstr_get_string , @@ -38,79 +39,110 @@ .Nm optstr_get_number_hex , .Nm optstr_get_macaddr .Nd Options string management +. .Sh SYNOPSIS .In sys/optstr.h +. .Ft bool -.Fn optstr_get "const char *optstr" "const char *key" "char *buf" "size_t bufsize" -.Ft bool -.Fn optstr_get_string "const char *optstr" "const char *key" "char **result" -.Ft bool -.Fn optstr_get_number "const char *optstr" "const char *key" "unsigned long *result" -.Ft bool -.Fn optstr_get_number_binary "const char *optstr" "const char *key" "unsigned long *result" -.Ft bool -.Fn optstr_get_number_hex "const char *optstr" "const char *key" "unsigned long *result" -.Ft bool -.Fn optstr_get_macaddr "const char *optstr" "const char *key" "uint8_t result[ETHER_ADDR_LEN]" +.Fo optstr_get +.Fa "const char *optstr" +.Fa "const char *key" +.Fa "char *buf" +.Fa "size_t bufsize" +.Fc +. +.Ft bool +.Fo optstr_get_string +.Fa "const char *optstr" +.Fa "const char *key" +.Fa "char **result" +.Fc +. +.Ft bool +.Fo optstr_get_number +.Fa "const char *optstr" +.Fa "const char *key" +.Fa "unsigned long *result" +.Fc +. +.Ft bool +.Fo optstr_get_number_binary +.Fa "const char *optstr" +.Fa "const char *key" +.Fa "unsigned long *result" +.Fc +. +.Ft bool +.Fo optstr_get_number_hex +.Fa "const char *optstr" +.Fa "const char *key" +.Fa "unsigned long *result" +.Fc +. +.Ft bool +.Fo optstr_get_macaddr +.Fa "const char *optstr" +.Fa "const char *key" +.Fa "uint8_t result[ETHER_ADDR_LEN]" +.Fc +. .Sh DESCRIPTION An options string is a list of key/value pairs represented in textual form. Each pair is expressed as -.Sq 'key=value' +.Ar key\^ Ns Li = Ns Ar value and is separated from other pairs by one or more spaces. For example: -.Bd -literal -key1=value1 key2=value2 key3=value3 -.Ed +.Pp +.Dl key1=value1 key2=value2 key3=value3 .Pp Options strings are used to pass information between userland programs and the kernel in a binary-agnostic way. This makes them endianness and ABI independent. .Sh FUNCTIONS The following functions are provided to manage options strings: -.Bl -tag -width compact +.Bl -tag -width Fn .It Fn optstr_get "optstr" "key" "buf" "bufsize" Scans the -.Va optstr +.Fa optstr options string looking for the key -.Va key +.Fa key and stores its value in the buffer pointed to by -.Va buf +.Fa buf copying a maximum of -.Va bufsize +.Fa bufsize bytes. Returns -.Sq true +.Ql true if the key was found or -.Sq false +.Ql false otherwise, in which case -.Va buf +.Fa buf is left unmodified. .El .Pp The -.Fn optstr_get_ITEM +.Li optstr_get_ Ns Ar item family of functions provide the ability to scan for the key, and return the value converted to an appropriate type. .Pp -.Bl -tag -width compact +.Bl -tag -width Fn -compact .It Fn optstr_get_string "optstr" "key" "result" .It Fn optstr_get_number "optstr" "key" "result" .It Fn optstr_get_number_binary "optstr" "key" "result" .It Fn optstr_get_number_hex "optstr" "key" "result" .It Fn optstr_get_macaddr "optstr" "key" "result" -.Pp These functions scan the -.Va optstr +.Fa optstr options string looking for the key -.Va key +.Fa key and returns the key value converted as per the function name in -.Va result . +.Fa result . All functions return -.Sq true +.Ql true if the key was found or -.Sq false +.Ql false otherwise, in which case -.Va result +.Fa result is left unmodified. .El .Sh CODE REFERENCES
CVS commit: src/share/man/man9
Module Name:src Committed By: uwe Date: Thu Apr 20 10:43:17 UTC 2023 Modified Files: src/share/man/man9: optstr.9 Log Message: optstr(9): markup fixes While here, wrap long .Fn lines for readability and make the optstr_get_item list compact. To generate a diff of this commit: cvs rdiff -u -r1.5 -r1.6 src/share/man/man9/optstr.9 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/usr.sbin/tprof
Module Name:src Committed By: uwe Date: Mon Apr 17 21:51:40 UTC 2023 Modified Files: src/usr.sbin/tprof: tprof.8 Log Message: tprof(8): fix markup nits To generate a diff of this commit: cvs rdiff -u -r1.28 -r1.29 src/usr.sbin/tprof/tprof.8 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/usr.sbin/tprof
Module Name:src Committed By: uwe Date: Mon Apr 17 21:51:40 UTC 2023 Modified Files: src/usr.sbin/tprof: tprof.8 Log Message: tprof(8): fix markup nits To generate a diff of this commit: cvs rdiff -u -r1.28 -r1.29 src/usr.sbin/tprof/tprof.8 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/usr.sbin/tprof/tprof.8 diff -u src/usr.sbin/tprof/tprof.8:1.28 src/usr.sbin/tprof/tprof.8:1.29 --- src/usr.sbin/tprof/tprof.8:1.28 Mon Apr 17 21:46:12 2023 +++ src/usr.sbin/tprof/tprof.8 Mon Apr 17 21:51:40 2023 @@ -1,4 +1,4 @@ -.\" $NetBSD: tprof.8,v 1.28 2023/04/17 21:46:12 gutteridge Exp $ +.\" $NetBSD: tprof.8,v 1.29 2023/04/17 21:51:40 uwe Exp $ .\" .\" Copyright (c)2011 YAMAMOTO Takashi, .\" All rights reserved. @@ -37,7 +37,9 @@ .Sh DESCRIPTION The .Nm -tool can be used to monitor hardware events (PMCs) during the execution of +tool can be used to monitor hardware events +.Tn ( PMC Ns s ) +during the execution of certain commands. .Pp The @@ -48,11 +50,8 @@ keeps recording samples from the kernel and reports statistics to the standard error. .Pp The -.Nm tprof -pseudo driver and a suitable backend should be loaded beforehand. -See .Xr tprof 4 -for the details. +pseudo driver and a suitable backend should be loaded beforehand. .Pp The .Nm @@ -61,8 +60,10 @@ The first argument, .Ar op , specifies the action to take. Valid actions are: -.Bl -tag -width offline -offset indent -.It list +.Bl -tag -width Cm +. +.It Cm list +. Display the following information: .Bl -bullet -compact .It @@ -70,24 +71,31 @@ a list of performance counter events ava .It the maximum number of counters that can be used simultaneously .It -the default counter for monitor and top command +the default counter for +.Cm monitor +and +.Cm top +commands .El -.It monitor Xo -.Op Fl e Ar name[:option][,scale] +. +.It Cm monitor Xo +.Op Fl e Ar name\| Ns Oo Cm \&: Ns Ar option\^ Oc Ns Oo Cm \&, Ns Ar scale\^ Oc .Op Fl e Ar ... .Op Fl o Ar outfile .Ar command .Xc -Monitor the execution of command +. +Monitor the execution of .Ar command . +The .Ar name -specifies the name of the event to count; it must be taken from the list of +specifies the event to count; it must be taken from the list of available events. .Ar option specifies the source of the event; it must be a combination of -.Ar u +.Cm u (userland) and -.Ar k +.Cm k (kernel). If omitted, it is assumed that both are specified. Multiple @@ -96,7 +104,7 @@ arguments can be specified. If none of the .Fl e arguments are speficied, the CPU's default counter is used. -The collected samples are written into the file +.Pp .Ar scale specifies the ratio of the speed to the cycle counter, or the counter until overflow. @@ -105,38 +113,43 @@ speed of the cycle counter by default, b too large (counter increasing too slowly) to be sufficient for profiling. For example, to specify an event that increases about 1000 times slower than the cycle counter, specify -.Dq Pa -e event,1000 . +.Ql -e event,1000 . Also, if -.Dq Pa -e event,=200 +.Ql -e event,=200 is specified, profiling is performed every time the counter is increased by 200. +.Pp +The collected samples are written into the file .Ar outfile if specified. The default is -.Dq Pa tprof.out . -.It count Xo -.Fl e -.Ar name[:option] +.Pa tprof.out . +. +.It Cm count Xo +.Fl e Ar name\| Ns Op Cm \&: Ns Ar option .Op Fl e Ar ... .Op Fl i Ar interval .Ar command .Xc +. Same as -.Ar monitor , +.Cm monitor , but does not do any profiling, only outputs counters every .Ar interval second. -.It analyze Xo +. +.It Cm analyze Xo .Op Fl CkLPs .Op Fl p Ar pid .Ar file .Xc +. Analyze the samples produced by a previous run of -.Nm tprof , +.Nm , stored in .Ar file , and generate a plain text representation of them. -.Bl -tag -width XPXpidXX -offset indent +.Bl -tag -width Fl .It Fl C Don't distinguish CPUs. All samples are treated as its CPU number is 0. @@ -156,27 +169,28 @@ and ignore the rest. .It Fl s Per symbol. .El -.It top Xo -.Oo -.Fl e -.Ar name[,scale] +. +.It Cm top Xo +.Op Fl acu +.Op Fl e Ar name\| Ns Oo Cm \&, Ns Ar scale\^ Oc .Op Fl e Ar ... -.Oc .Op Fl i Ar interval -.Op Fl acu .Xc +. Displays profiling results in real-time. .Ar name specifies the name of the event to count. -.Bl -tag -width XXintervalX -offset indent -.It Fl i Ar interval -set the update interval in seconds. The default value is 1. +.Bl -tag -width Fl .It Fl a -Starts in accumulation mode. The display is updated every +Starts in accumulation mode. +The display is updated every .Ar interval second, but the values are accumulative. .It Fl c -show the delta of the event counters. +Show the delta of the event counters. +.It Fl i Ar interval +Set the update interval in seconds. +The default value is 1. .It Fl u Userland processes are also included in the profiling. .El @@ -186,23 +200,27 @@
CVS commit: src/usr.bin/systat
Module Name:src Committed By: uwe Date: Wed Mar 29 21:44:35 UTC 2023 Modified Files: src/usr.bin/systat: systat.1 Log Message: systat(1): try to give this page a quick facelift ... too bad what it really needs is reconstructive surgery. I tried to fix the most obvious problems (unsorted lists, obviously wrong markup, pleonastic wording that drowns out useful information in repetition and lifetime supply of quote marks). This page really needs a native speaker to take some loving care of it. To generate a diff of this commit: cvs rdiff -u -r1.53 -r1.54 src/usr.bin/systat/systat.1 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/usr.bin/systat
Module Name:src Committed By: uwe Date: Wed Mar 29 21:44:35 UTC 2023 Modified Files: src/usr.bin/systat: systat.1 Log Message: systat(1): try to give this page a quick facelift ... too bad what it really needs is reconstructive surgery. I tried to fix the most obvious problems (unsorted lists, obviously wrong markup, pleonastic wording that drowns out useful information in repetition and lifetime supply of quote marks). This page really needs a native speaker to take some loving care of it. To generate a diff of this commit: cvs rdiff -u -r1.53 -r1.54 src/usr.bin/systat/systat.1 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/usr.bin/systat/systat.1 diff -u src/usr.bin/systat/systat.1:1.53 src/usr.bin/systat/systat.1:1.54 --- src/usr.bin/systat/systat.1:1.53 Wed Mar 29 19:40:18 2023 +++ src/usr.bin/systat/systat.1 Wed Mar 29 21:44:35 2023 @@ -1,4 +1,4 @@ -.\" $NetBSD: systat.1,v 1.53 2023/03/29 19:40:18 kre Exp $ +.\" $NetBSD: systat.1,v 1.54 2023/03/29 21:44:35 uwe Exp $ .\" .\" Copyright (c) 1985, 1990, 1993 .\" The Regents of the University of California. All rights reserved. @@ -29,7 +29,7 @@ .\" .\" @(#)systat.1 8.2 (Berkeley) 12/30/93 .\" -.Dd August 21, 2021 +.Dd March 29, 2023 .Dt SYSTAT 1 .Os .Sh NAME @@ -43,17 +43,18 @@ .Op Fl t Ar turns .Op Fl w Ar wait .Op Ar display -.Op Ar refresh-interval +.Op Ar wait .Sh DESCRIPTION .Nm displays various system statistics in a screen oriented fashion -using the curses screen display library, -.Xr curses 3 . +using the +.Xr curses 3 +screen display library. .Pp While .Nm -is running the screen is usually divided into two windows (an exception -is the vmstat display which uses the entire screen). +is running the screen is usually divided into two windows +.Pq an exception is the vmstat display which uses the entire screen . The upper window depicts the current system load average. The information displayed in the lower window may vary, depending on user commands. @@ -65,27 +66,27 @@ displays the processes getting the large in the lower window. Other displays show more detailed process information, swap space usage, -disk usage statistics (a la -.Xr df 1 ) , -disk I/O statistics (a la -.Xr iostat 8 ) , -virtual memory statistics (a la -.Xr vmstat 1 ) , -network -.Qq Ic mbufs -utilization, network -.Qq Ic ifstat -traffic, and network connections (a la -.Xr netstat 1 ) . +disk usage statistics +.Pq a\~la Xr df 1 , +disk I/O statistics +.Pq a\~la Xr iostat 8 , +virtual memory statistics +.Pq a\~la Xr vmstat 1 , +network mbuf utilization, +network interface traffic, +and network connections +.Pq a\~la Xr netstat 1 . .Pp Input is interpreted at two different levels. -A ``global'' command interpreter processes all keyboard input. +A global command interpreter processes all keyboard input. If this command interpreter fails to recognize a command, the input line is passed to a per-display command interpreter. This allows each display to have certain display-specific commands. .Pp Command line options: -.Bl -tag -width "refresh_interval" +.Bl -tag -width Fl +.It Fl b +Show the chosen display once and exit. .It Fl M Ar core Extract values associated with the name list from .Ar core @@ -96,22 +97,26 @@ Extract the name list from .Ar system instead of the default .Pa /netbsd . -.It Fl b -Show the chosen display once and exit. .It Fl n Do not resolve IP addresses into string hostnames -.Pq FQDNs -on -.Ic netstat . +.Pf ( Tn FQDN Ns s ) . It has the same effect as .Ic numbers subcommand in .Ic netstat . -.It Fl w Ar wait -See -.Ar refresh-interval . .It Fl t Ar turns -How many refreshes to show each screen in 'all' display mode. +How many refresh cycles to show each screen in +.Sq all +display mode. +The default is 2. +.It Fl w Ar wait +Set the screen refresh interval to +.Ar wait +seconds. +Floating point numbers are accepted. +The default is 1\~second. +.It Fl z +Display 0 instead of space when there is no data. .It Ar display The .Ar display @@ -136,30 +141,23 @@ or .Ic vmstat . These displays can also be requested interactively and are described in full detail below. -.It Ar refresh-interval -The -.Ar refresh-interval -specifies the screen refresh time interval in seconds. -This is provided for backwards compatibility, and overrides the -.Ar refresh-interval -specified with the -.Fl w -flag. -.It Fl z -Display 0 instead of space when there is no data. +.It Ar wait +The same as +.Fl w Ar wait . +This form is provided for backwards compatibility. .El .Pp Certain characters cause immediate action by .Nm . These are -.Bl -tag -width Fl +.Bl -tag -width Ic .It Ic \&^L Refresh the screen. .It Ic \&^G -Print the name of the current ``display'' being shown in +Print the name of the current display being shown in the lower window and the refresh interval. .It Ic \&^Z -Stop +Suspend .Nm . .It
CVS commit: src/share/man/man7
Module Name:src Committed By: uwe Date: Thu Mar 23 12:41:43 UTC 2023 Modified Files: src/share/man/man7: entropy.7 Log Message: entropy(7): don't use .Nx inside .Ss These macros don't adapt to context style, so in PostScript output the .Nx inside .Ss is suddenly in a different font. To generate a diff of this commit: cvs rdiff -u -r1.7 -r1.8 src/share/man/man7/entropy.7 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man7/entropy.7 diff -u src/share/man/man7/entropy.7:1.7 src/share/man/man7/entropy.7:1.8 --- src/share/man/man7/entropy.7:1.7 Thu Mar 23 12:39:11 2023 +++ src/share/man/man7/entropy.7 Thu Mar 23 12:41:43 2023 @@ -1,4 +1,4 @@ -.\" $NetBSD: entropy.7,v 1.7 2023/03/23 12:39:11 uwe Exp $ +.\" $NetBSD: entropy.7,v 1.8 2023/03/23 12:41:43 uwe Exp $ .\" .\" Copyright (c) 2021 The NetBSD Foundation, Inc. .\" All rights reserved. @@ -72,7 +72,7 @@ see cannot be recovered by forensic tools after shutdown. .El .\"" -.Ss Entropy in Nx +.Ss Entropy in NetBSD .Nx gathers samples from various kinds of entropy sources, including: .Bl -bullet -compact
CVS commit: src/share/man/man7
Module Name:src Committed By: uwe Date: Thu Mar 23 12:41:43 UTC 2023 Modified Files: src/share/man/man7: entropy.7 Log Message: entropy(7): don't use .Nx inside .Ss These macros don't adapt to context style, so in PostScript output the .Nx inside .Ss is suddenly in a different font. To generate a diff of this commit: cvs rdiff -u -r1.7 -r1.8 src/share/man/man7/entropy.7 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/share/man/man7
Module Name:src Committed By: uwe Date: Thu Mar 23 12:39:12 UTC 2023 Modified Files: src/share/man/man7: entropy.7 Log Message: entropy(7): use .Ql instead of .Sc Li To generate a diff of this commit: cvs rdiff -u -r1.6 -r1.7 src/share/man/man7/entropy.7 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man7/entropy.7 diff -u src/share/man/man7/entropy.7:1.6 src/share/man/man7/entropy.7:1.7 --- src/share/man/man7/entropy.7:1.6 Thu Mar 23 12:38:17 2023 +++ src/share/man/man7/entropy.7 Thu Mar 23 12:39:11 2023 @@ -1,4 +1,4 @@ -.\" $NetBSD: entropy.7,v 1.6 2023/03/23 12:38:17 uwe Exp $ +.\" $NetBSD: entropy.7,v 1.7 2023/03/23 12:39:11 uwe Exp $ .\" .\" Copyright (c) 2021 The NetBSD Foundation, Inc. .\" All rights reserved. @@ -130,13 +130,13 @@ entropy; see .Xr security.conf 5 . .It The operator can set -.Sq Li entropy=check +.Ql entropy=check in .Xr rc.conf 5 so that .Nx will refuse to boot to multiuser unless there is enough entropy, or set -.Sq Li entropy=wait +.Ql entropy=wait so that .Nx will wait for entropy before booting to multiuser (with the caveat that @@ -212,7 +212,7 @@ After adding entropy, that might be predictable because they were previously generated with too little entropy. For example, if -.Sq Li sshd=YES +.Ql sshd=YES is enabled in .Pa /etc/rc.conf , then
CVS commit: src/share/man/man7
Module Name:src Committed By: uwe Date: Thu Mar 23 12:39:12 UTC 2023 Modified Files: src/share/man/man7: entropy.7 Log Message: entropy(7): use .Ql instead of .Sc Li To generate a diff of this commit: cvs rdiff -u -r1.6 -r1.7 src/share/man/man7/entropy.7 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/share/man/man7
Module Name:src Committed By: uwe Date: Thu Mar 23 12:38:17 UTC 2023 Modified Files: src/share/man/man7: entropy.7 Log Message: entropy(7): don't try to cram things into one-liners To generate a diff of this commit: cvs rdiff -u -r1.5 -r1.6 src/share/man/man7/entropy.7 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/share/man/man7
Module Name:src Committed By: uwe Date: Thu Mar 23 12:38:17 UTC 2023 Modified Files: src/share/man/man7: entropy.7 Log Message: entropy(7): don't try to cram things into one-liners To generate a diff of this commit: cvs rdiff -u -r1.5 -r1.6 src/share/man/man7/entropy.7 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man7/entropy.7 diff -u src/share/man/man7/entropy.7:1.5 src/share/man/man7/entropy.7:1.6 --- src/share/man/man7/entropy.7:1.5 Thu Mar 23 12:22:56 2023 +++ src/share/man/man7/entropy.7 Thu Mar 23 12:38:17 2023 @@ -1,4 +1,4 @@ -.\" $NetBSD: entropy.7,v 1.5 2023/03/23 12:22:56 riastradh Exp $ +.\" $NetBSD: entropy.7,v 1.6 2023/03/23 12:38:17 uwe Exp $ .\" .\" Copyright (c) 2021 The NetBSD Foundation, Inc. .\" All rights reserved. @@ -62,7 +62,13 @@ then they could impersonate you. .Nx relies on unpredictable secrets to make sure that private user data stored on nonvolatile media when memory is scarce -.Pq Xr swapctl 8 , using So Li vm.swap_encrypt=1 Sc ; see Xr sysctl 7 +.Po +.Xr swapctl 8 , +using +.Ql vm.swap_encrypt=1 ; +see +.Xr sysctl 7 +.Pc cannot be recovered by forensic tools after shutdown. .El .\""
CVS commit: src/usr.sbin/mountd
Module Name:src Committed By: uwe Date: Wed Mar 15 20:39:12 UTC 2023 Modified Files: src/usr.sbin/mountd: mountd.8 Log Message: mountd(8): comma before "and" Not a serial comma, technically, as there are only two items, but it makes reading easier, IMHO. To generate a diff of this commit: cvs rdiff -u -r1.41 -r1.42 src/usr.sbin/mountd/mountd.8 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/usr.sbin/mountd/mountd.8 diff -u src/usr.sbin/mountd/mountd.8:1.41 src/usr.sbin/mountd/mountd.8:1.42 --- src/usr.sbin/mountd/mountd.8:1.41 Wed Mar 15 20:33:04 2023 +++ src/usr.sbin/mountd/mountd.8 Wed Mar 15 20:39:12 2023 @@ -1,4 +1,4 @@ -.\" $NetBSD: mountd.8,v 1.41 2023/03/15 20:33:04 uwe Exp $ +.\" $NetBSD: mountd.8,v 1.42 2023/03/15 20:39:12 uwe Exp $ .\" .\" Copyright (c) 1989, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -53,7 +53,7 @@ listens for service requests at the port .Tn NFS server specification; see .%T "Network File System Protocol Specification" , -RFC 1094, Appendix A and +RFC 1094, Appendix A, and .%T "NFS: Network File System Version 3 Protocol Specification" , Appendix I. .Pp
CVS commit: src/usr.sbin/mountd
Module Name:src Committed By: uwe Date: Wed Mar 15 20:39:12 UTC 2023 Modified Files: src/usr.sbin/mountd: mountd.8 Log Message: mountd(8): comma before "and" Not a serial comma, technically, as there are only two items, but it makes reading easier, IMHO. To generate a diff of this commit: cvs rdiff -u -r1.41 -r1.42 src/usr.sbin/mountd/mountd.8 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/usr.sbin/mountd
Module Name:src Committed By: uwe Date: Wed Mar 15 20:33:04 UTC 2023 Modified Files: src/usr.sbin/mountd: mountd.8 Log Message: mountd(8): fix minor markup nits While here, use $() instead of `` in the example. To generate a diff of this commit: cvs rdiff -u -r1.40 -r1.41 src/usr.sbin/mountd/mountd.8 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/usr.sbin/mountd/mountd.8 diff -u src/usr.sbin/mountd/mountd.8:1.40 src/usr.sbin/mountd/mountd.8:1.41 --- src/usr.sbin/mountd/mountd.8:1.40 Tue Feb 16 10:01:55 2021 +++ src/usr.sbin/mountd/mountd.8 Wed Mar 15 20:33:04 2023 @@ -1,4 +1,4 @@ -.\" $NetBSD: mountd.8,v 1.40 2021/02/16 10:01:55 wiz Exp $ +.\" $NetBSD: mountd.8,v 1.41 2023/03/15 20:33:04 uwe Exp $ .\" .\" Copyright (c) 1989, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -59,7 +59,7 @@ Appendix I. .Pp Options and operands available for .Nm mountd : -.Bl -tag -width Ds +.Bl -tag -width Fl .It Fl d Enable debugging mode. .Nm @@ -68,7 +68,7 @@ debugging messages to stderr. .It Fl N Do not require privileged ports for mount or NFS RPC calls. This option is equivalent to specifying -.Dq -noresvport -noresvmnt +.Ql -noresvport -noresvmnt on every export. See .Xr exports 5 @@ -94,13 +94,15 @@ to bind to the given port. If this option is not given, .Nm may bind to every anonymous port -(in the range 600-1023) which causes trouble when trying to use +(in the range 600\^\(en1023) which causes trouble when trying to use NFS through a firewall. .It Ar exportsfile The .Ar exportsfile argument specifies an alternative location -for the exports file. +for the +.Xr exports 5 +file. Multiple exports files can be defined. .El .Pp @@ -115,19 +117,23 @@ After changing the exports file, a hangup signal should be sent to the .Nm daemon to get it to reload the export information. -After sending the SIGHUP -(kill \-s HUP `cat /var/run/mountd.pid`), +After sending the +.Dv SIGHUP +.Pp +.Dl kill \-s HUP $(cat /var/run/mountd.pid) +.Pp check the syslog output to see if .Nm logged any parsing errors in the exports file. .Pp -After receiving SIGTERM, +After receiving +.Dv SIGTERM , .Nm sends a broadcast request to remove the mount list from all the clients. This can take a long time, since the broadcast request waits for each client to respond. .Sh FILES -.Bl -tag -width /var/run/mountd.pid -compact +.Bl -tag -width ".Pa /var/run/mountd.pid" -compact .It Pa /etc/exports the list of exported filesystems .It Pa /var/run/mountd.pid
CVS commit: src/usr.sbin/mountd
Module Name:src Committed By: uwe Date: Wed Mar 15 20:33:04 UTC 2023 Modified Files: src/usr.sbin/mountd: mountd.8 Log Message: mountd(8): fix minor markup nits While here, use $() instead of `` in the example. To generate a diff of this commit: cvs rdiff -u -r1.40 -r1.41 src/usr.sbin/mountd/mountd.8 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/usr.sbin/service
Module Name:src Committed By: uwe Date: Tue Mar 14 21:50:25 UTC 2023 Modified Files: src/usr.sbin/service: service.8 Log Message: service(8): fix markup To generate a diff of this commit: cvs rdiff -u -r1.5 -r1.6 src/usr.sbin/service/service.8 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/usr.sbin/service/service.8 diff -u src/usr.sbin/service/service.8:1.5 src/usr.sbin/service/service.8:1.6 --- src/usr.sbin/service/service.8:1.5 Tue Mar 14 06:19:35 2023 +++ src/usr.sbin/service/service.8 Tue Mar 14 21:50:25 2023 @@ -1,4 +1,4 @@ -.\" $NetBSD: service.8,v 1.5 2023/03/14 06:19:35 kre Exp $ +.\" $NetBSD: service.8,v 1.6 2023/03/14 21:50:25 uwe Exp $ .\" .\" Copyright (c) 2009 Douglas Barton .\" All rights reserved. @@ -46,16 +46,16 @@ command is a simple interface to the ser .Pp Its purpose is to list the services or invoke actions on them as provided by the -.Ev rc.d +.Xr rc.d 8 scripts. When used to invoke -.Ev rc.d +.Pa rc.d scripts, .Nm will set the same environment that is used at boot time. .Pp The options are as follows: -.Bl -tag -width F1 +.Bl -tag -width Fl .It Fl e List services that are enabled. The list of scripts is compiled using @@ -63,7 +63,7 @@ The list of scripts is compiled using the same way as is done in .Xr rc 8 ; each script is first checked for an -.Qq rcvar +.Dv rcvar assignment and if present, checked to see if it is enabled. If one or more @@ -75,21 +75,24 @@ arguments are always specified without a .It Fl l List all files in .Pa /etc/rc.d -(the default of -.Ev rc_directories as defined in -.Xr rc.conf 5 ) . +.Po +the default of +.Ev rc_directories +as defined in +.Xr rc.conf 5 +.Pc . A script will be listed unless it has the -.Qq nostart +.Dv nostart keyword enabled. Scripts are listed in the order the -.EV rc.d +.Pa rc.d system runs them at system boot time. .It Fl v Report what -.Ev rc_directories +.Dv rc_directories are defined or in which directory the -.Ev rc.d script -was found when an +.Pa rc.d +script was found when an .Ar action is invoked. .El @@ -102,29 +105,30 @@ options are mutually exclusive. Only one of those may be used. .Sh ENVIRONMENT When used to invoke -.Ev rc.d scripts, the +.Pa rc.d +scripts, the .Nm command sets -.Ev umask +.Xr umask 2 to -.Fa 022 , +.Li 022 , .Ev HOME to .Pa / , and .Ev PATH to -.Pa /sbin:/bin:/usr/sbin:/usr/bin +.Li /sbin:/bin:/usr/sbin:/usr/bin which is how they are set in .Pa /etc/rc at boot time. The .Ar action is typically one of -.Ar start , -.Ar restart , +.Cm start , +.Cm restart , or -.Ar status , +.Cm status , but can be any other argument supported by the .Fa rc_script_name . .Sh EXIT STATUS @@ -174,11 +178,11 @@ In the last example, was apparently left disabled and the additional directory .Pa /usr/pkg/etc/rc.d was configured by redefining the variable -.Ev rc_directories +.Dv rc_directories in .Pa rc.conf ; further, -.Sy my_pkg=yes +.Li my_pkg=yes must have also been set. .Sh SEE ALSO .Xr rc.conf 5 ,
CVS commit: src/usr.sbin/service
Module Name:src Committed By: uwe Date: Tue Mar 14 21:50:25 UTC 2023 Modified Files: src/usr.sbin/service: service.8 Log Message: service(8): fix markup To generate a diff of this commit: cvs rdiff -u -r1.5 -r1.6 src/usr.sbin/service/service.8 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src
Module Name:src Committed By: uwe Date: Mon Mar 6 00:49:32 UTC 2023 Modified Files: src/distrib/sets/lists/comp: mi src/share/man/man9: Makefile Added Files: src/share/man/man9: portfeatures.9 Log Message: portfeatures(9): the man page for the __HAVE macros The man page itself is a skeleton/template for now. Please add short descriptions and xrefs. If the target man page doesn't yet document relevant __HAVE macros (hi, mutex(9)), please add something there, possibly in a .Sh IMPLEMENTATION NOTES section. To generate a diff of this commit: cvs rdiff -u -r1.2425 -r1.2426 src/distrib/sets/lists/comp/mi cvs rdiff -u -r1.465 -r1.466 src/share/man/man9/Makefile cvs rdiff -u -r0 -r1.1 src/share/man/man9/portfeatures.9 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/distrib/sets/lists/comp/mi diff -u src/distrib/sets/lists/comp/mi:1.2425 src/distrib/sets/lists/comp/mi:1.2426 --- src/distrib/sets/lists/comp/mi:1.2425 Fri Oct 28 05:23:09 2022 +++ src/distrib/sets/lists/comp/mi Mon Mar 6 00:49:31 2023 @@ -1,4 +1,4 @@ -# $NetBSD: mi,v 1.2425 2022/10/28 05:23:09 ozaki-r Exp $ +# $NetBSD: mi,v 1.2426 2023/03/06 00:49:31 uwe Exp $ # # Note: don't delete entries from here - mark them as "obsolete" instead. ./etc/mtree/set.compcomp-sys-root @@ -12350,6 +12350,7 @@ ./usr/share/man/cat9/pool_sethardlimit.0 comp-sys-catman .cat ./usr/share/man/cat9/pool_sethiwat.0 comp-sys-catman .cat ./usr/share/man/cat9/pool_setlowat.0 comp-sys-catman .cat +./usr/share/man/cat9/portfeatures.0 comp-sys-catman .cat ./usr/share/man/cat9/postsig.0 comp-sys-catman .cat ./usr/share/man/cat9/powerhook_disestablish.0 comp-sys-catman .cat ./usr/share/man/cat9/powerhook_establish.0 comp-sys-catman .cat @@ -20581,6 +20582,7 @@ ./usr/share/man/html9/pool_sethardlimit.html comp-sys-htmlman html ./usr/share/man/html9/pool_sethiwat.html comp-sys-htmlman html ./usr/share/man/html9/pool_setlowat.html comp-sys-htmlman html +./usr/share/man/html9/portfeatures.html comp-sys-htmlman html ./usr/share/man/html9/postsig.html comp-sys-htmlman html ./usr/share/man/html9/powerhook_disestablish.html comp-sys-htmlman html ./usr/share/man/html9/powerhook_establish.html comp-sys-htmlman html @@ -28973,6 +28975,7 @@ ./usr/share/man/man9/pool_sethardlimit.9 comp-sys-man .man ./usr/share/man/man9/pool_sethiwat.9 comp-sys-man .man ./usr/share/man/man9/pool_setlowat.9 comp-sys-man .man +./usr/share/man/man9/portfeatures.9 comp-sys-man .man ./usr/share/man/man9/postsig.9 comp-sys-man .man ./usr/share/man/man9/powerhook_disestablish.9 comp-sys-man .man ./usr/share/man/man9/powerhook_establish.9 comp-sys-man .man Index: src/share/man/man9/Makefile diff -u src/share/man/man9/Makefile:1.465 src/share/man/man9/Makefile:1.466 --- src/share/man/man9/Makefile:1.465 Sun Sep 4 21:37:50 2022 +++ src/share/man/man9/Makefile Mon Mar 6 00:49:31 2023 @@ -1,4 +1,4 @@ -# $NetBSD: Makefile,v 1.465 2022/09/04 21:37:50 thorpej Exp $ +# $NetBSD: Makefile,v 1.466 2023/03/06 00:49:31 uwe Exp $ # Makefile for section 9 (kernel function and variable) manual pages. @@ -44,8 +44,8 @@ MAN= accept_filter.9 accf_data.9 accf_ht panic.9 pathbuf.9 pci.9 pci_configure_bus.9 pci_intr.9 \ pci_msi.9 pckbport.9 pcmcia.9 pcq.9 pcu.9 \ percpu.9 pfil.9 physio.9 pktqueue.9 pmap.9 pmatch.9 pmf.9 pool.9 \ - pool_cache.9 powerhook_establish.9 ppsratecheck.9 preempt.9 \ - proc_find.9 pserialize.9 pslist.9 psref.9 putter.9 \ + pool_cache.9 portfeatures.9 powerhook_establish.9 ppsratecheck.9 \ + preempt.9 proc_find.9 pserialize.9 pslist.9 psref.9 putter.9 \ radio.9 ras.9 rasops.9 ratecheck.9 resettodr.9 rnd.9 \ roundup.9 rssadapt.9 rt_timer.9 rwlock.9 RUN_ONCE.9 STACK.9 \ scanc.9 \ Added files: Index: src/share/man/man9/portfeatures.9 diff -u /dev/null src/share/man/man9/portfeatures.9:1.1 --- /dev/null Mon Mar 6 00:49:32 2023 +++ src/share/man/man9/portfeatures.9 Mon Mar 6 00:49:31 2023 @@ -0,0 +1,78 @@ +.\" $NetBSD: portfeatures.9,v 1.1 2023/03/06 00:49:31 uwe Exp $ +.\" +.\" Copyright (c) The NetBSD Foundation, Inc. +.\" All rights reserved. +.\" +.\" 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 ``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.
CVS commit: src
Module Name:src Committed By: uwe Date: Mon Mar 6 00:49:32 UTC 2023 Modified Files: src/distrib/sets/lists/comp: mi src/share/man/man9: Makefile Added Files: src/share/man/man9: portfeatures.9 Log Message: portfeatures(9): the man page for the __HAVE macros The man page itself is a skeleton/template for now. Please add short descriptions and xrefs. If the target man page doesn't yet document relevant __HAVE macros (hi, mutex(9)), please add something there, possibly in a .Sh IMPLEMENTATION NOTES section. To generate a diff of this commit: cvs rdiff -u -r1.2425 -r1.2426 src/distrib/sets/lists/comp/mi cvs rdiff -u -r1.465 -r1.466 src/share/man/man9/Makefile cvs rdiff -u -r0 -r1.1 src/share/man/man9/portfeatures.9 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/lib/libc/sys
Module Name:src Committed By: uwe Date: Wed Mar 1 15:11:28 UTC 2023 Modified Files: src/lib/libc/sys: mmap.2 Log Message: mmap(2): minor markup tweaks To generate a diff of this commit: cvs rdiff -u -r1.55 -r1.56 src/lib/libc/sys/mmap.2 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/lib/libc/sys
Module Name:src Committed By: uwe Date: Wed Mar 1 15:11:28 UTC 2023 Modified Files: src/lib/libc/sys: mmap.2 Log Message: mmap(2): minor markup tweaks To generate a diff of this commit: cvs rdiff -u -r1.55 -r1.56 src/lib/libc/sys/mmap.2 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/lib/libc/sys/mmap.2 diff -u src/lib/libc/sys/mmap.2:1.55 src/lib/libc/sys/mmap.2:1.56 --- src/lib/libc/sys/mmap.2:1.55 Sun Sep 8 17:24:49 2019 +++ src/lib/libc/sys/mmap.2 Wed Mar 1 15:11:28 2023 @@ -1,4 +1,4 @@ -.\" $NetBSD: mmap.2,v 1.55 2019/09/08 17:24:49 sevan Exp $ +.\" $NetBSD: mmap.2,v 1.56 2023/03/01 15:11:28 uwe Exp $ .\" .\" Copyright (c) 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -61,8 +61,10 @@ Any such extension beyond the end of the If .Fa addr is non-zero, it is used as a hint to the system. -(As a convenience to the system, the actual address of the region may differ -from the address supplied.) +.Po +As a convenience to the system, the actual address of the region may differ +from the address supplied. +.Pc If .Fa addr is zero, an address will be selected by the system. @@ -74,7 +76,7 @@ deletes any previous mapping in the allo The protections (region accessibility) are specified in the .Fa prot argument by -.Em OR Ns 'ing +.Em or\^ Ap ing the following values: .Bl -tag -width PROT_WRITEXX -offset indent .It Dv PROT_EXEC @@ -94,7 +96,7 @@ extension, the macro can be used to request additional permissions for later use with .Fn mprotect 2 . For example -.Dv PROT_MPROTECT(PROT_READ) +.Li PROT_MPROTECT(PROT_READ) requests that future .Dv PROT_READ mappings are allowed and can be enabled using @@ -132,15 +134,18 @@ must be specified. Sharing, mapping type and options are specified in the .Fa flags argument by -.Em OR Ns 'ing +.Em or\^ Ap ing the following values: -.Bl -tag -width MAP_HASSEMAPHOREXX -offset indent -.It Dv MAP_ALIGNED(n) +.Bl -tag -width ".Dv MAP_HASSEMAPHORE" -offset indent +.It Dv MAP_ALIGNED Ns Li \&( Ns Ar n Ns Li \&) Request that the allocation be aligned to the given boundary. The parameter .Ar n -should be the base 2 logarithm of the desired alignment (e.g., to -request alignment to 16K, use 14 as the value for n). +should be the base\~2 logarithm of the desired alignment +.Po +e.g., to request alignment to 16K, use 14 as the value for +.Ar n +.Pc . The alignment must be equal to or greater than the platform's page size as returned by .Xr sysconf 3 @@ -205,7 +210,7 @@ Only reserve address space, but do not r resources for this mapping. Access to the address space is not guaranteed and may result in a segmentation violation. -Unimplemented. +.Em Unimplemented . .It Dv MAP_PRIVATE Modifications made by this process are private, however modifications made by other processes using @@ -216,14 +221,14 @@ Only valid for .Xr mremap 2 . .It Dv MAP_RENAME Assign the referenced private pages to the file descriptor provided. -Unimplemented. +.Em Unimplemented . .It Dv MAP_SHARED Modifications are shared. .It Dv MAP_STACK Allocate a memory segment that can be used either for a process or thread stack. This currently has no effect, but its use is reserved for architectures that might require special treatment of that address space. -Unimplemented. +.Em Unimplemented . .It Dv MAP_TRYFIXED Attempt to use the address .Fa addr
CVS commit: src/sys/dev/wscons
Module Name:src
Committed By: uwe
Date: Sun Feb 26 14:00:42 UTC 2023
Modified Files:
src/sys/dev/wscons: wsemul_vt100_subr.c
Log Message:
wsemul_vt100_subr: spell edp->tabs assertion with NULL
To generate a diff of this commit:
cvs rdiff -u -r1.29 -r1.30 src/sys/dev/wscons/wsemul_vt100_subr.c
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/sys/dev/wscons/wsemul_vt100_subr.c
diff -u src/sys/dev/wscons/wsemul_vt100_subr.c:1.29 src/sys/dev/wscons/wsemul_vt100_subr.c:1.30
--- src/sys/dev/wscons/wsemul_vt100_subr.c:1.29 Sun Feb 26 13:57:56 2023
+++ src/sys/dev/wscons/wsemul_vt100_subr.c Sun Feb 26 14:00:42 2023
@@ -1,4 +1,4 @@
-/* $NetBSD: wsemul_vt100_subr.c,v 1.29 2023/02/26 13:57:56 uwe Exp $ */
+/* $NetBSD: wsemul_vt100_subr.c,v 1.30 2023/02/26 14:00:42 uwe Exp $ */
/*
* Copyright (c) 1998
@@ -27,7 +27,7 @@
*/
#include
-__KERNEL_RCSID(0, "$NetBSD: wsemul_vt100_subr.c,v 1.29 2023/02/26 13:57:56 uwe Exp $");
+__KERNEL_RCSID(0, "$NetBSD: wsemul_vt100_subr.c,v 1.30 2023/02/26 14:00:42 uwe Exp $");
#include
#include
@@ -331,7 +331,7 @@ wsemul_vt100_handle_csi(struct vt100base
{
int i, j, ps = 0;
char buf[20];
- KASSERT(edp->tabs != 0);
+ KASSERT(edp->tabs != NULL);
wsdisplay_emulinput(edp->cbcookie, "\033P2$u", 5);
for (i = 0; i < edp->ncols; i++)
if (edp->tabs[i]) {
@@ -483,7 +483,7 @@ wsemul_vt100_handle_csi(struct vt100base
edp->crow = uimin(DEF1_ARG(edp, 0) - 1, edp->nrows - 1);
break;
case 'g': /* TBC */
- KASSERT(edp->tabs != 0);
+ KASSERT(edp->tabs != NULL);
switch (ARG(edp, 0)) {
case 0:
edp->tabs[edp->ccol] = 0;
@@ -766,7 +766,7 @@ wsemul_vt100_handle_dcs(struct vt100base
case 0: /* not handled */
return;
case DCSTYPE_TABRESTORE:
- KASSERT(edp->tabs != 0);
+ KASSERT(edp->tabs != NULL);
KASSERT(edp->ncols <= 1024);
memset(edp->tabs, 0, edp->ncols);
pos = 0;
CVS commit: src/sys/dev/wscons
Module Name:src Committed By: uwe Date: Sun Feb 26 14:00:42 UTC 2023 Modified Files: src/sys/dev/wscons: wsemul_vt100_subr.c Log Message: wsemul_vt100_subr: spell edp->tabs assertion with NULL To generate a diff of this commit: cvs rdiff -u -r1.29 -r1.30 src/sys/dev/wscons/wsemul_vt100_subr.c Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/sys/dev/wscons
Module Name:src Committed By: uwe Date: Sun Feb 26 13:57:56 UTC 2023 Modified Files: src/sys/dev/wscons: wsemul_vt100_subr.c Log Message: wsemul_vt100_subr: don't assert unsigned ncols >= 0 To generate a diff of this commit: cvs rdiff -u -r1.28 -r1.29 src/sys/dev/wscons/wsemul_vt100_subr.c Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/sys/dev/wscons/wsemul_vt100_subr.c diff -u src/sys/dev/wscons/wsemul_vt100_subr.c:1.28 src/sys/dev/wscons/wsemul_vt100_subr.c:1.29 --- src/sys/dev/wscons/wsemul_vt100_subr.c:1.28 Thu Feb 23 02:48:06 2023 +++ src/sys/dev/wscons/wsemul_vt100_subr.c Sun Feb 26 13:57:56 2023 @@ -1,4 +1,4 @@ -/* $NetBSD: wsemul_vt100_subr.c,v 1.28 2023/02/23 02:48:06 riastradh Exp $ */ +/* $NetBSD: wsemul_vt100_subr.c,v 1.29 2023/02/26 13:57:56 uwe Exp $ */ /* * Copyright (c) 1998 @@ -27,7 +27,7 @@ */ #include -__KERNEL_RCSID(0, "$NetBSD: wsemul_vt100_subr.c,v 1.28 2023/02/23 02:48:06 riastradh Exp $"); +__KERNEL_RCSID(0, "$NetBSD: wsemul_vt100_subr.c,v 1.29 2023/02/26 13:57:56 uwe Exp $"); #include #include @@ -767,7 +767,6 @@ wsemul_vt100_handle_dcs(struct vt100base return; case DCSTYPE_TABRESTORE: KASSERT(edp->tabs != 0); - KASSERT(edp->ncols >= 0); KASSERT(edp->ncols <= 1024); memset(edp->tabs, 0, edp->ncols); pos = 0;
CVS commit: src/sys/dev/wscons
Module Name:src Committed By: uwe Date: Sun Feb 26 13:57:56 UTC 2023 Modified Files: src/sys/dev/wscons: wsemul_vt100_subr.c Log Message: wsemul_vt100_subr: don't assert unsigned ncols >= 0 To generate a diff of this commit: cvs rdiff -u -r1.28 -r1.29 src/sys/dev/wscons/wsemul_vt100_subr.c Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/usr.bin/ftp
Module Name:src Committed By: uwe Date: Sat Feb 25 17:37:09 UTC 2023 Modified Files: src/usr.bin/ftp: ftp.1 Log Message: ftp(1): better mark up for url vs cd example To generate a diff of this commit: cvs rdiff -u -r1.149 -r1.150 src/usr.bin/ftp/ftp.1 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/usr.bin/ftp
Module Name:src Committed By: uwe Date: Sat Feb 25 17:37:09 UTC 2023 Modified Files: src/usr.bin/ftp: ftp.1 Log Message: ftp(1): better mark up for url vs cd example To generate a diff of this commit: cvs rdiff -u -r1.149 -r1.150 src/usr.bin/ftp/ftp.1 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/usr.bin/ftp/ftp.1 diff -u src/usr.bin/ftp/ftp.1:1.149 src/usr.bin/ftp/ftp.1:1.150 --- src/usr.bin/ftp/ftp.1:1.149 Sat Feb 25 13:51:48 2023 +++ src/usr.bin/ftp/ftp.1 Sat Feb 25 17:37:09 2023 @@ -1,4 +1,4 @@ -.\" $NetBSD: ftp.1,v 1.149 2023/02/25 13:51:48 uwe Exp $ +.\" $NetBSD: ftp.1,v 1.150 2023/02/25 17:37:09 uwe Exp $ .\" .\" Copyright (c) 1996-2023 The NetBSD Foundation, Inc. .\" All rights reserved. @@ -1792,24 +1792,38 @@ and where to use For example, the following URLs correspond to the equivalents of the indicated commands: .Bl -tag -width "ftp://host/%2Fdir1%2Fdir2%2Ffile; -.It ftp://host/dir1/dir2/file -.Dq "cd dir1" , -.Dq "cd dir2" , -.Dq "get file" . -.It ftp://host/%2Fdir1/dir2/file -.Dq "cd /dir1" , -.Dq "cd dir2" , -.Dq "get file" . -.It ftp://host/dir1%2Fdir2/file -.Dq "cd dir1/dir2" , -.Dq "get file" . -.It ftp://host/%2Fdir1%2Fdir2/file -.Dq "cd /dir1/dir2" , -.Dq "get file" . -.It ftp://host/dir1%2Fdir2%2Ffile -.Dq "get dir1/dir2/file" . -.It ftp://host/%2Fdir1%2Fdir2%2Ffile -.Dq "get /dir1/dir2/file" . +.It Xo \" ftp://host/dir1/dir2/file +.Sm off +.Ic ftp:// Ar host +.Ic / Ar dir1 +.Ic / Ar dir2 +.Ic / Ar file +.Sm on +.Xc +.Ic cd Ar dir1 , +.Ic cd Ar dir2 , +.Ic get Ar file . +.It Xo \" ftp://host/%2Fdir1/dir2/file +.Sm off +.Ic ftp:// Ar host +.Ic /%2F Ar dir1 +.Ic / Ar dir2 +.Ic / Ar file +.Sm on +.Xc +.Ic cd / Ns Ar dir1 , +.Ic cd Ar dir2 , +.Ic get Ar file . +.It Xo \" ftp://host/dir1%2Fdir2/file +.Sm off +.Ic ftp:// Ar host +.Ic / Ar dir1 +.Ic %2F Ar dir2 +.Ic / Ar file +.Sm on +.Xc +.Ic cd Ar dir1 Ns Ic / Ns Ar dir2 , +.Ic get Ar file . .El .It You must have appropriate access permission for each of the
CVS commit: src/usr.bin/ftp
Module Name:src Committed By: uwe Date: Sat Feb 25 13:51:48 UTC 2023 Modified Files: src/usr.bin/ftp: ftp.1 Log Message: ftp(1): minor markup tweaks Use .Ql instead of .Sq Li, add some missing ones. Use .Pq instead of explicit () for longer phrases - these are easier to read in the postscript output b/c of extra spacing. To generate a diff of this commit: cvs rdiff -u -r1.148 -r1.149 src/usr.bin/ftp/ftp.1 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/usr.bin/ftp/ftp.1 diff -u src/usr.bin/ftp/ftp.1:1.148 src/usr.bin/ftp/ftp.1:1.149 --- src/usr.bin/ftp/ftp.1:1.148 Sat Feb 25 12:07:25 2023 +++ src/usr.bin/ftp/ftp.1 Sat Feb 25 13:51:48 2023 @@ -1,4 +1,4 @@ -.\" $NetBSD: ftp.1,v 1.148 2023/02/25 12:07:25 mlelstv Exp $ +.\" $NetBSD: ftp.1,v 1.149 2023/02/25 13:51:48 uwe Exp $ .\" .\" Copyright (c) 1996-2023 The NetBSD Foundation, Inc. .\" All rights reserved. @@ -77,9 +77,9 @@ .Oo .Fl T Xo .Sm off -.Ar dir , +.Ar dir Cm \&, .Ar max -.Op , Ar inc +.Op Cm \&, Ar inc .Sm on .Xc .Oc @@ -239,11 +239,14 @@ will check the an account on the remote machine. If no entry exists, .Nm -will prompt for the remote machine login name (default is the user -identity on the local machine), and, if necessary, prompt for a password +will prompt for the remote machine login name +.Pq default is the user identity on the local machine , +and, if necessary, prompt for a password and an account with which to login. To override the auto-login for auto-fetch transfers, specify the -username (and optionally, password) as appropriate. +username +.Pq and optionally, password +as appropriate. .It Fl o Ar output When auto-fetching files, save the contents in .Ar output . @@ -254,9 +257,9 @@ below. If .Ar output is not -.Sq - +.Sq Fl or doesn't start with -.Sq \&| , +.Sq Cm \&| , then only the first file specified will be retrieved into .Ar output ; all other files will be retrieved into the basename of their @@ -286,7 +289,7 @@ Uses as the local IP address for all connections. .It Fl t Enables packet tracing. -.It Fl T Ar direction Ns , Ns Ar maximum Ns Oo , Ns Ar increment Oc +.It Fl T Ar direction Ns Cm \&, Ns Ar maximum\| Ns Oo Cm \&, Ns Ar increment Oc Set the maximum transfer rate for .Ar direction to @@ -304,9 +307,10 @@ Upload files on the command line to where .Ar url is one of the -.Sq Li ftp:// +.Ql ftp:// URL types as supported by auto-fetch -(with an optional target filename for single file uploads), and +.Pq with an optional target filename for single file uploads , +and .Ar file is one or more local files to be uploaded. .It Fl V @@ -320,10 +324,13 @@ Enable .Ic verbose and .Ic progress . -This is the default if output is to a terminal (and in the case of +This is the default if output is to a terminal +.Po +and in the case of .Ic progress , .Nm -is the foreground process). +is the foreground process +.Pc . Forces .Nm to show all responses from the remote server, as well @@ -334,7 +341,7 @@ Set the size of the socket send and rece Refer to .Ic xferbuf for more information. -.It Fl ? +.It Fl \&? Display help to stdout, and exit. .El .Pp @@ -356,7 +363,7 @@ is awaiting commands from the user the p is provided to the user. The following commands are recognized by -.Nm ftp : +.Nm : .Bl -tag -width Ic .It Ic \&! Op Ar command Op Ar args Invoke an interactive shell on the local machine. @@ -454,7 +461,7 @@ sequence to conform with the single linefeed record delimiter. Records on -.Pf non\- Ns Ux +.Pf non\- Ux remote systems may contain single linefeeds; when an ascii type transfer is made, these linefeeds may be distinguished from a record delimiter only when @@ -527,9 +534,8 @@ is executed again. A synonym for .Ic bye . .It Ic features -Display what features the remote server supports (using the -.Dv FEAT -command). +Display what features the remote server supports +.Pq using the Dv FEAT No command . .It Ic fget Ar localfile Retrieve the files listed in .Ar localfile , @@ -541,7 +547,7 @@ to .Ar format . The default (and only supported) format is -.Dq non-print . +.Ql non-print . .It Ic ftp Ar host Op Ar port A synonym for .Ic open . @@ -551,9 +557,11 @@ TIS FWTK and Gauntlet .Tn FTP proxies. This will not be permitted if the gate-ftp server hasn't been set -(either explicitly by the user, or from the +.Po +either explicitly by the user, or from the .Ev FTPSERVER -environment variable). +environment variable +.Pc . If .Ar host is given, @@ -625,7 +633,7 @@ transferring a archive of the subtree (in binary mode). .It Ic hash Op Ar size Toggle hash-sign -.Pq Sq # +.Pq Ql # printing for each data block transferred. The size of a data block defaults to 1024 bytes. This can be changed by specifying @@ -675,16 +683,24 @@ A synonym for Define a macro. Subsequent lines are stored as the macro .Ar macro-name ; -a null line
CVS commit: src/usr.bin/ftp
Module Name:src Committed By: uwe Date: Sat Feb 25 13:51:48 UTC 2023 Modified Files: src/usr.bin/ftp: ftp.1 Log Message: ftp(1): minor markup tweaks Use .Ql instead of .Sq Li, add some missing ones. Use .Pq instead of explicit () for longer phrases - these are easier to read in the postscript output b/c of extra spacing. To generate a diff of this commit: cvs rdiff -u -r1.148 -r1.149 src/usr.bin/ftp/ftp.1 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/bin/sleep
Module Name:src
Committed By: uwe
Date: Sun Feb 19 10:54:35 UTC 2023
Modified Files:
src/bin/sleep: sleep.1
Log Message:
sleep(1): minor markup tweaks
To generate a diff of this commit:
cvs rdiff -u -r1.27 -r1.28 src/bin/sleep/sleep.1
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/bin/sleep/sleep.1
diff -u src/bin/sleep/sleep.1:1.27 src/bin/sleep/sleep.1:1.28
--- src/bin/sleep/sleep.1:1.27 Sun Jan 27 17:42:53 2019
+++ src/bin/sleep/sleep.1 Sun Feb 19 10:54:35 2023
@@ -1,4 +1,4 @@
-.\" $NetBSD: sleep.1,v 1.27 2019/01/27 17:42:53 wiz Exp $
+.\" $NetBSD: sleep.1,v 1.28 2023/02/19 10:54:35 uwe Exp $
.\"
.\" Copyright (c) 1990, 1993, 1994
.\" The Regents of the University of California. All rights reserved.
@@ -47,19 +47,24 @@ The
utility suspends execution for a minimum of
.Ar seconds
seconds, then exits.
-It is usually used to schedule the execution of other commands (see
+It is usually used to schedule the execution of other commands
+.Po
+see
.Sx EXAMPLES
-below).
+below
+.Pc .
.Pp
-Note: The
+.Em Note :
+The
.Nx
.Nm
command will accept and honor a non-integer number of specified seconds.
Note however, that if the request is for much more than 2.5 hours,
any fractional seconds will be ignored.
-Permitting non-integral delays is a non-portable extension,
-and its use will decrease the probability that
-a shell script will execute properly on another system.
+Permitting non-integral delays is a
+.Em non-portable
+extension, and its use will decrease the probability that a shell
+script will execute properly on another system.
.Pp
When the
.Dv SIGINFO
@@ -74,7 +79,7 @@ utility exits with one of the following
On successful completion, or if the signal
.Dv SIGALRM
was received.
-.It Li \&>\&0
+.It Li \&>0
An error occurred.
.El
.Sh EXAMPLES
@@ -84,10 +89,12 @@ To schedule the execution of a command f
.Pp
This incantation would wait half an hour before
running the script
-.Dq command_file .
-(See the
+.Ar command_file .
+.Po
+See the
.Xr at 1
-utility.)
+utility
+.Pc .
.Pp
To repeatedly run a command (using
.Xr csh 1 ) :
@@ -110,17 +117,27 @@ The scenario for a script such as this m
running is taking longer than expected to process a series of
files, and it would be nice to have
another program start processing the files created by the first
-program as soon as it is finished (when zzz.rawdata is created).
-The script checks every five minutes for the file zzz.rawdata.
-When the file is found, processing the generated files (*.rawdata)
+program as soon as it is finished
+.Po
+when
+.Li zzz.rawdata
+is created
+.Pc .
+The script checks every five minutes for the file
+.Li zzz.rawdata .
+When the file is found, processing the generated files
+.Pq Li *.rawdata
is done courteously by sleeping for 70 seconds in between each
awk job.
.Pp
To wait until a particular time, the following,
-with some error checking added, might be used (using
+with some error checking added, might be used
+.Po
+using
.Xr sh 1
on
-.Nx ) :
+.Nx
+.Pc :
.Bd -literal -offset indent
END=$(( $( date -d "$1" +%s ) - START_TIME ))
while [ "${SECONDS}" -lt "${END}" ]
@@ -130,7 +147,7 @@ done
.Ed
.Pp
where the argument
-.Sq \&$1
+.Ql $1
specifies the desired date and time in any format the
.Fl d
option to the
@@ -155,11 +172,11 @@ A
utility appeared in
.At v4 .
Processing fractional seconds, and processing the
-.Ic seconds
+.Ar seconds
argument respecting the current locale, was added in
.Nx 1.3 .
The ability to sleep for extended periods appeared in
-.Nx 9 .
+.Nx 9.0 .
.Sh BUGS
This
.Nm
CVS commit: src/bin/sleep
Module Name:src Committed By: uwe Date: Sun Feb 19 10:54:35 UTC 2023 Modified Files: src/bin/sleep: sleep.1 Log Message: sleep(1): minor markup tweaks To generate a diff of this commit: cvs rdiff -u -r1.27 -r1.28 src/bin/sleep/sleep.1 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/sbin/shutdown
Module Name:src Committed By: uwe Date: Wed Feb 15 13:05:21 UTC 2023 Modified Files: src/sbin/shutdown: shutdown.8 Log Message: shutdown(8): markup fixes To generate a diff of this commit: cvs rdiff -u -r1.37 -r1.38 src/sbin/shutdown/shutdown.8 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/sbin/shutdown/shutdown.8 diff -u src/sbin/shutdown/shutdown.8:1.37 src/sbin/shutdown/shutdown.8:1.38 --- src/sbin/shutdown/shutdown.8:1.37 Wed Feb 15 10:31:52 2023 +++ src/sbin/shutdown/shutdown.8 Wed Feb 15 13:05:21 2023 @@ -1,4 +1,4 @@ -.\" $NetBSD: shutdown.8,v 1.37 2023/02/15 10:31:52 uwe Exp $ +.\" $NetBSD: shutdown.8,v 1.38 2023/02/15 13:05:21 uwe Exp $ .\" .\" Copyright (c) 1988, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -40,7 +40,7 @@ .Op Fl Ddfhknprvxz .Op Fl b Ar bootstr .Ar time -.Op Ar message ... | Ar - +.Op Ar message ... No | Fl .Sh DESCRIPTION .Nm provides an automated shutdown procedure for super-users @@ -69,7 +69,7 @@ or to request a kernel core dump. If neither the .Fl h -or +nor .Fl r flags are specified, then .Fl d @@ -80,8 +80,8 @@ also implies arranges, in the manner of .Xr fastboot 8 , for the file systems -.Em not to be -checked on reboot. +.Em not to be checked +on reboot. .It Fl h The system is halted at the specified .Ar time , @@ -135,19 +135,19 @@ or Prevents .Nm from detaching from the tty with -.Xr fork 2 Ns / -.Xr exit 3 . +.Xr fork 2 No / Xr exit 3 . .It Ar time -.Ar Time -is the time at which +The time at which .Nm will bring the system down and may be the word -.Ar now +.Cm now or a future time in one of two formats: -.Ar +number , +.Cm + Ns Ar number , or -.Ar [cc]yy]mm]dd]hh]mm , +.Sm off +.Oo Oo Oo Oo Oo Ar cc Oc Ar yy Oc Ar mm Oc Ar dd Oc Ar hh Oc Ar mm , +.Sm on where the century, year, month, day, and hour are two digit decimal values, which may be defaulted to the current system values. @@ -158,20 +158,24 @@ The first form brings the system down minutes from the current time; the second brings the system down at the absolute time specified. If the century is not specified, but the year is, -the century defaults to 2000 (cc==20, the 21st century) +the century defaults to 2000 +.Po +.Ar cc No = 20 , +the 21st century +.Pc for years between 20 and 99, or 2100 for years between 0 and 19. A leading zero in the -.Dq yy +.Ar yy value (as with all the others) is .Em not optional. .It Ar message ... Any other arguments comprise the warning message that is broadcast to users currently logged into the system. -.It Ar - +.It Fl If -.Ar - +.Fl is supplied as the only argument after the time, the warning message is read from the standard input. .El @@ -214,13 +218,13 @@ and should be used to tell the users why going down, when it will be back up, and to share any other pertinent information. .Sh FILES -.Bl -tag -width /etc/rc.shutdown -compact +.Bl -tag -width Pa -compact .It Pa /etc/nologin -tells +Tells .Xr login 1 not to let anyone log in .It Pa /fastboot -tells +Tells .Xr rc 8 not to run .Xr fsck 8 @@ -239,7 +243,9 @@ System shutdown commands .Xr rescue 8 .Sh BACKWARD COMPATIBILITY The hours and minutes in the second time format may be separated by -a colon (``:'') for backward compatibility. +a colon +.Pq Ql \&: +for backward compatibility. .Sh HISTORY A .Nm
CVS commit: src/sbin/shutdown
Module Name:src Committed By: uwe Date: Wed Feb 15 13:05:21 UTC 2023 Modified Files: src/sbin/shutdown: shutdown.8 Log Message: shutdown(8): markup fixes To generate a diff of this commit: cvs rdiff -u -r1.37 -r1.38 src/sbin/shutdown/shutdown.8 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/sbin/shutdown
Module Name:src Committed By: uwe Date: Wed Feb 15 10:31:52 UTC 2023 Modified Files: src/sbin/shutdown: shutdown.8 Log Message: shutdown(8): fix -width cargo cult To generate a diff of this commit: cvs rdiff -u -r1.36 -r1.37 src/sbin/shutdown/shutdown.8 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/sbin/shutdown/shutdown.8 diff -u src/sbin/shutdown/shutdown.8:1.36 src/sbin/shutdown/shutdown.8:1.37 --- src/sbin/shutdown/shutdown.8:1.36 Wed Feb 15 01:55:16 2023 +++ src/sbin/shutdown/shutdown.8 Wed Feb 15 10:31:52 2023 @@ -1,4 +1,4 @@ -.\" $NetBSD: shutdown.8,v 1.36 2023/02/15 01:55:16 jschauma Exp $ +.\" $NetBSD: shutdown.8,v 1.37 2023/02/15 10:31:52 uwe Exp $ .\" .\" Copyright (c) 1988, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -49,7 +49,7 @@ saving them from system administrators, would otherwise not bother with such niceties. .Pp Available friendlinesses: -.Bl -tag -width b_bootstr_ +.Bl -tag -width Fl .It Fl b Ar bootstr The given .Ar bootstr
CVS commit: src/sbin/shutdown
Module Name:src Committed By: uwe Date: Wed Feb 15 10:31:52 UTC 2023 Modified Files: src/sbin/shutdown: shutdown.8 Log Message: shutdown(8): fix -width cargo cult To generate a diff of this commit: cvs rdiff -u -r1.36 -r1.37 src/sbin/shutdown/shutdown.8 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/usr.bin/audio/play
Module Name:src Committed By: uwe Date: Mon Feb 13 13:35:45 UTC 2023 Modified Files: src/usr.bin/audio/play: audioplay.1 Log Message: audioplay(1): fix typo >From Jim Spath in PR/57228 To generate a diff of this commit: cvs rdiff -u -r1.30 -r1.31 src/usr.bin/audio/play/audioplay.1 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/usr.bin/audio/play/audioplay.1 diff -u src/usr.bin/audio/play/audioplay.1:1.30 src/usr.bin/audio/play/audioplay.1:1.31 --- src/usr.bin/audio/play/audioplay.1:1.30 Fri Apr 10 21:33:27 2020 +++ src/usr.bin/audio/play/audioplay.1 Mon Feb 13 13:35:45 2023 @@ -1,4 +1,4 @@ -.\" $NetBSD: audioplay.1,v 1.30 2020/04/10 21:33:27 gutteridge Exp $ +.\" $NetBSD: audioplay.1,v 1.31 2023/02/13 13:35:45 uwe Exp $ .\" .\" Copyright (c) 1998, 1999, 2002, 2010, 2019 Matthew R. Green .\" All rights reserved. @@ -181,7 +181,7 @@ In this case converts the floating point data into signed linear samples before they are passed to the chosen audio device. .Sh ERRORS -If the audio device or the control device can not be opened, and error is +If the audio device or the control device can not be opened, an error is returned. .Pp If an invalid parameter is specified, an error is returned.
CVS commit: src/usr.bin/audio/play
Module Name:src Committed By: uwe Date: Mon Feb 13 13:35:45 UTC 2023 Modified Files: src/usr.bin/audio/play: audioplay.1 Log Message: audioplay(1): fix typo >From Jim Spath in PR/57228 To generate a diff of this commit: cvs rdiff -u -r1.30 -r1.31 src/usr.bin/audio/play/audioplay.1 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src
Module Name:src Committed By: uwe Date: Sun Feb 12 22:48:02 UTC 2023 Modified Files: src/share/man/man5: services.5 src/usr.sbin/services_mkdb: services_mkdb.8 Log Message: services(5): consistently refer to the cdb database While here, fix a few markup nits. To generate a diff of this commit: cvs rdiff -u -r1.10 -r1.11 src/share/man/man5/services.5 cvs rdiff -u -r1.12 -r1.13 src/usr.sbin/services_mkdb/services_mkdb.8 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man5/services.5 diff -u src/share/man/man5/services.5:1.10 src/share/man/man5/services.5:1.11 --- src/share/man/man5/services.5:1.10 Wed May 13 12:58:34 2009 +++ src/share/man/man5/services.5 Sun Feb 12 22:48:02 2023 @@ -1,4 +1,4 @@ -.\" $NetBSD: services.5,v 1.10 2009/05/13 12:58:34 wiz Exp $ +.\" $NetBSD: services.5,v 1.11 2023/02/12 22:48:02 uwe Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -29,7 +29,7 @@ .\" .\" @(#)services.5 8.1 (Berkeley) 6/5/93 .\" -.Dd June 19, 2007 +.Dd February 12, 2023 .Dt SERVICES 5 .Os .Sh NAME @@ -56,11 +56,11 @@ tab characters. The port number and protocol name are considered a single .Em item ; a slash -.Pq Dq / -is used to separate the port and protocol (e.g. -.Dq 512/tcp ) . +.Pq Ql / +is used to separate the port and protocol +.Pq e.g. Ql 512/tcp . A hash -.Pq Dq
CVS commit: src
Module Name:src Committed By: uwe Date: Sun Feb 12 22:48:02 UTC 2023 Modified Files: src/share/man/man5: services.5 src/usr.sbin/services_mkdb: services_mkdb.8 Log Message: services(5): consistently refer to the cdb database While here, fix a few markup nits. To generate a diff of this commit: cvs rdiff -u -r1.10 -r1.11 src/share/man/man5/services.5 cvs rdiff -u -r1.12 -r1.13 src/usr.sbin/services_mkdb/services_mkdb.8 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/share/man/man4
Module Name:src Committed By: uwe Date: Sat Feb 11 18:03:25 UTC 2023 Modified Files: src/share/man/man4: bpf.4 Log Message: bpf(4): fix couple more nits To generate a diff of this commit: cvs rdiff -u -r1.72 -r1.73 src/share/man/man4/bpf.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/share/man/man4
Module Name:src Committed By: uwe Date: Sat Feb 11 18:03:25 UTC 2023 Modified Files: src/share/man/man4: bpf.4 Log Message: bpf(4): fix couple more nits To generate a diff of this commit: cvs rdiff -u -r1.72 -r1.73 src/share/man/man4/bpf.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man4/bpf.4 diff -u src/share/man/man4/bpf.4:1.72 src/share/man/man4/bpf.4:1.73 --- src/share/man/man4/bpf.4:1.72 Sat Feb 11 12:44:49 2023 +++ src/share/man/man4/bpf.4 Sat Feb 11 18:03:25 2023 @@ -1,6 +1,6 @@ .\" -*- nroff -*- .\" -.\" $NetBSD: bpf.4,v 1.72 2023/02/11 12:44:49 uwe Exp $ +.\" $NetBSD: bpf.4,v 1.73 2023/02/11 18:03:25 uwe Exp $ .\" .\" Copyright (c) 1990, 1991, 1992, 1993, 1994 .\" The Regents of the University of California. All rights reserved. @@ -717,12 +717,13 @@ that copy the index register to the accu .It Sy BPF_MISC + BPF_TXA Ta A \[<-] X .El .Pp -Also, two instructions to call a "coprocessor" if initialized by the kernel -component. +Also, two instructions to call a +.Dq Em coprocessor +if initialized by the kernel component. There is no coprocessor by default. .Bl -column "\*[max-insn]" -offset indent -.It Sy BPF_MISC + BPF_COP Ta A \[<-] funcs[k](..) -.It Sy BPF_MISC + BPF_COPX Ta A \[<-] funcs[X](..) +.It Sy BPF_MISC + BPF_COP Ta A \[<-] funcs[k](...) +.It Sy BPF_MISC + BPF_COPX Ta A \[<-] funcs[X](...) .El .Pp If the coprocessor is not set or the function index is out of range, these
CVS commit: src/share/man/man4
Module Name:src Committed By: uwe Date: Sat Feb 11 12:44:49 UTC 2023 Modified Files: src/share/man/man4: bpf.4 Log Message: bpf(4): fix couple of overlooked markup nits To generate a diff of this commit: cvs rdiff -u -r1.71 -r1.72 src/share/man/man4/bpf.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/share/man/man4
Module Name:src Committed By: uwe Date: Sat Feb 11 12:44:49 UTC 2023 Modified Files: src/share/man/man4: bpf.4 Log Message: bpf(4): fix couple of overlooked markup nits To generate a diff of this commit: cvs rdiff -u -r1.71 -r1.72 src/share/man/man4/bpf.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man4/bpf.4 diff -u src/share/man/man4/bpf.4:1.71 src/share/man/man4/bpf.4:1.72 --- src/share/man/man4/bpf.4:1.71 Sat Feb 11 12:39:44 2023 +++ src/share/man/man4/bpf.4 Sat Feb 11 12:44:49 2023 @@ -1,6 +1,6 @@ .\" -*- nroff -*- .\" -.\" $NetBSD: bpf.4,v 1.71 2023/02/11 12:39:44 uwe Exp $ +.\" $NetBSD: bpf.4,v 1.72 2023/02/11 12:44:49 uwe Exp $ .\" .\" Copyright (c) 1990, 1991, 1992, 1993, 1994 .\" The Regents of the University of California. All rights reserved. @@ -600,7 +600,9 @@ or byte .Sy ( BPF_B ) . Arithmetic overflow when calculating a variable offset terminates the filter program and the packet is ignored. -The semantics of all the recognized BPF_LD instructions follow. +The semantics of all the recognized +.Sy BPF_LD +instructions follow. .\" to make all instruction tables align nicely, use common max width .ds max-insn .Sy BPF_LDX + BPF_W + BPF_WWW .\" @@ -677,7 +679,7 @@ Jump offsets are encoded in 8 bits so th However, the jump always .Sy ( BPF_JA ) opcode uses the 32 bit -.Va k +.Fa k field as the offset, allowing arbitrarily distant destinations. All conditionals use unsigned comparison conventions. .Bl -column "\*[max-insn]" -offset indent
CVS commit: src/share/man/man4
Module Name:src Committed By: uwe Date: Sat Feb 11 12:39:44 UTC 2023 Modified Files: src/share/man/man4: bpf.4 Log Message: bpf(4): spaces around + in instruction tables Makes them easier on the eyes. To generate a diff of this commit: cvs rdiff -u -r1.70 -r1.71 src/share/man/man4/bpf.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man4/bpf.4 diff -u src/share/man/man4/bpf.4:1.70 src/share/man/man4/bpf.4:1.71 --- src/share/man/man4/bpf.4:1.70 Sat Feb 11 11:49:02 2023 +++ src/share/man/man4/bpf.4 Sat Feb 11 12:39:44 2023 @@ -1,6 +1,6 @@ .\" -*- nroff -*- .\" -.\" $NetBSD: bpf.4,v 1.70 2023/02/11 11:49:02 uwe Exp $ +.\" $NetBSD: bpf.4,v 1.71 2023/02/11 12:39:44 uwe Exp $ .\" .\" Copyright (c) 1990, 1991, 1992, 1993, 1994 .\" The Regents of the University of California. All rights reserved. @@ -602,18 +602,18 @@ Arithmetic overflow when calculating a v the filter program and the packet is ignored. The semantics of all the recognized BPF_LD instructions follow. .\" to make all instruction tables align nicely, use common max width -.ds max-insn .Sy BPF_LDX+BPF_W+BPF_WWW +.ds max-insn .Sy BPF_LDX + BPF_W + BPF_WWW .\" .Bl -column "\*[max-insn]" -offset indent -.It Sy BPF_LD+BPF_W+BPF_ABS Ta A \[<-] P[k:4] -.It Sy BPF_LD+BPF_H+BPF_ABS Ta A \[<-] P[k:2] -.It Sy BPF_LD+BPF_B+BPF_ABS Ta A \[<-] P[k:1] -.It Sy BPF_LD+BPF_W+BPF_IND Ta A \[<-] P[X+k:4] -.It Sy BPF_LD+BPF_H+BPF_IND Ta A \[<-] P[X+k:2] -.It Sy BPF_LD+BPF_B+BPF_IND Ta A \[<-] P[X+k:1] -.It Sy BPF_LD+BPF_W+BPF_LEN Ta A \[<-] len -.It Sy BPF_LD+BPF_IMM Ta A \[<-] k -.It Sy BPF_LD+BPF_MEM Ta A \[<-] M[k] +.It Sy BPF_LD + BPF_W + BPF_ABS Ta A \[<-] P[k:4] +.It Sy BPF_LD + BPF_H + BPF_ABS Ta A \[<-] P[k:2] +.It Sy BPF_LD + BPF_B + BPF_ABS Ta A \[<-] P[k:1] +.It Sy BPF_LD + BPF_W + BPF_IND Ta A \[<-] P[X+k:4] +.It Sy BPF_LD + BPF_H + BPF_IND Ta A \[<-] P[X+k:2] +.It Sy BPF_LD + BPF_B + BPF_IND Ta A \[<-] P[X+k:1] +.It Sy BPF_LD + BPF_W + BPF_LEN Ta A \[<-] len +.It Sy BPF_LD + BPF_IMM Ta A \[<-] k +.It Sy BPF_LD + BPF_MEM Ta A \[<-] M[k] .El .It Sy BPF_LDX These instructions load a value into the index register. @@ -622,10 +622,10 @@ the accumulator loads, but they include .Sy BPF_MSH , a hack for efficiently loading the IP header length. .Bl -column "\*[max-insn]" -offset indent -.It Sy BPF_LDX+BPF_W+BPF_IMM Ta X \[<-] k -.It Sy BPF_LDX+BPF_W+BPF_MEM Ta X \[<-] M[k] -.It Sy BPF_LDX+BPF_W+BPF_LEN Ta X \[<-] len -.It Sy BPF_LDX+BPF_B+BPF_MSH Ta X \[<-] 4*(P[k:1]&0xf) +.It Sy BPF_LDX + BPF_W + BPF_IMM Ta X \[<-] k +.It Sy BPF_LDX + BPF_W + BPF_MEM Ta X \[<-] M[k] +.It Sy BPF_LDX + BPF_W + BPF_LEN Ta X \[<-] len +.It Sy BPF_LDX + BPF_B + BPF_MSH Ta X \[<-] 4*(P[k:1]&0xf) .El .It Sy BPF_ST This instruction stores the accumulator into the scratch memory. @@ -647,23 +647,23 @@ For binary operations, a source mode is or .Sy BPF_X ) . .Bl -column "\*[max-insn]" -offset indent -.It Sy BPF_ALU+BPF_ADD+BPF_K Ta A \[<-] A + k -.It Sy BPF_ALU+BPF_SUB+BPF_K Ta A \[<-] A \- k -.It Sy BPF_ALU+BPF_MUL+BPF_K Ta A \[<-] A * k -.It Sy BPF_ALU+BPF_DIV+BPF_K Ta A \[<-] A / k -.It Sy BPF_ALU+BPF_AND+BPF_K Ta A \[<-] A & k -.It Sy BPF_ALU+BPF_OR+BPF_K Ta A \[<-] A | k -.It Sy BPF_ALU+BPF_LSH+BPF_K Ta A \[<-] A \[<<] k -.It Sy BPF_ALU+BPF_RSH+BPF_K Ta A \[<-] A \[>>] k -.It Sy BPF_ALU+BPF_ADD+BPF_X Ta A \[<-] A + X -.It Sy BPF_ALU+BPF_SUB+BPF_X Ta A \[<-] A \- X -.It Sy BPF_ALU+BPF_MUL+BPF_X Ta A \[<-] A * X -.It Sy BPF_ALU+BPF_DIV+BPF_X Ta A \[<-] A / X -.It Sy BPF_ALU+BPF_AND+BPF_X Ta A \[<-] A & X -.It Sy BPF_ALU+BPF_OR+BPF_X Ta A \[<-] A | X -.It Sy BPF_ALU+BPF_LSH+BPF_X Ta A \[<-] A \[<<] X -.It Sy BPF_ALU+BPF_RSH+BPF_X Ta A \[<-] A \[>>] X -.It Sy BPF_ALU+BPF_NEG Ta A \[<-] \-A +.It Sy BPF_ALU + BPF_ADD + BPF_K Ta A \[<-] A + k +.It Sy BPF_ALU + BPF_SUB + BPF_K Ta A \[<-] A \- k +.It Sy BPF_ALU + BPF_MUL + BPF_K Ta A \[<-] A * k +.It Sy BPF_ALU + BPF_DIV + BPF_K Ta A \[<-] A / k +.It Sy BPF_ALU + BPF_AND + BPF_K Ta A \[<-] A & k +.It Sy BPF_ALU + BPF_OR + BPF_K Ta A \[<-] A | k +.It Sy BPF_ALU + BPF_LSH + BPF_K Ta A \[<-] A \[<<] k +.It Sy BPF_ALU + BPF_RSH + BPF_K Ta A \[<-] A \[>>] k +.It Sy BPF_ALU + BPF_ADD + BPF_X Ta A \[<-] A + X +.It Sy BPF_ALU + BPF_SUB + BPF_X Ta A \[<-] A \- X +.It Sy BPF_ALU + BPF_MUL + BPF_X Ta A \[<-] A * X +.It Sy BPF_ALU + BPF_DIV + BPF_X Ta A \[<-] A / X +.It Sy BPF_ALU + BPF_AND + BPF_X Ta A \[<-] A & X +.It Sy BPF_ALU + BPF_OR + BPF_X Ta A \[<-] A | X +.It Sy BPF_ALU + BPF_LSH + BPF_X Ta A \[<-] A \[<<] X +.It Sy BPF_ALU + BPF_RSH + BPF_X Ta A \[<-] A \[>>] X +.It Sy BPF_ALU + BPF_NEG Ta A \[<-] \-A .El .It Sy BPF_JMP The jump instructions alter flow of control. @@ -681,15 +681,15 @@ opcode uses the 32 bit field as the offset, allowing arbitrarily distant destinations. All conditionals use unsigned comparison conventions. .Bl -column "\*[max-insn]" -offset indent -.It Sy
CVS commit: src/share/man/man4
Module Name:src Committed By: uwe Date: Sat Feb 11 12:39:44 UTC 2023 Modified Files: src/share/man/man4: bpf.4 Log Message: bpf(4): spaces around + in instruction tables Makes them easier on the eyes. To generate a diff of this commit: cvs rdiff -u -r1.70 -r1.71 src/share/man/man4/bpf.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/share/man/man4
Module Name:src Committed By: uwe Date: Sat Feb 11 11:49:02 UTC 2023 Modified Files: src/share/man/man4: bpf.4 Log Message: bpf(4): use nicer glyphs for some operations in PS output To generate a diff of this commit: cvs rdiff -u -r1.69 -r1.70 src/share/man/man4/bpf.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/share/man/man4
Module Name:src Committed By: uwe Date: Sat Feb 11 11:49:02 UTC 2023 Modified Files: src/share/man/man4: bpf.4 Log Message: bpf(4): use nicer glyphs for some operations in PS output To generate a diff of this commit: cvs rdiff -u -r1.69 -r1.70 src/share/man/man4/bpf.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man4/bpf.4 diff -u src/share/man/man4/bpf.4:1.69 src/share/man/man4/bpf.4:1.70 --- src/share/man/man4/bpf.4:1.69 Sat Feb 11 11:34:49 2023 +++ src/share/man/man4/bpf.4 Sat Feb 11 11:49:02 2023 @@ -1,6 +1,6 @@ .\" -*- nroff -*- .\" -.\" $NetBSD: bpf.4,v 1.69 2023/02/11 11:34:49 uwe Exp $ +.\" $NetBSD: bpf.4,v 1.70 2023/02/11 11:49:02 uwe Exp $ .\" .\" Copyright (c) 1990, 1991, 1992, 1993, 1994 .\" The Regents of the University of California. All rights reserved. @@ -648,22 +648,22 @@ or .Sy BPF_X ) . .Bl -column "\*[max-insn]" -offset indent .It Sy BPF_ALU+BPF_ADD+BPF_K Ta A \[<-] A + k -.It Sy BPF_ALU+BPF_SUB+BPF_K Ta A \[<-] A - k +.It Sy BPF_ALU+BPF_SUB+BPF_K Ta A \[<-] A \- k .It Sy BPF_ALU+BPF_MUL+BPF_K Ta A \[<-] A * k .It Sy BPF_ALU+BPF_DIV+BPF_K Ta A \[<-] A / k .It Sy BPF_ALU+BPF_AND+BPF_K Ta A \[<-] A & k .It Sy BPF_ALU+BPF_OR+BPF_K Ta A \[<-] A | k -.It Sy BPF_ALU+BPF_LSH+BPF_K Ta A \[<-] A << k -.It Sy BPF_ALU+BPF_RSH+BPF_K Ta A \[<-] A >> k +.It Sy BPF_ALU+BPF_LSH+BPF_K Ta A \[<-] A \[<<] k +.It Sy BPF_ALU+BPF_RSH+BPF_K Ta A \[<-] A \[>>] k .It Sy BPF_ALU+BPF_ADD+BPF_X Ta A \[<-] A + X -.It Sy BPF_ALU+BPF_SUB+BPF_X Ta A \[<-] A - X +.It Sy BPF_ALU+BPF_SUB+BPF_X Ta A \[<-] A \- X .It Sy BPF_ALU+BPF_MUL+BPF_X Ta A \[<-] A * X .It Sy BPF_ALU+BPF_DIV+BPF_X Ta A \[<-] A / X .It Sy BPF_ALU+BPF_AND+BPF_X Ta A \[<-] A & X .It Sy BPF_ALU+BPF_OR+BPF_X Ta A \[<-] A | X -.It Sy BPF_ALU+BPF_LSH+BPF_X Ta A \[<-] A << X -.It Sy BPF_ALU+BPF_RSH+BPF_X Ta A \[<-] A >> X -.It Sy BPF_ALU+BPF_NEG Ta A \[<-] -A +.It Sy BPF_ALU+BPF_LSH+BPF_X Ta A \[<-] A \[<<] X +.It Sy BPF_ALU+BPF_RSH+BPF_X Ta A \[<-] A \[>>] X +.It Sy BPF_ALU+BPF_NEG Ta A \[<-] \-A .El .It Sy BPF_JMP The jump instructions alter flow of control. @@ -693,7 +693,8 @@ All conditionals use unsigned comparison .El .It Sy BPF_RET The return instructions terminate the filter program and specify the amount -of packet to accept (i.e., they return the truncation amount). +of packet to accept +.Pq i.e., they return the truncation amount . A return value of zero indicates that the packet should be ignored. The return value is either a constant .Sy ( BPF_K )
CVS commit: src/share/man/man4
Module Name:src Committed By: uwe Date: Sat Feb 11 11:34:49 UTC 2023 Modified Files: src/share/man/man4: bpf.4 Log Message: bpf(4): make all instruction tables align Define string max-insn and use it in all tables for the width of the first column (nroff has variables, shocking, I know). Define only the width of the first column, the last column gets all the remaining width. To generate a diff of this commit: cvs rdiff -u -r1.68 -r1.69 src/share/man/man4/bpf.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/share/man/man4
Module Name:src Committed By: uwe Date: Sat Feb 11 11:34:49 UTC 2023 Modified Files: src/share/man/man4: bpf.4 Log Message: bpf(4): make all instruction tables align Define string max-insn and use it in all tables for the width of the first column (nroff has variables, shocking, I know). Define only the width of the first column, the last column gets all the remaining width. To generate a diff of this commit: cvs rdiff -u -r1.68 -r1.69 src/share/man/man4/bpf.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man4/bpf.4 diff -u src/share/man/man4/bpf.4:1.68 src/share/man/man4/bpf.4:1.69 --- src/share/man/man4/bpf.4:1.68 Sat Feb 11 11:02:31 2023 +++ src/share/man/man4/bpf.4 Sat Feb 11 11:34:49 2023 @@ -1,6 +1,6 @@ .\" -*- nroff -*- .\" -.\" $NetBSD: bpf.4,v 1.68 2023/02/11 11:02:31 uwe Exp $ +.\" $NetBSD: bpf.4,v 1.69 2023/02/11 11:34:49 uwe Exp $ .\" .\" Copyright (c) 1990, 1991, 1992, 1993, 1994 .\" The Regents of the University of California. All rights reserved. @@ -601,7 +601,10 @@ or byte Arithmetic overflow when calculating a variable offset terminates the filter program and the packet is ignored. The semantics of all the recognized BPF_LD instructions follow. -.Bl -column "BPF_LD_BPF_W_BPF_ABS" "A \[<-] P[k:4]" -offset indent +.\" to make all instruction tables align nicely, use common max width +.ds max-insn .Sy BPF_LDX+BPF_W+BPF_WWW +.\" +.Bl -column "\*[max-insn]" -offset indent .It Sy BPF_LD+BPF_W+BPF_ABS Ta A \[<-] P[k:4] .It Sy BPF_LD+BPF_H+BPF_ABS Ta A \[<-] P[k:2] .It Sy BPF_LD+BPF_B+BPF_ABS Ta A \[<-] P[k:1] @@ -618,7 +621,7 @@ Note that the addressing modes are more the accumulator loads, but they include .Sy BPF_MSH , a hack for efficiently loading the IP header length. -.Bl -column "BPF_LDX_BPF_W_BPF_MEM" "X \[<-] k" -offset indent +.Bl -column "\*[max-insn]" -offset indent .It Sy BPF_LDX+BPF_W+BPF_IMM Ta X \[<-] k .It Sy BPF_LDX+BPF_W+BPF_MEM Ta X \[<-] M[k] .It Sy BPF_LDX+BPF_W+BPF_LEN Ta X \[<-] len @@ -628,12 +631,12 @@ a hack for efficiently loading the IP he This instruction stores the accumulator into the scratch memory. We do not need an addressing mode since there is only one possibility for the destination. -.Bl -column "BPF_ST" "M[k] \[<-] A" -offset indent +.Bl -column "\*[max-insn]" -offset indent .It Sy BPF_ST Ta M[k] \[<-] A .El .It Sy BPF_STX This instruction stores the index register in the scratch memory store. -.Bl -column "BPF_STX" "M[k] \[<-] X" -offset indent +.Bl -column "\*[max-insn]" -offset indent .It Sy BPF_STX Ta M[k] \[<-] X .El .It Sy BPF_ALU @@ -643,7 +646,7 @@ For binary operations, a source mode is .Sy ( BPF_K or .Sy BPF_X ) . -.Bl -column "BPF_ALU_BPF_ADD_BPF_K" "A \[<-] A + k" -offset indent +.Bl -column "\*[max-insn]" -offset indent .It Sy BPF_ALU+BPF_ADD+BPF_K Ta A \[<-] A + k .It Sy BPF_ALU+BPF_SUB+BPF_K Ta A \[<-] A - k .It Sy BPF_ALU+BPF_MUL+BPF_K Ta A \[<-] A * k @@ -677,7 +680,7 @@ opcode uses the 32 bit .Va k field as the offset, allowing arbitrarily distant destinations. All conditionals use unsigned comparison conventions. -.Bl -column "BPF_JMP+BPF_JSET+BPF_K" "pc += (A \*[Ge] k) ? jt : jf" -offset indent +.Bl -column "\*[max-insn]" -offset indent .It Sy BPF_JMP+BPF_JA Ta pc += k .It Sy BPF_JMP+BPF_JGT+BPF_K Ta "pc += (A > k) ? jt : jf" .It Sy BPF_JMP+BPF_JGE+BPF_K Ta "pc += (A \*[Ge] k) ? jt : jf" @@ -696,7 +699,7 @@ The return value is either a constant .Sy ( BPF_K ) or the accumulator .Sy ( BPF_A ) . -.Bl -column "BPF_RET+BPF_A" "accept A bytes" -offset indent +.Bl -column "\*[max-insn]" -offset indent .It Sy BPF_RET+BPF_A Ta accept A bytes .It Sy BPF_RET+BPF_K Ta accept k bytes .El @@ -706,7 +709,7 @@ fit into the above classes, and for any be added. Currently, these are the register transfer instructions that copy the index register to the accumulator or vice versa. -.Bl -column "BPF_MISC+BPF_TAX" "X \[<-] A" -offset indent +.Bl -column "\*[max-insn]" -offset indent .It Sy BPF_MISC+BPF_TAX Ta X \[<-] A .It Sy BPF_MISC+BPF_TXA Ta A \[<-] X .El @@ -714,7 +717,7 @@ that copy the index register to the accu Also, two instructions to call a "coprocessor" if initialized by the kernel component. There is no coprocessor by default. -.Bl -column "BPF_MISC+BPF_COPX" "A \[<-] funcs[X](...)" -offset indent +.Bl -column "\*[max-insn]" -offset indent .It Sy BPF_MISC+BPF_COP Ta A \[<-] funcs[k](..) .It Sy BPF_MISC+BPF_COPX Ta A \[<-] funcs[X](..) .El
CVS commit: src/share/man/man4
Module Name:src Committed By: uwe Date: Sat Feb 11 11:02:31 UTC 2023 Modified Files: src/share/man/man4: bpf.4 Log Message: bpf(4): use \[<-] instead of <- To generate a diff of this commit: cvs rdiff -u -r1.67 -r1.68 src/share/man/man4/bpf.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man4/bpf.4 diff -u src/share/man/man4/bpf.4:1.67 src/share/man/man4/bpf.4:1.68 --- src/share/man/man4/bpf.4:1.67 Sat Feb 11 02:52:52 2023 +++ src/share/man/man4/bpf.4 Sat Feb 11 11:02:31 2023 @@ -1,6 +1,6 @@ .\" -*- nroff -*- .\" -.\" $NetBSD: bpf.4,v 1.67 2023/02/11 02:52:52 uwe Exp $ +.\" $NetBSD: bpf.4,v 1.68 2023/02/11 11:02:31 uwe Exp $ .\" .\" Copyright (c) 1990, 1991, 1992, 1993, 1994 .\" The Regents of the University of California. All rights reserved. @@ -601,16 +601,16 @@ or byte Arithmetic overflow when calculating a variable offset terminates the filter program and the packet is ignored. The semantics of all the recognized BPF_LD instructions follow. -.Bl -column "BPF_LD_BPF_W_BPF_ABS" "A <- P[k:4]" -offset indent -.It Sy BPF_LD+BPF_W+BPF_ABS Ta A <- P[k:4] -.It Sy BPF_LD+BPF_H+BPF_ABS Ta A <- P[k:2] -.It Sy BPF_LD+BPF_B+BPF_ABS Ta A <- P[k:1] -.It Sy BPF_LD+BPF_W+BPF_IND Ta A <- P[X+k:4] -.It Sy BPF_LD+BPF_H+BPF_IND Ta A <- P[X+k:2] -.It Sy BPF_LD+BPF_B+BPF_IND Ta A <- P[X+k:1] -.It Sy BPF_LD+BPF_W+BPF_LEN Ta A <- len -.It Sy BPF_LD+BPF_IMM Ta A <- k -.It Sy BPF_LD+BPF_MEM Ta A <- M[k] +.Bl -column "BPF_LD_BPF_W_BPF_ABS" "A \[<-] P[k:4]" -offset indent +.It Sy BPF_LD+BPF_W+BPF_ABS Ta A \[<-] P[k:4] +.It Sy BPF_LD+BPF_H+BPF_ABS Ta A \[<-] P[k:2] +.It Sy BPF_LD+BPF_B+BPF_ABS Ta A \[<-] P[k:1] +.It Sy BPF_LD+BPF_W+BPF_IND Ta A \[<-] P[X+k:4] +.It Sy BPF_LD+BPF_H+BPF_IND Ta A \[<-] P[X+k:2] +.It Sy BPF_LD+BPF_B+BPF_IND Ta A \[<-] P[X+k:1] +.It Sy BPF_LD+BPF_W+BPF_LEN Ta A \[<-] len +.It Sy BPF_LD+BPF_IMM Ta A \[<-] k +.It Sy BPF_LD+BPF_MEM Ta A \[<-] M[k] .El .It Sy BPF_LDX These instructions load a value into the index register. @@ -618,23 +618,23 @@ Note that the addressing modes are more the accumulator loads, but they include .Sy BPF_MSH , a hack for efficiently loading the IP header length. -.Bl -column "BPF_LDX_BPF_W_BPF_MEM" "X <- k" -offset indent -.It Sy BPF_LDX+BPF_W+BPF_IMM Ta X <- k -.It Sy BPF_LDX+BPF_W+BPF_MEM Ta X <- M[k] -.It Sy BPF_LDX+BPF_W+BPF_LEN Ta X <- len -.It Sy BPF_LDX+BPF_B+BPF_MSH Ta X <- 4*(P[k:1]&0xf) +.Bl -column "BPF_LDX_BPF_W_BPF_MEM" "X \[<-] k" -offset indent +.It Sy BPF_LDX+BPF_W+BPF_IMM Ta X \[<-] k +.It Sy BPF_LDX+BPF_W+BPF_MEM Ta X \[<-] M[k] +.It Sy BPF_LDX+BPF_W+BPF_LEN Ta X \[<-] len +.It Sy BPF_LDX+BPF_B+BPF_MSH Ta X \[<-] 4*(P[k:1]&0xf) .El .It Sy BPF_ST This instruction stores the accumulator into the scratch memory. We do not need an addressing mode since there is only one possibility for the destination. -.Bl -column "BPF_ST" "M[k] <- A" -offset indent -.It Sy BPF_ST Ta M[k] <- A +.Bl -column "BPF_ST" "M[k] \[<-] A" -offset indent +.It Sy BPF_ST Ta M[k] \[<-] A .El .It Sy BPF_STX This instruction stores the index register in the scratch memory store. -.Bl -column "BPF_STX" "M[k] <- X" -offset indent -.It Sy BPF_STX Ta M[k] <- X +.Bl -column "BPF_STX" "M[k] \[<-] X" -offset indent +.It Sy BPF_STX Ta M[k] \[<-] X .El .It Sy BPF_ALU The alu instructions perform operations between the accumulator and @@ -643,24 +643,24 @@ For binary operations, a source mode is .Sy ( BPF_K or .Sy BPF_X ) . -.Bl -column "BPF_ALU_BPF_ADD_BPF_K" "A <- A + k" -offset indent -.It Sy BPF_ALU+BPF_ADD+BPF_K Ta A <- A + k -.It Sy BPF_ALU+BPF_SUB+BPF_K Ta A <- A - k -.It Sy BPF_ALU+BPF_MUL+BPF_K Ta A <- A * k -.It Sy BPF_ALU+BPF_DIV+BPF_K Ta A <- A / k -.It Sy BPF_ALU+BPF_AND+BPF_K Ta A <- A & k -.It Sy BPF_ALU+BPF_OR+BPF_K Ta A <- A | k -.It Sy BPF_ALU+BPF_LSH+BPF_K Ta A <- A << k -.It Sy BPF_ALU+BPF_RSH+BPF_K Ta A <- A >> k -.It Sy BPF_ALU+BPF_ADD+BPF_X Ta A <- A + X -.It Sy BPF_ALU+BPF_SUB+BPF_X Ta A <- A - X -.It Sy BPF_ALU+BPF_MUL+BPF_X Ta A <- A * X -.It Sy BPF_ALU+BPF_DIV+BPF_X Ta A <- A / X -.It Sy BPF_ALU+BPF_AND+BPF_X Ta A <- A & X -.It Sy BPF_ALU+BPF_OR+BPF_X Ta A <- A | X -.It Sy BPF_ALU+BPF_LSH+BPF_X Ta A <- A << X -.It Sy BPF_ALU+BPF_RSH+BPF_X Ta A <- A >> X -.It Sy BPF_ALU+BPF_NEG Ta A <- -A +.Bl -column "BPF_ALU_BPF_ADD_BPF_K" "A \[<-] A + k" -offset indent +.It Sy BPF_ALU+BPF_ADD+BPF_K Ta A \[<-] A + k +.It Sy BPF_ALU+BPF_SUB+BPF_K Ta A \[<-] A - k +.It Sy BPF_ALU+BPF_MUL+BPF_K Ta A \[<-] A * k +.It Sy BPF_ALU+BPF_DIV+BPF_K Ta A \[<-] A / k +.It Sy BPF_ALU+BPF_AND+BPF_K Ta A \[<-] A & k +.It Sy BPF_ALU+BPF_OR+BPF_K Ta A \[<-] A | k +.It Sy BPF_ALU+BPF_LSH+BPF_K Ta A \[<-] A << k +.It Sy BPF_ALU+BPF_RSH+BPF_K Ta A \[<-] A >> k +.It Sy BPF_ALU+BPF_ADD+BPF_X Ta A \[<-] A + X +.It Sy BPF_ALU+BPF_SUB+BPF_X Ta A \[<-] A - X +.It Sy BPF_ALU+BPF_MUL+BPF_X Ta A \[<-] A * X +.It Sy BPF_ALU+BPF_DIV+BPF_X Ta A \[<-] A / X +.It Sy
CVS commit: src/share/man/man4
Module Name:src Committed By: uwe Date: Sat Feb 11 11:02:31 UTC 2023 Modified Files: src/share/man/man4: bpf.4 Log Message: bpf(4): use \[<-] instead of <- To generate a diff of this commit: cvs rdiff -u -r1.67 -r1.68 src/share/man/man4/bpf.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/share/man/man4
Module Name:src Committed By: uwe Date: Sat Feb 11 02:52:52 UTC 2023 Modified Files: src/share/man/man4: bpf.4 Log Message: bpf(4): assorted markup tweaks This is mostly non-controversial changes to the cargo-culted markup. While here - add missing .It to BIOCLOCK so that it's not buried in the text for the previous item and comment out a paragraph about an ancient SunOS bug. To generate a diff of this commit: cvs rdiff -u -r1.66 -r1.67 src/share/man/man4/bpf.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/share/man/man4
Module Name:src
Committed By: uwe
Date: Sat Feb 11 02:52:52 UTC 2023
Modified Files:
src/share/man/man4: bpf.4
Log Message:
bpf(4): assorted markup tweaks
This is mostly non-controversial changes to the cargo-culted markup.
While here - add missing .It to BIOCLOCK so that it's not buried in
the text for the previous item and comment out a paragraph about an
ancient SunOS bug.
To generate a diff of this commit:
cvs rdiff -u -r1.66 -r1.67 src/share/man/man4/bpf.4
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/share/man/man4/bpf.4
diff -u src/share/man/man4/bpf.4:1.66 src/share/man/man4/bpf.4:1.67
--- src/share/man/man4/bpf.4:1.66 Tue Feb 7 01:17:41 2023
+++ src/share/man/man4/bpf.4 Sat Feb 11 02:52:52 2023
@@ -1,6 +1,6 @@
.\" -*- nroff -*-
.\"
-.\" $NetBSD: bpf.4,v 1.66 2023/02/07 01:17:41 gutteridge Exp $
+.\" $NetBSD: bpf.4,v 1.67 2023/02/11 02:52:52 uwe Exp $
.\"
.\" Copyright (c) 1990, 1991, 1992, 1993, 1994
.\" The Regents of the University of California. All rights reserved.
@@ -100,12 +100,12 @@ require
The (third) argument to the
.Xr ioctl 2
should be a pointer to the type indicated.
-.Bl -tag -width indent -offset indent
-.It Dv BIOCGBLEN ( u_int )
+.Bl -tag -width Dv
+.It Dv BIOCGBLEN Pq Vt u_int
Returns the required buffer length for reads on
.Nm
files.
-.It Dv BIOCSBLEN ( u_int )
+.It Dv BIOCSBLEN Pq Vt u_int
Sets the buffer length for reads on
.Nm
files.
@@ -116,15 +116,15 @@ allowable size will be set and returned
A read call will result in
.Er EINVAL
if it is passed a buffer that is not this size.
-.It Dv BIOCGDLT ( u_int )
+.It Dv BIOCGDLT Pq Vt u_int
Returns the type of the data link layer underlying the attached interface.
.Er EINVAL
is returned if no interface has been specified.
The device types, prefixed with
-.Dq DLT_ ,
+.Ql DLT_ ,
are defined in
.In net/bpf.h .
-.It Dv BIOCGDLTLIST ( struct bpf_dltlist )
+.It Dv BIOCGDLTLIST Pq Vt struct bpf_dltlist
Returns an array of the available types of the data link layer
underlying the attached interface:
.Bd -literal -offset indent
@@ -135,26 +135,29 @@ struct bpf_dltlist {
.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
+.Fa bfl_list
+field while their length in
+.Vt u_int
+is supplied to the
+.Fa 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
+.Fa bfl_len
field is modified on return to indicate the actual length in u_int
of the array returned.
If
-.Va bfl_list
+.Fa 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 ( u_int )
+.Fa bfl_len
+field is set to indicate the required length of an array in
+.Vt u_int .
+.It Dv BIOCSDLT Pq Vt 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
@@ -173,30 +176,34 @@ promiscuously are closed.
Flushes the buffer of incoming packets,
and resets the statistics that are returned by
.Dv BIOCGSTATS .
-.It Dv BIOCGETIF ( struct ifreq )
+.It Dv BIOCGETIF Pq Vt struct ifreq
Returns the name of the hardware interface that the file is listening on.
-The name is returned in the ifr_name field of
-.Fa ifr .
+The name is returned in the
+.Fa ifr_name
+field of
+.Vt ifreq .
All other fields are undefined.
-.It Dv BIOCSETIF ( struct ifreq )
+.It Dv BIOCSETIF Pq Vt struct ifreq
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
-.Dv ifr_name
+.Fa ifr_name
field of the
-.Fa ifreq .
+.Vt ifreq .
Additionally, performs the actions of
.Dv BIOCFLUSH .
-.It Dv BIOCSRTIMEOUT , BIOCGRTIMEOUT ( struct timeval )
-Sets or gets the read timeout parameter.
+.It Dv BIOCSRTIMEOUT , BIOCGRTIMEOUT Pq Vt struct timeval
+Sets or gets the
+.Dq Em read timeout
+parameter.
The
-.Fa timeval
+.Vt timeval
specifies the length of time to wait before timing
out on a read request.
This parameter is initialized to zero by
.Xr open 2 ,
indicating no timeout.
-.It Dv BIOCGSTATS ( struct bpf_stat )
+.It Dv BIOCGSTATS Pq Vt struct bpf_stat
Returns the following structure of packet statistics:
.Bd -literal -offset indent
struct bpf_stat {
@@ -208,21 +215,23 @@ struct bpf_stat {
.Ed
.Pp
The fields are:
-.Bl -tag -width bs_recv -offset indent
-.It Va bs_recv
+.Bl -tag -width Fa -offset indent
+.It Fa bs_recv
the number of packets received by the descriptor since opened or reset
-(including any buffered since the last read call);
-.It Va bs_drop
+.Pq including any buffered since the last read call ;
+.It Fa bs_drop
the number of packets which were accepted by the filter but
CVS commit: src/share/man/man9
Module Name:src Committed By: uwe Date: Thu Feb 2 14:09:52 UTC 2023 Modified Files: src/share/man/man9: devsw_attach.9 Log Message: devsw_attach(9): Use semantic markup instead of .Em To generate a diff of this commit: cvs rdiff -u -r1.5 -r1.6 src/share/man/man9/devsw_attach.9 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man9/devsw_attach.9 diff -u src/share/man/man9/devsw_attach.9:1.5 src/share/man/man9/devsw_attach.9:1.6 --- src/share/man/man9/devsw_attach.9:1.5 Thu Feb 2 13:25:41 2023 +++ src/share/man/man9/devsw_attach.9 Thu Feb 2 14:09:52 2023 @@ -1,4 +1,4 @@ -.\" $NetBSD: devsw_attach.9,v 1.5 2023/02/02 13:25:41 pgoyette Exp $ +.\" $NetBSD: devsw_attach.9,v 1.6 2023/02/02 14:09:52 uwe Exp $ .\" .\" Copyright (c) 2015 The NetBSD Foundation, Inc. .\" All rights reserved. @@ -73,11 +73,11 @@ .Sh DESCRIPTION If a device driver has character device interfaces accessed from userland, the driver must define a -.Em cdevsw +.Vt cdevsw structure. If the driver also has block device interfaces, the driver must additionally define a -.Em bdevsw +.Vt bdevsw structure. These structures are constant, and are defined within the .Xr driver 9 . @@ -85,54 +85,57 @@ These structures are constant, and are d For drivers which are included in the kernel via .Xr config 1 , the -.Em cdevsw +.Vt cdevsw and -.Em bdevsw +.Vt bdevsw structures are automatically linked into the configuration database. For drivers which are separately loaded, the .Fn devsw_attach function creates the necessary linkage and associates the -.Em cdev +.Fa cdev and optional -.Em bdev +.Fa bdev with the .Xr driver 9 . If there is no block device interface needed, -.Em bdev +.Fa bdev should be set to .Dv NULL and -.Em bmajor +.Fa bmajor to -.Dv \-1 . +.Dv NODEVMAJOR . The -.Em devname , +.Fa devname , major number, and device type (character or block) must correspond to the device file which will be opened by user programs. By passing -.Dv \-1 +.Dv NODEVMAJOR to the function for the -.Em cmajor +.Fa cmajor or -.Em bmajor , +.Fa bmajor , the major number can be automatically generated. -It can then be returned to userspace (for example, using -.Xr sysctl 8 ) +It can then be returned to userspace +.Po +for example, using +.Xr sysctl 8 +.Pc for creation of the device node. .Pp The .Fn devsw_detach function is used to detach the -.Em bdev +.Fa bdev and -.Em cdev +.Fa cdev structures. .Fn devsw_detach should be called before a loaded device driver is unloaded. The caller must ensure that there are no open instances of the device, and that the device's -.Fn d_open +.Fa d_open function will fail, before calling .Fn devsw_detach . .Pp @@ -141,22 +144,22 @@ The and .Fn cdevsw_lookup functions return -.Em "const struct bdevsw *" +.Vt "const struct bdevsw *" and -.Em "const struct cdevsw *" +.Vt "const struct cdevsw *" for the given -.Em dev . +.Fa dev . .Pp The .Fn bdevsw_lookup_major and .Fn cdevsw_lookup_major functions return -.Em "devmajor_t" +.Vt "devmajor_t" for the given -.Em "const struct bdevsw *" +.Vt "const struct bdevsw *" or -.Em "const struct cdevsw *" . +.Vt "const struct cdevsw *" . .Sh RETURN VALUES Upon successful completion, .Fn devsw_attach
CVS commit: src/share/man/man9
Module Name:src Committed By: uwe Date: Thu Feb 2 14:09:52 UTC 2023 Modified Files: src/share/man/man9: devsw_attach.9 Log Message: devsw_attach(9): Use semantic markup instead of .Em To generate a diff of this commit: cvs rdiff -u -r1.5 -r1.6 src/share/man/man9/devsw_attach.9 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/sys/modules/examples/ddbping
Module Name:src
Committed By: uwe
Date: Wed Feb 1 10:22:20 UTC 2023
Modified Files:
src/sys/modules/examples/ddbping: ddbping.c
Log Message:
ddbping - restore the original narration of the example, NFCI
Adjust previous change so that it only replaces my home-grown define
for the end marker with the new official DDB_END_CMD marker that it
introduced. Undo the rest of that last change.
As the author of this example I'm pretty sure what example I wanted to
set and this narration order is an important part of it.
To generate a diff of this commit:
cvs rdiff -u -r1.2 -r1.3 src/sys/modules/examples/ddbping/ddbping.c
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/sys/modules/examples/ddbping/ddbping.c
diff -u src/sys/modules/examples/ddbping/ddbping.c:1.2 src/sys/modules/examples/ddbping/ddbping.c:1.3
--- src/sys/modules/examples/ddbping/ddbping.c:1.2 Tue Feb 23 07:13:53 2021
+++ src/sys/modules/examples/ddbping/ddbping.c Wed Feb 1 10:22:20 2023
@@ -1,4 +1,4 @@
-/* $NetBSD: ddbping.c,v 1.2 2021/02/23 07:13:53 mrg Exp $ */
+/* $NetBSD: ddbping.c,v 1.3 2023/02/01 10:22:20 uwe Exp $ */
/*
* Copyright (c) 2020 Valery Ushakov
* All rights reserved.
@@ -28,19 +28,42 @@
* Example of a kernel module that registers DDB commands.
*/
#include
-__KERNEL_RCSID(0, "$NetBSD: ddbping.c,v 1.2 2021/02/23 07:13:53 mrg Exp $");
+__KERNEL_RCSID(0, "$NetBSD: ddbping.c,v 1.3 2023/02/01 10:22:20 uwe Exp $");
#include
#include
#include
+/* XXX: db_command.h should provide something like this */
+typedef void db_cmdfn_t(db_expr_t, bool, db_expr_t, const char *);
+
+
+static db_cmdfn_t db_ping;
+static db_cmdfn_t db_show_ping;
+
+
+static const struct db_command db_ping_base_tbl[] = {
+ { DDB_ADD_CMD("ping", db_ping, 0,
+ "Example command",
+ NULL, NULL) },
+ { DDB_END_CMD },
+};
+
+static const struct db_command db_ping_show_tbl[] = {
+ { DDB_ADD_CMD("ping", db_show_ping, 0,
+ "Example command stats",
+ NULL, NULL) },
+ { DDB_END_CMD },
+};
+
static unsigned int ping_count;
static unsigned int ping_count_modif;
static unsigned int ping_count_addr;
static unsigned int ping_count_count;
+
static void
db_ping(db_expr_t addr, bool have_addr, db_expr_t count, const char *modif)
{
@@ -75,20 +98,6 @@ db_show_ping(db_expr_t addr, bool have_a
db_printf("with count\t%u\n", ping_count_count);
}
-static const struct db_command db_ping_base_tbl[] = {
- { DDB_ADD_CMD("ping", db_ping, 0,
- "Example command",
- NULL, NULL) },
- { DDB_END_CMD },
-};
-
-static const struct db_command db_ping_show_tbl[] = {
- { DDB_ADD_CMD("ping", db_show_ping, 0,
- "Example command stats",
- NULL, NULL) },
- { DDB_END_CMD },
-};
-
MODULE(MODULE_CLASS_MISC, ddbping, NULL);
CVS commit: src/sys/modules/examples/ddbping
Module Name:src Committed By: uwe Date: Wed Feb 1 10:22:20 UTC 2023 Modified Files: src/sys/modules/examples/ddbping: ddbping.c Log Message: ddbping - restore the original narration of the example, NFCI Adjust previous change so that it only replaces my home-grown define for the end marker with the new official DDB_END_CMD marker that it introduced. Undo the rest of that last change. As the author of this example I'm pretty sure what example I wanted to set and this narration order is an important part of it. To generate a diff of this commit: cvs rdiff -u -r1.2 -r1.3 src/sys/modules/examples/ddbping/ddbping.c Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/usr.bin/locate/locate
Module Name:src Committed By: uwe Date: Fri Jan 20 13:07:09 UTC 2023 Modified Files: src/usr.bin/locate/locate: updatedb.sh Log Message: locate.updatedb: Add -- to the invocation of locate.code A bigram can start with a dash/minus, don't let getopt misinterpret it as an option. >From Hakan Engvall in PR misc/57191 To generate a diff of this commit: cvs rdiff -u -r1.17 -r1.18 src/usr.bin/locate/locate/updatedb.sh Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/usr.bin/locate/locate/updatedb.sh diff -u src/usr.bin/locate/locate/updatedb.sh:1.17 src/usr.bin/locate/locate/updatedb.sh:1.18 --- src/usr.bin/locate/locate/updatedb.sh:1.17 Sat Apr 25 10:06:42 2020 +++ src/usr.bin/locate/locate/updatedb.sh Fri Jan 20 13:07:09 2023 @@ -1,6 +1,6 @@ #!/bin/sh # -# $NetBSD: updatedb.sh,v 1.17 2020/04/25 10:06:42 simonb Exp $ +# $NetBSD: updatedb.sh,v 1.18 2023/01/20 13:07:09 uwe Exp $ # # Copyright (c) 1989, 1993 # The Regents of the University of California. All rights reserved. @@ -216,6 +216,6 @@ if [ -z "$BIGRAMS" ]; then echo 'locate: updatedb failed' >&2 exit 1 else - $LIBDIR/locate.code "$BIGRAMS" <"$FILELIST" >"$FCODES" + $LIBDIR/locate.code -- "$BIGRAMS" <"$FILELIST" >"$FCODES" chmod 644 "$FCODES" fi
CVS commit: src/usr.bin/locate/locate
Module Name:src Committed By: uwe Date: Fri Jan 20 13:07:09 UTC 2023 Modified Files: src/usr.bin/locate/locate: updatedb.sh Log Message: locate.updatedb: Add -- to the invocation of locate.code A bigram can start with a dash/minus, don't let getopt misinterpret it as an option. >From Hakan Engvall in PR misc/57191 To generate a diff of this commit: cvs rdiff -u -r1.17 -r1.18 src/usr.bin/locate/locate/updatedb.sh Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/lib/libcrypt
Module Name:src Committed By: uwe Date: Tue Jan 17 14:27:11 UTC 2023 Modified Files: src/lib/libcrypt: crypt.3 Log Message: crypt(3): Minor markup tweaks To generate a diff of this commit: cvs rdiff -u -r1.34 -r1.35 src/lib/libcrypt/crypt.3 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/lib/libcrypt
Module Name:src Committed By: uwe Date: Tue Jan 17 14:27:11 UTC 2023 Modified Files: src/lib/libcrypt: crypt.3 Log Message: crypt(3): Minor markup tweaks To generate a diff of this commit: cvs rdiff -u -r1.34 -r1.35 src/lib/libcrypt/crypt.3 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/lib/libcrypt/crypt.3 diff -u src/lib/libcrypt/crypt.3:1.34 src/lib/libcrypt/crypt.3:1.35 --- src/lib/libcrypt/crypt.3:1.34 Tue Jan 17 01:56:43 2023 +++ src/lib/libcrypt/crypt.3 Tue Jan 17 14:27:11 2023 @@ -1,4 +1,4 @@ -.\" $NetBSD: crypt.3,v 1.34 2023/01/17 01:56:43 riastradh Exp $ +.\" $NetBSD: crypt.3,v 1.35 2023/01/17 14:27:11 uwe Exp $ .\" .\" Copyright (c) 1989, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -62,7 +62,7 @@ performs password hashing. The password hashing scheme used by .Fn crypt is dependent upon the contents of the -.Dv NUL Ns -terminated +.Tn NUL Ns -terminated string .Ar setting . If it begins @@ -78,19 +78,27 @@ If .Ar setting begins with the .Ql _ -character, DES password hashing with a user specified number of +character, +.Tn DES +password hashing with a user specified number of perturbations is selected. If .Ar setting -begins with any other character, DES password hashing with a fixed +begins with any other character, +.Tn DES +password hashing with a fixed number of perturbations is selected. .Ss DES password hashing -The DES password hashing scheme is derived from the +The +.Tn DES +password hashing scheme is derived from the .Tn NBS Data Encryption Standard. Additional code has been added to deter key search attempts and to use stronger hashing algorithms. -In the DES case, the second argument to +In the +.Tn DES +case, the second argument to .Fn crypt is a character array, 9 bytes in length, consisting of an underscore .Pq Ql _ @@ -127,16 +135,24 @@ The .Ar key is divided into groups of 8 characters (a short final group is null-padded) and the low-order 7 bits of each character (56 bits per group) are -used to form the DES key as follows: the first group of 56 bits becomes the -initial DES key. -For each additional group, the XOR of the group bits and the encryption of -the DES key with itself becomes the next DES key. -Then the final DES key is used to perform +used to form the +.Tn DES +key as follows: the first group of 56 bits becomes the initial +.Tn DES +key. +For each additional group, the XOR of the group bits and the encryption of the +.Tn DES +key with itself becomes the next +.Tn DES +key. +Then the final +.Tn DES +key is used to perform .Ar count cumulative encryptions of a 64-bit constant yielding a .Sq ciphertext . The value returned is a -.Dv NUL Ns -terminated +.Tn NUL Ns -terminated string, 20 bytes in length, consisting of the .Ar setting @@ -156,7 +172,7 @@ are available, at most 8 characters of .Ar key are used, and the returned value is a -.Dv NUL Ns -terminated +.Tn NUL Ns -terminated string 13 bytes in length. .Pp The @@ -174,7 +190,7 @@ The argument to .Fn setkey is a 64 character array of -binary values (numeric 0 or 1). +binary values (numeric 0 or\~1). A 56-bit key is derived from this array by dividing the array into groups of 8 and ignoring the last bit in each group. .Pp @@ -245,6 +261,7 @@ by the .Ql $ character. An encoded password hash looks like: +.Pp .Dl "$1$2qGr5PPQ$eT08WBFev3RPLNChixg0H" .Pp The entire encoded MD5 password hash is passed as @@ -258,15 +275,23 @@ It is recommended to use argon2id, which using argon2i on the first pass, and argon2d on the remaining passes. We parameterize on three variables. -First, m_cost (m), specifies the memory usage in KB. -Second, t_cost (t), specifies the number of iterations. -Third, parallelism (p) specifies the number of threads. +First, +.Va m_cost ( Li m ) , +specifies the memory usage in +.Tn KB . +Second, +.Va t_cost ( Li t ) , +specifies the number of iterations. +Third, +.Va parallelism ( Li p ) +specifies the number of threads. This is currently ignored and one thread will always be used. An encoded Argon2 password hash looks like: -.Bd -literal -$argon2id$v=19$m=4096,t=6,p=1$qCatF9a1s/6TgcYB$ \ +.Bd -literal -offset indent +$argon2id$v=19$m=4096,t=6,p=1$qCatF9a1s/6TgcYB$ \e yeYYrU/rh7E+LI2CAeHTSHVB3iO+OXiNIUHu6NPeTfo .Ed +.Pp containing five fields delimited by .Ql $ . The fields, in order, are variant name, version, parameter set, @@ -292,7 +317,7 @@ the password hash. The maximum password length is 72. The final Blowfish password output is created by encrypting the string .Pp -.Dq OrpheanBeholderScryDoubt +.Dl OrpheanBeholderScryDoubt .Pp with the .Tn Blowfish @@ -306,7 +331,8 @@ An encoded .Sq 8 would specify 256 rounds. An encoded Blowfish password hash looks like: -.Dl $2a$12$eIAq8PR8sIUnJ1HaohxX2O9x9Qlm2vK97LJ5dsXdmB.eXF42qjchC +.Pp +.Dl
CVS commit: src/sys/arch
Module Name:src
Committed By: uwe
Date: Sat Dec 24 14:47:47 UTC 2022
Modified Files:
src/sys/arch/amd64/amd64: db_machdep.c
src/sys/arch/i386/i386: db_machdep.c
Log Message:
{amd64,i386}/db_machdep.c: Don't bury a function call in an if condition
db_frame_info has many arguments and requires contorted line wrapping
that obscures the condition. The same object code is generated
(modulo a local variable moved closer to its only use site).
To generate a diff of this commit:
cvs rdiff -u -r1.14 -r1.15 src/sys/arch/amd64/amd64/db_machdep.c
cvs rdiff -u -r1.9 -r1.10 src/sys/arch/i386/i386/db_machdep.c
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
CVS commit: src/sys/arch
Module Name:src
Committed By: uwe
Date: Sat Dec 24 14:47:47 UTC 2022
Modified Files:
src/sys/arch/amd64/amd64: db_machdep.c
src/sys/arch/i386/i386: db_machdep.c
Log Message:
{amd64,i386}/db_machdep.c: Don't bury a function call in an if condition
db_frame_info has many arguments and requires contorted line wrapping
that obscures the condition. The same object code is generated
(modulo a local variable moved closer to its only use site).
To generate a diff of this commit:
cvs rdiff -u -r1.14 -r1.15 src/sys/arch/amd64/amd64/db_machdep.c
cvs rdiff -u -r1.9 -r1.10 src/sys/arch/i386/i386/db_machdep.c
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/sys/arch/amd64/amd64/db_machdep.c
diff -u src/sys/arch/amd64/amd64/db_machdep.c:1.14 src/sys/arch/amd64/amd64/db_machdep.c:1.15
--- src/sys/arch/amd64/amd64/db_machdep.c:1.14 Sat Dec 24 14:32:42 2022
+++ src/sys/arch/amd64/amd64/db_machdep.c Sat Dec 24 14:47:47 2022
@@ -1,4 +1,4 @@
-/* $NetBSD: db_machdep.c,v 1.14 2022/12/24 14:32:42 uwe Exp $ */
+/* $NetBSD: db_machdep.c,v 1.15 2022/12/24 14:47:47 uwe Exp $ */
/*
* Mach Operating System
@@ -26,7 +26,7 @@
* rights to redistribute these changes.
*/
#include
-__KERNEL_RCSID(0, "$NetBSD: db_machdep.c,v 1.14 2022/12/24 14:32:42 uwe Exp $");
+__KERNEL_RCSID(0, "$NetBSD: db_machdep.c,v 1.15 2022/12/24 14:47:47 uwe Exp $");
#include
#include
@@ -111,7 +111,7 @@ db_nextframe(long **nextframe, long **re
struct trapframe *tf;
struct x86_64_frame *fp;
struct intrframe *ifp;
- int traptype, trapno, err, i;
+ int trapno, err, i;
db_expr_t syscallno;
switch (is_trap) {
@@ -175,9 +175,10 @@ db_nextframe(long **nextframe, long **re
* a frame can be recognized by always having
* err 0 or IREENT_MAGIC and trapno T_ASTFLT.
*/
- if (db_frame_info(*nextframe, (db_addr_t)*ip, NULL, NULL, ,
- NULL) != DB_SYM_NULL
- && traptype == INTERRUPT) {
+ int traptype = NONE;
+ db_sym_t sym = db_frame_info(*nextframe, (db_addr_t)*ip,
+ NULL, NULL, , NULL);
+ if (sym != DB_SYM_NULL && traptype == INTERRUPT) {
for (i = 0; i < 4; i++) {
ifp = (struct intrframe *)(argp + i);
err = db_get_value((long)>if_tf.tf_err,
Index: src/sys/arch/i386/i386/db_machdep.c
diff -u src/sys/arch/i386/i386/db_machdep.c:1.9 src/sys/arch/i386/i386/db_machdep.c:1.10
--- src/sys/arch/i386/i386/db_machdep.c:1.9 Sat Dec 24 14:32:42 2022
+++ src/sys/arch/i386/i386/db_machdep.c Sat Dec 24 14:47:47 2022
@@ -1,4 +1,4 @@
-/* $NetBSD: db_machdep.c,v 1.9 2022/12/24 14:32:42 uwe Exp $ */
+/* $NetBSD: db_machdep.c,v 1.10 2022/12/24 14:47:47 uwe Exp $ */
/*
* Mach Operating System
@@ -27,7 +27,7 @@
*/
#include
-__KERNEL_RCSID(0, "$NetBSD: db_machdep.c,v 1.9 2022/12/24 14:32:42 uwe Exp $");
+__KERNEL_RCSID(0, "$NetBSD: db_machdep.c,v 1.10 2022/12/24 14:47:47 uwe Exp $");
#include
#include
@@ -128,7 +128,6 @@ db_nextframe(long **nextframe, long **re
static struct trapframe tf;
static struct i386tss tss;
struct i386_frame *fp;
- int traptype;
uintptr_t ptr;
switch (is_trap) {
@@ -207,9 +206,10 @@ db_nextframe(long **nextframe, long **re
* a frame can be recognized by always having
* err 0 or IREENT_MAGIC and trapno T_ASTFLT.
*/
- if (db_frame_info(*nextframe, (db_addr_t)*ip, NULL, NULL, ,
- NULL) != DB_SYM_NULL
- && traptype == INTERRUPT) {
+ int traptype = NONE;
+ db_sym_t sym = db_frame_info(*nextframe, (db_addr_t)*ip,
+ NULL, NULL, , NULL);
+ if (sym != DB_SYM_NULL && traptype == INTERRUPT) {
struct intrframe *ifp;
int trapno;
int err;
CVS commit: src/sys/arch
Module Name:src
Committed By: uwe
Date: Sat Dec 24 14:32:42 UTC 2022
Modified Files:
src/sys/arch/amd64/amd64: db_machdep.c
src/sys/arch/i386/i386: db_machdep.c
Log Message:
{amd64,i386}/db_machdep.c: Use DB_SYM_NULL
To generate a diff of this commit:
cvs rdiff -u -r1.13 -r1.14 src/sys/arch/amd64/amd64/db_machdep.c
cvs rdiff -u -r1.8 -r1.9 src/sys/arch/i386/i386/db_machdep.c
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/sys/arch/amd64/amd64/db_machdep.c
diff -u src/sys/arch/amd64/amd64/db_machdep.c:1.13 src/sys/arch/amd64/amd64/db_machdep.c:1.14
--- src/sys/arch/amd64/amd64/db_machdep.c:1.13 Mon Jun 27 23:36:48 2022
+++ src/sys/arch/amd64/amd64/db_machdep.c Sat Dec 24 14:32:42 2022
@@ -1,4 +1,4 @@
-/* $NetBSD: db_machdep.c,v 1.13 2022/06/27 23:36:48 riastradh Exp $ */
+/* $NetBSD: db_machdep.c,v 1.14 2022/12/24 14:32:42 uwe Exp $ */
/*
* Mach Operating System
@@ -26,7 +26,7 @@
* rights to redistribute these changes.
*/
#include
-__KERNEL_RCSID(0, "$NetBSD: db_machdep.c,v 1.13 2022/06/27 23:36:48 riastradh Exp $");
+__KERNEL_RCSID(0, "$NetBSD: db_machdep.c,v 1.14 2022/12/24 14:32:42 uwe Exp $");
#include
#include
@@ -176,7 +176,7 @@ db_nextframe(long **nextframe, long **re
* err 0 or IREENT_MAGIC and trapno T_ASTFLT.
*/
if (db_frame_info(*nextframe, (db_addr_t)*ip, NULL, NULL, ,
- NULL) != (db_sym_t)0
+ NULL) != DB_SYM_NULL
&& traptype == INTERRUPT) {
for (i = 0; i < 4; i++) {
ifp = (struct intrframe *)(argp + i);
@@ -210,13 +210,13 @@ db_frame_info(long *frame, db_addr_t cal
const char *name;
sym = db_search_symbol(callpc, DB_STGY_ANY, );
- if (sym != 0 && offset == 0) {
+ if (sym != DB_SYM_NULL && offset == 0) {
sym = db_search_symbol(callpc - 1, DB_STGY_ANY, );
offset++;
}
db_symbol_values(sym, , NULL);
- if (sym == (db_sym_t)0)
- return (db_sym_t)0;
+ if (sym == DB_SYM_NULL)
+ return DB_SYM_NULL;
*is_trap = NONE;
narg = 0;
Index: src/sys/arch/i386/i386/db_machdep.c
diff -u src/sys/arch/i386/i386/db_machdep.c:1.8 src/sys/arch/i386/i386/db_machdep.c:1.9
--- src/sys/arch/i386/i386/db_machdep.c:1.8 Mon Dec 13 01:25:29 2021
+++ src/sys/arch/i386/i386/db_machdep.c Sat Dec 24 14:32:42 2022
@@ -1,4 +1,4 @@
-/* $NetBSD: db_machdep.c,v 1.8 2021/12/13 01:25:29 chs Exp $ */
+/* $NetBSD: db_machdep.c,v 1.9 2022/12/24 14:32:42 uwe Exp $ */
/*
* Mach Operating System
@@ -27,7 +27,7 @@
*/
#include
-__KERNEL_RCSID(0, "$NetBSD: db_machdep.c,v 1.8 2021/12/13 01:25:29 chs Exp $");
+__KERNEL_RCSID(0, "$NetBSD: db_machdep.c,v 1.9 2022/12/24 14:32:42 uwe Exp $");
#include
#include
@@ -208,7 +208,7 @@ db_nextframe(long **nextframe, long **re
* err 0 or IREENT_MAGIC and trapno T_ASTFLT.
*/
if (db_frame_info(*nextframe, (db_addr_t)*ip, NULL, NULL, ,
- NULL) != (db_sym_t)0
+ NULL) != DB_SYM_NULL
&& traptype == INTERRUPT) {
struct intrframe *ifp;
int trapno;
@@ -255,13 +255,13 @@ db_frame_info(long *frame, db_addr_t cal
const char *name;
sym = db_search_symbol(callpc, DB_STGY_ANY, );
- if (sym != 0 && offset == 0) {
+ if (sym != DB_SYM_NULL && offset == 0) {
sym = db_search_symbol(callpc - 1, DB_STGY_ANY, );
offset++;
}
db_symbol_values(sym, , NULL);
- if (sym == (db_sym_t)0)
- return (db_sym_t)0;
+ if (sym == DB_SYM_NULL)
+ return DB_SYM_NULL;
*is_trap = NONE;
narg = MAXNARG;
CVS commit: src/sys/arch
Module Name:src
Committed By: uwe
Date: Sat Dec 24 14:32:42 UTC 2022
Modified Files:
src/sys/arch/amd64/amd64: db_machdep.c
src/sys/arch/i386/i386: db_machdep.c
Log Message:
{amd64,i386}/db_machdep.c: Use DB_SYM_NULL
To generate a diff of this commit:
cvs rdiff -u -r1.13 -r1.14 src/sys/arch/amd64/amd64/db_machdep.c
cvs rdiff -u -r1.8 -r1.9 src/sys/arch/i386/i386/db_machdep.c
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
CVS commit: src/sys/arch/x86/x86
Module Name:src Committed By: uwe Date: Sat Dec 24 14:14:52 UTC 2022 Modified Files: src/sys/arch/x86/x86: db_trace.c Log Message: db_trace.c: Use DB_SYM_NULL instead of respelling it To generate a diff of this commit: cvs rdiff -u -r1.5 -r1.6 src/sys/arch/x86/x86/db_trace.c Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/sys/arch/x86/x86
Module Name:src
Committed By: uwe
Date: Sat Dec 24 14:14:52 UTC 2022
Modified Files:
src/sys/arch/x86/x86: db_trace.c
Log Message:
db_trace.c: Use DB_SYM_NULL instead of respelling it
To generate a diff of this commit:
cvs rdiff -u -r1.5 -r1.6 src/sys/arch/x86/x86/db_trace.c
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/sys/arch/x86/x86/db_trace.c
diff -u src/sys/arch/x86/x86/db_trace.c:1.5 src/sys/arch/x86/x86/db_trace.c:1.6
--- src/sys/arch/x86/x86/db_trace.c:1.5 Sat Dec 24 02:31:43 2022
+++ src/sys/arch/x86/x86/db_trace.c Sat Dec 24 14:14:52 2022
@@ -1,4 +1,4 @@
-/* $NetBSD: db_trace.c,v 1.5 2022/12/24 02:31:43 uwe Exp $ */
+/* $NetBSD: db_trace.c,v 1.6 2022/12/24 14:14:52 uwe Exp $ */
/*
* Mach Operating System
@@ -27,7 +27,7 @@
*/
#include
-__KERNEL_RCSID(0, "$NetBSD: db_trace.c,v 1.5 2022/12/24 02:31:43 uwe Exp $");
+__KERNEL_RCSID(0, "$NetBSD: db_trace.c,v 1.6 2022/12/24 14:14:52 uwe Exp $");
#include
#include
@@ -205,7 +205,7 @@ db_stack_trace_print(db_expr_t addr, boo
sym = db_frame_info(frame, callpc, , , _trap,
);
- if (lastframe == NULL && sym == (db_sym_t)0 && callpc != 0) {
+ if (lastframe == NULL && sym == DB_SYM_NULL && callpc != 0) {
/* Symbol not found, peek at code */
u_long instr = db_get_value(callpc, 4, false);
CVS commit: src/sys/arch/x86/x86
Module Name:src Committed By: uwe Date: Sat Dec 24 02:31:43 UTC 2022 Modified Files: src/sys/arch/x86/x86: db_trace.c Log Message: db_trace.c: Make parens balanced across #ifdef Same object code is generated on both i386 and amd64. To generate a diff of this commit: cvs rdiff -u -r1.4 -r1.5 src/sys/arch/x86/x86/db_trace.c Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/sys/arch/x86/x86
Module Name:src
Committed By: uwe
Date: Sat Dec 24 02:31:43 UTC 2022
Modified Files:
src/sys/arch/x86/x86: db_trace.c
Log Message:
db_trace.c: Make parens balanced across #ifdef
Same object code is generated on both i386 and amd64.
To generate a diff of this commit:
cvs rdiff -u -r1.4 -r1.5 src/sys/arch/x86/x86/db_trace.c
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/sys/arch/x86/x86/db_trace.c
diff -u src/sys/arch/x86/x86/db_trace.c:1.4 src/sys/arch/x86/x86/db_trace.c:1.5
--- src/sys/arch/x86/x86/db_trace.c:1.4 Sun Feb 11 08:27:18 2018
+++ src/sys/arch/x86/x86/db_trace.c Sat Dec 24 02:31:43 2022
@@ -1,4 +1,4 @@
-/* $NetBSD: db_trace.c,v 1.4 2018/02/11 08:27:18 maxv Exp $ */
+/* $NetBSD: db_trace.c,v 1.5 2022/12/24 02:31:43 uwe Exp $ */
/*
* Mach Operating System
@@ -27,7 +27,7 @@
*/
#include
-__KERNEL_RCSID(0, "$NetBSD: db_trace.c,v 1.4 2018/02/11 08:27:18 maxv Exp $");
+__KERNEL_RCSID(0, "$NetBSD: db_trace.c,v 1.5 2022/12/24 02:31:43 uwe Exp $");
#include
#include
@@ -212,16 +212,17 @@ db_stack_trace_print(db_expr_t addr, boo
offset = 1;
if (
#ifdef __x86_64__
- instr == 0xe5894855 ||
+ (instr == 0xe5894855 ||
/* enter: pushq %rbp, movq %rsp, %rbp */
(instr & 0x00ff) == 0x0048e589
/* enter+1: movq %rsp, %rbp */)
#else
- (instr & 0x00ff) == 0x00e58955 ||
+ ((instr & 0x00ff) == 0x00e58955 ||
/* enter: pushl %ebp, movl %esp, %ebp */
(instr & 0x) == 0xe589
/* enter+1: movl %esp, %ebp */)
#endif
+ )
{
offset = 0;
}
CVS commit: src/bin/sh
Module Name:src Committed By: uwe Date: Tue Dec 20 01:18:42 UTC 2022 Modified Files: src/bin/sh: sh.1 Log Message: sh(1): Fix markup. -compact must be last. To generate a diff of this commit: cvs rdiff -u -r1.252 -r1.253 src/bin/sh/sh.1 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/bin/sh/sh.1 diff -u src/bin/sh/sh.1:1.252 src/bin/sh/sh.1:1.253 --- src/bin/sh/sh.1:1.252 Sun Dec 11 08:23:10 2022 +++ src/bin/sh/sh.1 Tue Dec 20 01:18:42 2022 @@ -1,4 +1,4 @@ -.\" $NetBSD: sh.1,v 1.252 2022/12/11 08:23:10 kre Exp $ +.\" $NetBSD: sh.1,v 1.253 2022/12/20 01:18:42 uwe Exp $ .\" Copyright (c) 1991, 1993 .\" The Regents of the University of California. All rights reserved. .\" @@ -2767,7 +2767,7 @@ before the command is invoked. With the default value for .Dv IFS : -.Bd -unfilled -compact -offset indent +.Bd -unfilled -offset indent -compact X='a b c' export Y=$X .Ed @@ -4752,7 +4752,7 @@ in the circumstances described. Any present will always appear in ASCII lexical order, as they appear below (to make testing the value easier to code). .Pp -.Bl -compact -tag -width M__ -offset indent +.Bl -tag -width M__ -offset indent -compact .It \&! Always present when set by .Nm ,
CVS commit: src/bin/sh
Module Name:src Committed By: uwe Date: Tue Dec 20 01:18:42 UTC 2022 Modified Files: src/bin/sh: sh.1 Log Message: sh(1): Fix markup. -compact must be last. To generate a diff of this commit: cvs rdiff -u -r1.252 -r1.253 src/bin/sh/sh.1 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/share/man/man9
Module Name:src Committed By: uwe Date: Mon Dec 19 00:41:45 UTC 2022 Modified Files: src/share/man/man9: mutex.9 Log Message: mutex(9): Minor formatting fixes While here, move the reference to options(4) to the OPTIONS section. To generate a diff of this commit: cvs rdiff -u -r1.33 -r1.34 src/share/man/man9/mutex.9 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man9/mutex.9 diff -u src/share/man/man9/mutex.9:1.33 src/share/man/man9/mutex.9:1.34 --- src/share/man/man9/mutex.9:1.33 Sun Dec 18 23:38:42 2022 +++ src/share/man/man9/mutex.9 Mon Dec 19 00:41:45 2022 @@ -1,4 +1,4 @@ -.\" $NetBSD: mutex.9,v 1.33 2022/12/18 23:38:42 gutteridge Exp $ +.\" $NetBSD: mutex.9,v 1.34 2022/12/19 00:41:45 uwe Exp $ .\" .\" Copyright (c) 2007, 2009 The NetBSD Foundation, Inc. .\" All rights reserved. @@ -67,7 +67,8 @@ .Cd "options LOCKDEBUG" .Sh DESCRIPTION Mutexes are used in the kernel to implement mutual exclusion among LWPs -(lightweight processes) and interrupt handlers. +.Pq lightweight processes +and interrupt handlers. .Pp The .Vt kmutex_t @@ -80,23 +81,21 @@ Mutexes replace the system traditionally used to provide synchronization between interrupt handlers and LWPs. .Sh OPTIONS -.Bl -tag -width abcd +The following kernel options have effect on mutex operations: +.Bl -tag -width Cd .It Cd "options DIAGNOSTIC" -.Pp Kernels compiled with the .Dv DIAGNOSTIC option perform basic sanity checks on mutex operations. .It Cd "options LOCKDEBUG" -.Pp Kernels compiled with the .Dv LOCKDEBUG option perform potentially CPU intensive sanity checks on mutex operations. .El .Sh FUNCTIONS -.Bl -tag -width abcd +.Bl -tag -width Ds .It Fn mutex_init "mtx" "type" "ipl" -.Pp Dynamically initialize a mutex for use. .Pp No other operations can be performed on a mutex until it has been initialized. @@ -115,9 +114,8 @@ an endorsed, stable part of the interfac The type of mutex returned depends on the .Fa ipl argument: -.Bl -tag -width abcd -.It IPL_NONE, or one of the IPL_SOFT* constants -.Pp +.Bl -tag -width Dv +.It Dv IPL_NONE , No or one of the Dv IPL_SOFT* No constants An adaptive mutex will be returned. Adaptive mutexes provide mutual exclusion between LWPs, and between LWPs and soft interrupt handlers. @@ -125,8 +123,7 @@ and between LWPs and soft interrupt hand Adaptive mutexes cannot be acquired from a hardware interrupt handler. An LWP may either sleep or busy-wait when attempting to acquire an adaptive mutex that is already held. -.It IPL_VM, IPL_SCHED, IPL_HIGH -.Pp +.It Dv IPL_VM , IPL_SCHED , IPL_HIGH A spin mutex will be returned. Spin mutexes provide mutual exclusion between LWPs, and between LWPs and interrupt handlers. @@ -160,13 +157,11 @@ See .Xr spl 9 for further information on interrupt priority levels (IPLs). .It Fn mutex_destroy "mtx" -.Pp Release resources used by a mutex. The mutex may not be used after it has been destroyed. .Fn mutex_destroy may block in order to free memory. .It Fn mutex_enter "mtx" -.Pp Acquire a mutex. If the mutex is already held, the caller will block and not return until the mutex is acquired. @@ -194,7 +189,6 @@ the level set in .Fn mutex_init if it is not already equal or higher. .It Fn mutex_exit "mtx" -.Pp Release a mutex. The mutex must have been previously acquired by the caller. Mutexes may be released out of order as needed. @@ -210,17 +204,16 @@ to acquire the mutex even on another CPU Thus, there is a global total ordering on all loads and stores under the same mutex. .It Fn mutex_ownable "mtx" -.Pp When compiled with .Dv LOCKDEBUG -(see -.Xr options 4 ) , ensure that the current process can successfully acquire .Ar mtx . If .Ar mtx is already owned by the current process, the system will panic -with a "locking against myself" error. +with a +.Dq locking against myself\^ +error. .Pp This function is needed because .Fn mutex_owned @@ -230,7 +223,6 @@ vs owned by another process. is reasonably heavy-weight, and should only be used with .Xr KDASSERT 9 . .It Fn mutex_owned "mtx" -.Pp For adaptive mutexes, return non-zero if the current LWP holds the mutex. For spin mutexes, return non-zero if the mutex is held, potentially by the current processor. @@ -239,14 +231,11 @@ Otherwise, return zero. .Fn mutex_owned is provided for making diagnostic checks to verify that a lock is held. For example: -.Bd -literal - KASSERT(mutex_owned(_lock)); -.Ed +.Dl KASSERT(mutex_owned(_lock)); .Pp It should not be used to make locking decisions at run time. For spin mutexes, it must not be used to verify that a lock is not held. .It Fn mutex_spin_enter "mtx" -.Pp Equivalent to .Fn mutex_enter , but may only be used when it is known that @@ -257,7 +246,6 @@ Implies the same memory ordering as On some architectures, this can substantially reduce the cost of acquiring a spin mutex. .It Fn
CVS commit: src/share/man/man9
Module Name:src Committed By: uwe Date: Mon Dec 19 00:41:45 UTC 2022 Modified Files: src/share/man/man9: mutex.9 Log Message: mutex(9): Minor formatting fixes While here, move the reference to options(4) to the OPTIONS section. To generate a diff of this commit: cvs rdiff -u -r1.33 -r1.34 src/share/man/man9/mutex.9 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/share/man/man4
Module Name:src
Committed By: uwe
Date: Tue Dec 6 15:06:40 UTC 2022
Modified Files:
src/share/man/man4: unix.4
Log Message:
unix(4): Fix/add markup
Untabify examples, .Bd -literal -offset indent doesn't seem to mesh
with tabs nicely in the PostScript output. The indent is probably not
a multiple a of literal tab width. This causes a small vertical
misalignment for tab-indented lines, but what's worse - it can cause
an extra tab in some cases (and did here for the unpcbid definition).
To generate a diff of this commit:
cvs rdiff -u -r1.29 -r1.30 src/share/man/man4/unix.4
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/share/man/man4/unix.4
diff -u src/share/man/man4/unix.4:1.29 src/share/man/man4/unix.4:1.30
--- src/share/man/man4/unix.4:1.29 Sun Aug 28 10:48:16 2022
+++ src/share/man/man4/unix.4 Tue Dec 6 15:06:40 2022
@@ -1,4 +1,4 @@
-.\" $NetBSD: unix.4,v 1.29 2022/08/28 10:48:16 hgutch Exp $
+.\" $NetBSD: unix.4,v 1.30 2022/12/06 15:06:40 uwe Exp $
.\"
.\" Copyright (c) 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@@ -64,9 +64,9 @@ The include file
defines this address:
.Bd -literal -offset indent
struct sockaddr_un {
- u_char sun_len;
- u_char sun_family;
- char sun_path[104];
+u_char sun_len;
+u_char sun_family;
+charsun_path[104];
};
.Ed
.Pp
@@ -92,7 +92,7 @@ can be calculated by the macro
defined in
.In sys/un.h .
The
-.Ar sun_path
+.Fa sun_path
field must be terminated by a NUL character to be used with
.Fn SUN_LEN ,
but the terminating NUL is
@@ -101,7 +101,7 @@ part of the address.
The
.Nx
kernel ignores any user-set value in the
-.Va sun_len
+.Fa sun_len
member of the structure.
.Pp
The
@@ -137,9 +137,9 @@ and
sockets also support the communication of
.Ux
file descriptors through the use of the
-.Ar msg_control
+.Fa msg_control
field in the
-.Ar msg
+.Fa msg
argument to
.Xr sendmsg 2
and
@@ -147,7 +147,7 @@ and
.Pp
Any valid descriptor may be sent in a message.
The file descriptor(s) to be passed are described using a
-.Ar struct cmsghdr
+.Vt struct cmsghdr
that is defined in the include file
.In sys/socket.h .
The type of the message is
@@ -172,7 +172,9 @@ Descriptors that are awaiting delivery,
purposely not received, are automatically closed by the system
when the destination socket is closed.
.Pp
-A UNIX-domain socket supports several
+A
+.Ux Ns -domain
+socket supports several
.Dv SOL_LOCAL
level options for use with
.Xr setsockopt 2
@@ -191,20 +193,28 @@ This option provides a mechanism for the
receive the credentials of the process as a
.Xr recvmsg 2
control message.
-The msg_control field in the msghdr structure points
-to a buffer that contains a cmsghdr structure followed by a variable
-length sockcred structure, defined in
+The
+.Fa msg_control
+field in the
+.Vt msghdr
+structure points
+to a buffer that contains a
+.Vt cmsghdr
+structure followed by a variable
+length
+.Vt sockcred
+structure, defined in
.In sys/socket.h
as follows:
-.Bd -literal
+.Bd -literal -offset indent
struct sockcred {
- pid_t sc_pid; /* process id */
- uid_t sc_uid; /* real user id */
- uid_t sc_euid; /* effective user id */
- gid_t sc_gid; /* real group id */
- gid_t sc_egid; /* effective group id */
- int sc_ngroups; /* number of supplemental groups */
- gid_t sc_groups[1]; /* variable length */
+pid_t sc_pid; /* process id */
+uid_t sc_uid; /* real user id */
+uid_t sc_euid;/* effective user id */
+gid_t sc_gid; /* real group id */
+gid_t sc_egid;/* effective group id */
+int sc_ngroups; /* number of supplemental groups */
+gid_t sc_groups[1]; /* variable length */
};
.Ed
.Pp
@@ -221,22 +231,26 @@ peer when it did
or
.Xr bind 2 .
The returned structure is
-.Bd -literal
+.Bd -literal -offset indent
struct unpcbid {
- pid_t unp_pid; /* process id */
- uid_t unp_euid; /* effective user id */
- gid_t unp_egid; /* effective group id */
+pid_t unp_pid; /* process id */
+uid_t unp_euid; /* effective user id */
+gid_t unp_egid; /* effective group id */
};
.Ed
+.Pp
as defined in
.In sys/un.h .
.Pp
The
.Fn SOCKCREDSIZE
-macro computes the size of the sockcred structure for a specified number
-of groups.
-The cmsghdr fields have the following values:
-.Bd -literal
+macro computes the size of the
+.Vt sockcred
+structure for a specified number of groups.
+The
+.Vt cmsghdr
+fields have the following values:
+.Bd -literal -offset indent
cmsg_len = CMSG_LEN(SOCKCREDSIZE(ngroups))
cmsg_level = SOL_SOCKET
cmsg_type = SCM_CREDS
@@ -251,17 +265,16 @@ int ret;
memset(, 0, sizeof(addr));
addr.sun_family = AF_LOCAL;
if (strlen(pathname) >= sizeof(addr.sun_path))
- goto too_long;
+
CVS commit: src/share/man/man4
Module Name:src Committed By: uwe Date: Tue Dec 6 15:06:40 UTC 2022 Modified Files: src/share/man/man4: unix.4 Log Message: unix(4): Fix/add markup Untabify examples, .Bd -literal -offset indent doesn't seem to mesh with tabs nicely in the PostScript output. The indent is probably not a multiple a of literal tab width. This causes a small vertical misalignment for tab-indented lines, but what's worse - it can cause an extra tab in some cases (and did here for the unpcbid definition). To generate a diff of this commit: cvs rdiff -u -r1.29 -r1.30 src/share/man/man4/unix.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/lib/libedit
Module Name:src Committed By: uwe Date: Tue Dec 6 00:59:20 UTC 2022 Modified Files: src/lib/libedit: editrc.5 Log Message: editrc(5): Markup fixes To generate a diff of this commit: cvs rdiff -u -r1.33 -r1.34 src/lib/libedit/editrc.5 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/lib/libedit/editrc.5 diff -u src/lib/libedit/editrc.5:1.33 src/lib/libedit/editrc.5:1.34 --- src/lib/libedit/editrc.5:1.33 Tue Jun 27 01:22:58 2017 +++ src/lib/libedit/editrc.5 Tue Dec 6 00:59:20 2022 @@ -1,4 +1,4 @@ -.\" $NetBSD: editrc.5,v 1.33 2017/06/27 01:22:58 kre Exp $ +.\" $NetBSD: editrc.5,v 1.34 2022/12/06 00:59:20 uwe Exp $ .\" .\" Copyright (c) 1997-2000 The NetBSD Foundation, Inc. .\" All rights reserved. @@ -43,7 +43,7 @@ library. .Pp The format of each line is: .Pp -.Dl [prog:]command [arg ...] +.D1 Oo Ar prog Ns Ic \&: Oc Ns Ar command Oo Ar arg ... Oc .Pp .Ar command is one of the @@ -59,7 +59,7 @@ is the program name string that a progra to set up .Xr editline 3 , which is usually -.Va argv[0] . +.Va argv Ns Li [0] . .Ar command will be executed for any program which matches .Ar prog . @@ -107,15 +107,17 @@ List or change key bindings in the .Xr vi 1 mode alternate (command mode) key map. .It Fl e -Bind all keys to the standard GNU Emacs-like bindings. +Bind all keys to the standard +.Tn GNU +Emacs-like bindings. .It Fl k .Ar key is interpreted as a symbolic arrow key name, which may be one of -.Sq up , -.Sq down , -.Sq left +.Ic up , +.Ic down , +.Ic left or -.Sq right . +.Ic right . .It Fl l List all editor commands and a short description of each. .It Fl r @@ -146,16 +148,14 @@ about macros and the input queue. and .Ar command can contain control characters of the form -.Sm off -.Sq No ^ Ar character -.Sm on +.Sq Ic ^ Ns Ar character .Po e.g.\& -.Sq ^A +.Ql ^A .Pc , and the following backslashed escape sequences: .Pp -.Bl -tag -compact -offset indent -width 4n +.Bl -tag -compact -offset indent -width Ic .It Ic \ea Bell .It Ic \eb @@ -173,31 +173,33 @@ Horizontal tab .It Ic \ev Vertical tab .Sm off -.It Sy \e Ar nnn +.It Ic \e Ar nnn .Sm on -The ASCII character corresponding to the octal number +The +.Tn ASCII +character corresponding to the octal number .Ar nnn . .El .Pp -.Sq \e +.Ql \e nullifies the special meaning of the following character, if it has any, notably -.Sq \e +.Ql \e and -.Sq ^ . +.Ql ^ . .It Ic echotc Oo Fl sv Oc Ar arg Ar ... Exercise terminal capabilities given in -.Ar arg ... . +.Ar arg . If .Ar arg is -.Sq baud , -.Sq cols , -.Sq lines , -.Sq rows , -.Sq meta , +.Ql baud , +.Ql cols , +.Ql lines , +.Ql rows , +.Ql meta , or -.Sq tabs , +.Ql tabs , the value of that capability is printed, with .Dq yes or @@ -209,27 +211,27 @@ returns an empty string for non-existent causing an error. .Fl v causes messages to be verbose. -.It Ic edit Op Li on | Li off +.It Ic edit Op Li on No | Li off Enable or disable the .Nm editline functionality in a program. -.It Ic history Ar list | Ar size Dv n | Ar unique Dv n +.It Ic history Li list No | Li size Ar n No | Li unique Ar n The -.Ar list +.Ql list command lists all entries in the history. The -.Ar size +.Ql size command sets the history size to -.Dv n +.Ar n entries. The -.Ar unique +.Ql unique command controls if history should keep duplicate entries. If -.Dv n +.Ar n is non zero, only keep unique history entries. If -.Dv n +.Ar n is zero, then keep all entries (the default). .It Ic settc Ar cap Ar val Set the terminal capability @@ -239,8 +241,8 @@ to as defined in .Xr termcap 5 . No sanity checking is done. -.It Ic setty Oo Fl a Oc Oo Fl d Oc Oo Fl q Oc Oo Fl x Oc Oo Ar +mode Oc \ -Oo Ar -mode Oc Oo Ar mode Oc Oo Ar char=c Oc +.It Ic setty Oo Fl a Oc Oo Fl d Oc Oo Fl q Oc Oo Fl x Oc Oo Ic \&+ Ns Ar mode Oc \ +Oo Fl Ar mode Oc Oo Ar mode Oc Oo Ar char\| Ns Ic = Ns Ar c Oc Control which tty modes that .Nm won't allow the user to change. @@ -262,17 +264,17 @@ Without other arguments, .Ic setty lists the modes in the chosen set which are fixed on .Po -.Sq +mode +.Ic + Ns Ar mode .Pc or off .Po -.Sq -mode +.Fl Ns Ar mode .Pc . .Fl a lists all tty modes in the chosen set regardless of the setting. With -.Ar +mode , -.Ar -mode +.Ic + Ns Ar mode , +.Fl Ns Ar mode or .Ar mode , fixes @@ -283,7 +285,7 @@ in the chosen set. .Pp .Ic Setty can also be used to set tty characters to particular values using -.Ar char=value . +.Ar char\| Ns Ic = Ns Ar value . If .Ar value is empty @@ -294,19 +296,18 @@ List the values of all the terminal capa .Xr termcap 5 ) . .El .Sh ENVIRONMENT -.Bl -tag -width "~/.editrcXXX" +.Bl -tag -width Ev .It Ev EDITRC Names the default configuration file for the .Xr editline 3 library. .El .Sh FILES -.Bl -tag -width "~/.editrcXXX" +.Bl -tag -width Pa .It Pa ~/.editrc -Last resort, if no other file is specified,
CVS commit: src/lib/libedit
Module Name:src Committed By: uwe Date: Tue Dec 6 00:59:20 UTC 2022 Modified Files: src/lib/libedit: editrc.5 Log Message: editrc(5): Markup fixes To generate a diff of this commit: cvs rdiff -u -r1.33 -r1.34 src/lib/libedit/editrc.5 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/lib/libc/gen
Module Name:src Committed By: uwe Date: Tue Dec 6 00:13:17 UTC 2022 Modified Files: src/lib/libc/gen: getbsize.3 Log Message: getbsize(3): Use .Ev for BLOCKSIZE To generate a diff of this commit: cvs rdiff -u -r1.9 -r1.10 src/lib/libc/gen/getbsize.3 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/lib/libc/gen/getbsize.3 diff -u src/lib/libc/gen/getbsize.3:1.9 src/lib/libc/gen/getbsize.3:1.10 --- src/lib/libc/gen/getbsize.3:1.9 Thu Aug 7 16:42:48 2003 +++ src/lib/libc/gen/getbsize.3 Tue Dec 6 00:13:17 2022 @@ -1,4 +1,4 @@ -.\" $NetBSD: getbsize.3,v 1.9 2003/08/07 16:42:48 agc Exp $ +.\" $NetBSD: getbsize.3,v 1.10 2022/12/06 00:13:17 uwe Exp $ .\" .\" Copyright (c) 1993 .\" The Regents of the University of California. All rights reserved. @@ -45,7 +45,7 @@ The .Nm getbsize function determines the user's preferred block size based on the value of the -.Dq BLOCKSIZE +.Ev BLOCKSIZE environment variable; see .Xr environ 7 for details on its use and format.
CVS commit: src/lib/libc/gen
Module Name:src Committed By: uwe Date: Tue Dec 6 00:13:17 UTC 2022 Modified Files: src/lib/libc/gen: getbsize.3 Log Message: getbsize(3): Use .Ev for BLOCKSIZE To generate a diff of this commit: cvs rdiff -u -r1.9 -r1.10 src/lib/libc/gen/getbsize.3 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
