CVS commit: src/share/man/man4
Module Name:src Committed By: uwe Date: Wed May 22 00:25:56 UTC 2024 Modified Files: src/share/man/man4: uaudio.4 Log Message: uaudio.4: improve markup To generate a diff of this commit: cvs rdiff -u -r1.30 -r1.31 src/share/man/man4/uaudio.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/uaudio.4 diff -u src/share/man/man4/uaudio.4:1.30 src/share/man/man4/uaudio.4:1.31 --- src/share/man/man4/uaudio.4:1.30 Tue May 21 10:45:39 2024 +++ src/share/man/man4/uaudio.4 Wed May 22 00:25:56 2024 @@ -1,4 +1,4 @@ -.\" $NetBSD: uaudio.4,v 1.30 2024/05/21 10:45:39 nia Exp $ +.\" $NetBSD: uaudio.4,v 1.31 2024/05/22 00:25:56 uwe Exp $ .\" .\" Copyright (c) 1999-2024 The NetBSD Foundation, Inc. .\" All rights reserved. @@ -46,46 +46,63 @@ audio class devices. A .Tn USB audio device consists of a number of components: -input terminals (e.g. USB digital input), output terminals (e.g. -speakers), and a number of units in between (e.g. volume control). +input terminals +.Pq e.g. USB digital input , +output terminals +.Pq e.g. speakers , +and a number of units in between +.Pq e.g. volume control . The following types of units are handled by the .Nm -driver and are accessible via the mixer (see -.Xr audio 4 ) +driver and are accessible via the mixer +.Pq see Xr audio 4 interface: -.Bl -tag -width Dv -offset 3n -compact -.It mixer +.Bl -tag -width Em +.It Em mixer A mixer has a number of inputs and one output. Each input has a control that determines its volume in the output. The name of the control is -.Ar mixN-S , +.Sm off +.Li mix Ar N Li \|- Ar S , +.Sm on where .Ar N is a number that identifies which mixer it is and .Ar S which input. -.It selector +. +.It Em selector A selector unit selects one of multiple audio sources such as mic-in and line-in. The name of the control is -.Ar selN-S1S2S3... , +.Sm off +.Li sel Ar N Li \|- Ar S1S2S3... , +.Sm on where .Ar N is a number that identifies which selector unit it is and the sequence of .Ar Sn indicates candidate units for the audio source. -.It feature +. +.It Em feature A feature unit changes the sound in some way, like bass, treble, mute, or volume. The name of the control is determined in a heuristic way. If the unit changes the sound to a speaker output terminal, -the names of the controls may be outputs.speaker.bass, outputs.speaker.treble, -outputs.speaker.mute, outputs.speaker, or likewise. -.It processing +the names of the controls may be +.Li outputs.speaker.bass , +.Li outputs.speaker.treble , +.Li outputs.speaker.mute , +.Li outputs.speaker , +or likewise. +. +.It Em processing A processing unit does one of a number of audio processing functions -(e.g., channel up-down mixing, Dolby ProLogic, or chorus effects). -The name of the on-off control is -.Ar proN.M-enable , +.Pq e.g., channel up-down mixing, Dolby ProLogic, or chorus effects . +The name of the on\[en]off control is +.Sm off +.Li pro Ar N Li \&. Ar M Li \|-enable , +.Sm on where .Ar N is a number that identifies which processing unit it is and @@ -93,10 +110,13 @@ is a number that identifies which proces which kind. Depending on the type of processing unit there may be other controls as well. -.It extension +. +.It Em extension An extension unit performs some unspecified audio processing -The name of the on-off control is -.Ar extN-enable , +The name of the on\[en]off control is +.Sm off +.Li ext Ar N Li \|-enable , +.Sm on where .Ar N is a number that identifies which processing unit it is.
CVS commit: src/share/man/man4
Module Name:src Committed By: uwe Date: Wed May 22 00:25:56 UTC 2024 Modified Files: src/share/man/man4: uaudio.4 Log Message: uaudio.4: improve markup To generate a diff of this commit: cvs rdiff -u -r1.30 -r1.31 src/share/man/man4/uaudio.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/usr.bin/mkubootimage
Module Name:src Committed By: uwe Date: Wed May 22 00:02:47 UTC 2024 Modified Files: src/usr.bin/mkubootimage: mkubootimage.1 Log Message: mkubootimage.1: improve markup To generate a diff of this commit: cvs rdiff -u -r1.19 -r1.20 src/usr.bin/mkubootimage/mkubootimage.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/mkubootimage
Module Name:src Committed By: uwe Date: Wed May 22 00:02:47 UTC 2024 Modified Files: src/usr.bin/mkubootimage: mkubootimage.1 Log Message: mkubootimage.1: improve markup To generate a diff of this commit: cvs rdiff -u -r1.19 -r1.20 src/usr.bin/mkubootimage/mkubootimage.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/mkubootimage/mkubootimage.1 diff -u src/usr.bin/mkubootimage/mkubootimage.1:1.19 src/usr.bin/mkubootimage/mkubootimage.1:1.20 --- src/usr.bin/mkubootimage/mkubootimage.1:1.19 Tue May 21 23:31:21 2024 +++ src/usr.bin/mkubootimage/mkubootimage.1 Wed May 22 00:02:46 2024 @@ -1,4 +1,4 @@ -.\" $NetBSD: mkubootimage.1,v 1.19 2024/05/21 23:31:21 uwe Exp $ +.\" $NetBSD: mkubootimage.1,v 1.20 2024/05/22 00:02:46 uwe Exp $ .\" .\" Copyright (c) 2012 The NetBSD Foundation, Inc. .\" All rights reserved. @@ -35,18 +35,65 @@ .Nd create U-Boot loader image .Sh SYNOPSIS .Nm +. .Op Fl hu -.Fl A No ( arm Ns | Ns arm64 Ns | Ns i386 Ns | Ns mips Ns | Ns mips64 Ns | Ns or1k Ns | Ns powerpc Ns | Ns riscv Ns | Ns sh ) +. +.Fl A Po Xo +.Li arm Ns \||\| Ns +.Li arm64 Ns \||\| Ns +.Li i386Ns \||\| Ns +.Li mipsNs \||\| Ns +.Li mips64 Ns \||\| Ns +.Li or1kNs \||\| Ns +.Li powerpc Ns \||\| Ns +.Li riscv Ns \||\| Ns +.Li sh +.Xc Pc +. +.br .Fl a Ar address -.Op Fl C Po bz2 Ns | Ns gz Ns | Ns lzma Ns | Ns lzo Ns | Ns none Pc +. +.Oo Fl C Po Xo +.Li bz2 Ns \||\| Ns +.Li gz Ns \||\| Ns +.Li lzma Ns \||\| Ns +.Li lzo Ns \||\| Ns +.Li none +.Xc Pc Oc +. .Op Fl E Ar address +. .Op Fl e Ar address -.Op Fl f Po arm64 Ns | Ns uimg Pc +. +.Oo Fl f Po Xo +.Li arm64 Ns \||\| Ns +.Li uimg +.Xc Pc Oc +. .Op Fl m Ar magic -.Fl n Ar image -.Op Fl O Po freebsd Ns | Ns linux Ns | Ns netbsd Ns | Ns openbsd Pc -.Fl T No ( fs Ns | Ns kernel Ns | Ns kernel_noload Ns | Ns ramdisk Ns | Ns script Ns | Ns standalone ) +. +.Fl n Ar name +. +.br +.Oo Fl O Po Xo +.Li freebsd Ns \||\| Ns +.Li linux Ns \||\| Ns +.Li netbsd Ns \||\| Ns +.Li openbsd +.Xc Pc Oc +. +.br +.Fl T Po Xo +.Li fsNs \||\| Ns +.Li kernelNs \||\| Ns +.Li kernel_noload Ns \||\| Ns +.Li ramdisk Ns \||\| Ns +.Li scriptNs \||\| Ns +.Li standalone +.Xc Pc +. .Op Fl t Ar epoch +. .Ar source destination .\" .Sh DESCRIPTION @@ -56,23 +103,46 @@ utility is used to create an image for D .Qq Universal Boot Loader . .Pp The arguments are as follows: -.Bl -tag -width indent -.It Fl A No ( arm Ns | Ns arm64 Ns | Ns i386 Ns | Ns mips Ns | Ns mips64 Ns | Ns or1k Ns | Ns powerpc Ns | Ns riscv Ns | Ns sh ) +.Bl -tag -width Fl +. +.It Fl A Po Xo +.Li arm Ns \||\| Ns +.Li arm64 Ns \||\| Ns +.Li i386Ns \||\| Ns +.Li mipsNs \||\| Ns +.Li mips64 Ns \||\| Ns +.Li or1kNs \||\| Ns +.Li powerpc Ns \||\| Ns +.Li riscv Ns \||\| Ns +.Li sh +.Xc Pc Defines the architecture. This is required for -.Qq uimg +.Ql uimg format images. +. .It Fl a Ar address Sets the image load address. This is an integer between 0 and .Dv UINT32_MAX . This is required for all -.Qq uimg -image types except for script, ramdisk, and kernel_noload. -.It Fl C No ( bz2 Ns | Ns gz Ns | Ns lzma Ns | Ns lzo Ns | Ns none ) +.Ql uimg +image types except for +.Li script , ramdisk , +and +.Li kernel_noload . +. +.It Fl C Po Xo +.Li bz2 Ns \||\| Ns +.Li gz Ns \||\| Ns +.Li lzma Ns \||\| Ns +.Li lzo Ns \||\| Ns +.Li none +.Xc Pc Defines the compression. The default is -.Qq none . +.Ql none . +. .It Fl E Ar address Define the entry point. This is an integer between 0 and @@ -88,6 +158,7 @@ or are not set, the entry point defaults to the image load address .Pq Fl a . +. .It Fl e Ar address Define the entry point. This is an integer between 0 and @@ -99,37 +170,61 @@ or are not set, the entry point defaults to the image load address .Pq Fl a . -.It Fl f No ( arm64 Ns | Ns uimg ) +. +.It Fl f Po Xo +.Li arm64 Ns \||\| Ns +.Li uimg +.Xc Pc Defines the output image format type. The default is -.Qq uimg . +.Ql uimg . +. .It Fl h Display the usage and exit. +. .It Fl m Ar magic Set the magic used for -.Qq uimg +.Ql uimg format images. This is an integer between 0 and .Dv UINT32_MAX . The default is -.Qq 0x27051956 . -.It Fl n Ar image +.Ql 0x27051956 . +. +.It Fl n Ar name Defines the image name. This is required. -.It Fl O No ( freebsd Ns | Ns linux Ns | Ns netbsd Ns | Ns openbsd ) +. +.It Fl O Po Xo +.Li freebsd Ns \||\| Ns +.Li linux Ns \||\| Ns +.Li netbsd Ns \||\| Ns +.Li openbsd +.Xc Pc Defines the operating system type. The default OS name is -.Qq netbsd . -.It Fl T No ( fs Ns | Ns kernel Ns | Ns kernel_noload Ns | Ns ramdisk Ns | Ns script Ns | Ns standalone ) +.Ql netbsd . +. +.It Fl T Po Xo +.Li fsNs \||\| Ns +.Li kernelNs \||\| Ns +.Li kernel_noload Ns \||\| Ns +.Li ramdisk Ns \||\| Ns +.Li scriptNs \||\| Ns +.Li standalone +.Xc Pc Defines the
CVS commit: src/usr.bin/mkubootimage
Module Name:src Committed By: uwe Date: Tue May 21 23:31:21 UTC 2024 Modified Files: src/usr.bin/mkubootimage: mkubootimage.1 Log Message: mkubootimage.1: restore .Ed lost in previous To generate a diff of this commit: cvs rdiff -u -r1.18 -r1.19 src/usr.bin/mkubootimage/mkubootimage.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/mkubootimage/mkubootimage.1 diff -u src/usr.bin/mkubootimage/mkubootimage.1:1.18 src/usr.bin/mkubootimage/mkubootimage.1:1.19 --- src/usr.bin/mkubootimage/mkubootimage.1:1.18 Tue May 21 22:10:21 2024 +++ src/usr.bin/mkubootimage/mkubootimage.1 Tue May 21 23:31:21 2024 @@ -1,4 +1,4 @@ -.\" $NetBSD: mkubootimage.1,v 1.18 2024/05/21 22:10:21 gutteridge Exp $ +.\" $NetBSD: mkubootimage.1,v 1.19 2024/05/21 23:31:21 uwe Exp $ .\" .\" Copyright (c) 2012 The NetBSD Foundation, Inc. .\" All rights reserved. @@ -161,6 +161,7 @@ for example: comp:0 (none) name:NetBSD/armv7 boot header crc: 0x2164b567 +.Ed .\" .Sh FILES .Sh SEE ALSO .Qq Das U-Boot - the Universal Boot Loader
CVS commit: src/usr.bin/mkubootimage
Module Name:src Committed By: uwe Date: Tue May 21 23:31:21 UTC 2024 Modified Files: src/usr.bin/mkubootimage: mkubootimage.1 Log Message: mkubootimage.1: restore .Ed lost in previous To generate a diff of this commit: cvs rdiff -u -r1.18 -r1.19 src/usr.bin/mkubootimage/mkubootimage.1 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/lib/libcurses
Module Name:src Committed By: uwe Date: Fri May 17 23:32:51 UTC 2024 Modified Files: src/lib/libcurses: curses.h curses_private.h curses_screen.3 screen.c setterm.c Log Message: curses: constify newterm() and setterm() arguments newterm() argument is const in the spec, so this fixes our conformance. setterm() is not in the spec, but it's natural and in ncurses its argument is const too, so follow suit. Doesn't change the ABI, so no bump required. ok blymn@ To generate a diff of this commit: cvs rdiff -u -r1.131 -r1.132 src/lib/libcurses/curses.h cvs rdiff -u -r1.80 -r1.81 src/lib/libcurses/curses_private.h cvs rdiff -u -r1.28 -r1.29 src/lib/libcurses/curses_screen.3 cvs rdiff -u -r1.37 -r1.38 src/lib/libcurses/screen.c cvs rdiff -u -r1.71 -r1.72 src/lib/libcurses/setterm.c Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/lib/libcurses
Module Name:src
Committed By: uwe
Date: Fri May 17 23:32:51 UTC 2024
Modified Files:
src/lib/libcurses: curses.h curses_private.h curses_screen.3 screen.c
setterm.c
Log Message:
curses: constify newterm() and setterm() arguments
newterm() argument is const in the spec, so this fixes our
conformance.
setterm() is not in the spec, but it's natural and in ncurses its
argument is const too, so follow suit.
Doesn't change the ABI, so no bump required.
ok blymn@
To generate a diff of this commit:
cvs rdiff -u -r1.131 -r1.132 src/lib/libcurses/curses.h
cvs rdiff -u -r1.80 -r1.81 src/lib/libcurses/curses_private.h
cvs rdiff -u -r1.28 -r1.29 src/lib/libcurses/curses_screen.3
cvs rdiff -u -r1.37 -r1.38 src/lib/libcurses/screen.c
cvs rdiff -u -r1.71 -r1.72 src/lib/libcurses/setterm.c
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/curses.h
diff -u src/lib/libcurses/curses.h:1.131 src/lib/libcurses/curses.h:1.132
--- src/lib/libcurses/curses.h:1.131 Tue May 14 10:22:48 2024
+++ src/lib/libcurses/curses.h Fri May 17 23:32:50 2024
@@ -1,4 +1,4 @@
-/* $NetBSD: curses.h,v 1.131 2024/05/14 10:22:48 uwe Exp $ */
+/* $NetBSD: curses.h,v 1.132 2024/05/17 23:32:50 uwe Exp $ */
/*
* Copyright (c) 1981, 1993, 1994
@@ -719,7 +719,7 @@ int mvwprintw(WINDOW *, int, int, const
int mvwscanw(WINDOW *, int, int, const char *, ...) __scanflike(4, 5);
int napms(int);
WINDOW *newpad(int, int);
-SCREEN *newterm(char *, FILE *, FILE *);
+SCREEN *newterm(const char *, FILE *, FILE *);
WINDOW *newwin(int, int, int, int);
int nl(void);
attr_t no_color_attributes(void);
@@ -751,7 +751,7 @@ int savetty(void);
int scanw(const char *, ...) __scanflike(1, 2);
int scroll(WINDOW *);
int scrollok(WINDOW *, bool);
-int setterm(char *);
+int setterm(const char *);
int set_escdelay(int);
int set_tabsize(int);
SCREEN *set_term(SCREEN *);
Index: src/lib/libcurses/curses_private.h
diff -u src/lib/libcurses/curses_private.h:1.80 src/lib/libcurses/curses_private.h:1.81
--- src/lib/libcurses/curses_private.h:1.80 Tue May 3 07:25:34 2022
+++ src/lib/libcurses/curses_private.h Fri May 17 23:32:50 2024
@@ -1,4 +1,4 @@
-/* $NetBSD: curses_private.h,v 1.80 2022/05/03 07:25:34 blymn Exp $ */
+/* $NetBSD: curses_private.h,v 1.81 2024/05/17 23:32:50 uwe Exp $ */
/*-
* Copyright (c) 1998-2000 Brett Lymn
@@ -355,7 +355,7 @@ int _cursesi_waddbytes(WINDOW *, const c
void _cursesi_reset_wacs(SCREEN *);
#endif /* HAVE_WCHAR */
void _cursesi_resetterm(SCREEN *);
-int _cursesi_setterm(char *, SCREEN *);
+int _cursesi_setterm(const char *, SCREEN *);
int __delay(void);
unsigned int __hash_more(const void *, size_t, unsigned int);
unsigned int __hash_line(const __LDATA *, int);
Index: src/lib/libcurses/curses_screen.3
diff -u src/lib/libcurses/curses_screen.3:1.28 src/lib/libcurses/curses_screen.3:1.29
--- src/lib/libcurses/curses_screen.3:1.28 Sun Feb 7 23:00:57 2021
+++ src/lib/libcurses/curses_screen.3 Fri May 17 23:32:50 2024
@@ -1,4 +1,4 @@
-.\" $NetBSD: curses_screen.3,v 1.28 2021/02/07 23:00:57 rillig Exp $
+.\" $NetBSD: curses_screen.3,v 1.29 2024/05/17 23:32:50 uwe Exp $
.\"
.\" Copyright (c) 2002
.\" Brett Lymn (bl...@netbsd.org, brett_l...@yahoo.com.au)
@@ -30,7 +30,7 @@
.\" SUCH DAMAGE.
.\"
.\"
-.Dd March 12, 2020
+.Dd May 16, 2024
.Dt CURSES_SCREEN 3
.Os
.Sh NAME
@@ -61,7 +61,7 @@
.Ft void
.Fn use_env "bool value"
.Ft SCREEN *
-.Fn newterm "char *type" "FILE *outfd" "FILE *infd"
+.Fn newterm "const char *type" "FILE *outfd" "FILE *infd"
.Ft SCREEN *
.Fn set_term "SCREEN *screen"
.Ft void
@@ -79,7 +79,7 @@
.Ft int
.Fn resizeterm "int lines" "int cols"
.Ft int
-.Fn setterm "char *name"
+.Fn setterm "const char *name"
.Ft int
.Fn set_tabsize "int value"
.Pp
@@ -99,7 +99,9 @@ argument points to a
.Xr terminfo 5
entry, or it may be
.Dv NULL
-in which case the TERM environment variable is used.
+in which case the
+.Ev TERM
+environment variable is used.
The
.Fa outfd
and
Index: src/lib/libcurses/screen.c
diff -u src/lib/libcurses/screen.c:1.37 src/lib/libcurses/screen.c:1.38
--- src/lib/libcurses/screen.c:1.37 Fri Apr 8 10:17:52 2022
+++ src/lib/libcurses/screen.c Fri May 17 23:32:50 2024
@@ -1,4 +1,4 @@
-/* $NetBSD: screen.c,v 1.37 2022/04/08 10:17:52 andvar Exp $ */
+/* $NetBSD: screen.c,v 1.38 2024/05/17 23:32:50 uwe Exp $ */
/*
* Copyright (c) 1981, 1993, 1994
@@ -34,7 +34,7 @@
#if 0
static char sccsid[] = "@(#)screen.c 8.2 (blymn) 11/27/2001";
#else
-__RCSID("$NetBSD: screen.c,v 1.37 2022/04/08 10:17:52 andvar Exp $");
+__RCSID("$NetBSD: screen.c,v 1.38 2024/05/17 23:32:50 uwe Exp $");
#endif
#endif /* not lint */
@@ -124,10 +124,10 @@ set_term(SCREEN *new)
*
*/
SCREEN *
-newterm(char *type, FILE *outfd, FILE *infd)
+newterm(const char *type, FILE *outfd, FILE *infd)
{
SCREEN *new_screen;
- char
Re: CVS commit: src/share/man/man4
On Thu, May 16, 2024 at 11:54:20 +, Nia Alarie wrote: > Modified Files: > src/share/man/man4: eap.4 > > Log Message: > Note that EAP_USE_BOTH_DACS is deprecated in the eap(4) manual page. Please, can you restore the part that explains what this option is/does? It might be on its way out, but since we document it's there, it's a good idea to actually document it, IMHO. I don't know much about audio, but the kernel mixer is software, isn't it. I would imagine the type of systems that might have this device may actually benefit from the hardware acceleration that this option seems to imply. I.e. if anything, I'd rather this option is documented even better than it was. -uwe
CVS commit: src/share/man/man4
Module Name:src Committed By: uwe Date: Thu May 16 14:41:03 UTC 2024 Modified Files: src/share/man/man4: eap.4 Log Message: eap(4): touch up markup a bit To generate a diff of this commit: cvs rdiff -u -r1.18 -r1.19 src/share/man/man4/eap.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/eap.4 diff -u src/share/man/man4/eap.4:1.18 src/share/man/man4/eap.4:1.19 --- src/share/man/man4/eap.4:1.18 Thu May 16 11:54:19 2024 +++ src/share/man/man4/eap.4 Thu May 16 14:41:03 2024 @@ -1,4 +1,4 @@ -.\" $NetBSD: eap.4,v 1.18 2024/05/16 11:54:19 nia Exp $ +.\" $NetBSD: eap.4,v 1.19 2024/05/16 14:41:03 uwe Exp $ .\" .\" Copyright (c) 1999 The NetBSD Foundation, Inc. .\" All rights reserved. @@ -34,11 +34,12 @@ .Nm eap .Nd AudioPCI audio device driver .Sh SYNOPSIS -.Cd "eap* at pci? dev ? function ?" -.Cd "audio* at audiobus?" -.Cd "joy* at eap?" -.Cd "midi* at eap?" +.Cd "eap*at pci? dev ? function ?" .Cd "options EAP_USE_BOTH_DACS" +.Pp +.Cd "audio* at audiobus?" +.Cd "joy*at eap?" +.Cd "midi* at eap?" .Sh DESCRIPTION The .Nm @@ -47,9 +48,8 @@ SoundBlaster PCI series of audio cards. All models based on the ES1370, ES1371, and ES1373 chips are supported. .Pp By specifying: -.Bd -unfilled -offset indent -options EAP_USE_BOTH_DACS -.Ed +.Pp +.D1 Cd options EAP_USE_BOTH_DACS .Pp a second audio device is attached. You can use it simply by directing audio output to it.
CVS commit: src/share/man/man4
Module Name:src Committed By: uwe Date: Thu May 16 14:41:03 UTC 2024 Modified Files: src/share/man/man4: eap.4 Log Message: eap(4): touch up markup a bit To generate a diff of this commit: cvs rdiff -u -r1.18 -r1.19 src/share/man/man4/eap.4 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
Re: CVS commit: src/bin/echo
On Wed, May 15, 2024 at 05:22:25 +0700, Robert Elz wrote: > | Unfortunately that advice is not true without further caveats. > > That you have to actually write a valid printf(1) command, and not > simply s/echo/printf/ ? Does that really need saying? > > > | netbsd$ sh -c "printf '-V\n'" > > printf -- -V\\n > > and it will work anywhere - our printf is specially hacked as once > upon a time it took no options, and this kind of thing would work. > Format strings starting with a '-' don't work in general however, > the '--' should be included if the format might begin with a '-'. > > Even better would be > > printf -- %s\\n -V > > (where the -- is optional here). I vaguely remember I read somewhere that printf(1) was specifically conceived to take no options, but that can be planted memories. May be it's indeed induced by the old state of affairs in our version. -uwe
CVS commit: src/lib/libcurses
Module Name:src Committed By: uwe Date: Tue May 14 10:40:41 UTC 2024 Modified Files: src/lib/libcurses: curses_input.3 Log Message: curses_input(3): bump date for define_key() change To generate a diff of this commit: cvs rdiff -u -r1.31 -r1.32 src/lib/libcurses/curses_input.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/libcurses/curses_input.3 diff -u src/lib/libcurses/curses_input.3:1.31 src/lib/libcurses/curses_input.3:1.32 --- src/lib/libcurses/curses_input.3:1.31 Tue May 14 10:22:48 2024 +++ src/lib/libcurses/curses_input.3 Tue May 14 10:40:41 2024 @@ -1,4 +1,4 @@ -.\" $NetBSD: curses_input.3,v 1.31 2024/05/14 10:22:48 uwe Exp $ +.\" $NetBSD: curses_input.3,v 1.32 2024/05/14 10:40:41 uwe Exp $ .\" .\" Copyright (c) 2002 .\" Brett Lymn (bl...@netbsd.org, brett_l...@yahoo.com.au) @@ -30,7 +30,7 @@ .\" SUCH DAMAGE. .\" .\" -.Dd May 16, 2022 +.Dd May 14, 2024 .Dt CURSES_INPUT 3 .Os .Sh NAME
CVS commit: src/lib/libcurses
Module Name:src Committed By: uwe Date: Tue May 14 10:40:41 UTC 2024 Modified Files: src/lib/libcurses: curses_input.3 Log Message: curses_input(3): bump date for define_key() change To generate a diff of this commit: cvs rdiff -u -r1.31 -r1.32 src/lib/libcurses/curses_input.3 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/lib/libcurses
Module Name:src Committed By: uwe Date: Tue May 14 10:38:16 UTC 2024 Modified Files: src/lib/libcurses: curses_termcap.3 Log Message: curses_termcap(3): fullname() termbuf argument is const To generate a diff of this commit: cvs rdiff -u -r1.6 -r1.7 src/lib/libcurses/curses_termcap.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/libcurses/curses_termcap.3 diff -u src/lib/libcurses/curses_termcap.3:1.6 src/lib/libcurses/curses_termcap.3:1.7 --- src/lib/libcurses/curses_termcap.3:1.6 Sat Apr 21 12:27:28 2012 +++ src/lib/libcurses/curses_termcap.3 Tue May 14 10:38:16 2024 @@ -1,4 +1,4 @@ -.\" $NetBSD: curses_termcap.3,v 1.6 2012/04/21 12:27:28 roy Exp $ +.\" $NetBSD: curses_termcap.3,v 1.7 2024/05/14 10:38:16 uwe Exp $ .\" .\" Copyright (c) 2002 .\" Brett Lymn (bl...@netbsd.org, brett_l...@yahoo.com.au) @@ -30,7 +30,7 @@ .\" SUCH DAMAGE. .\" .\" -.Dd October 4, 2011 +.Dd May 14, 2024 .Dt CURSES_TERMCAP 3 .Os .Sh NAME @@ -42,7 +42,7 @@ .Sh SYNOPSIS .In curses.h .Ft char * -.Fn fullname "char *termbuf" "char *name" +.Fn fullname "const char *termbuf" "char *name" .Sh DESCRIPTION The .Fn fullname
CVS commit: src/lib/libcurses
Module Name:src Committed By: uwe Date: Tue May 14 10:38:16 UTC 2024 Modified Files: src/lib/libcurses: curses_termcap.3 Log Message: curses_termcap(3): fullname() termbuf argument is const To generate a diff of this commit: cvs rdiff -u -r1.6 -r1.7 src/lib/libcurses/curses_termcap.3 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/lib/libcurses
Module Name:src
Committed By: uwe
Date: Tue May 14 10:22:48 UTC 2024
Modified Files:
src/lib/libcurses: curses.h curses_input.3 getch.c
Log Message:
curse: constify define_key() argument
define_key() is ncurses extension and ncurses defines its first
argument as "const char *". Follow suit.
PR lib/58254
To generate a diff of this commit:
cvs rdiff -u -r1.130 -r1.131 src/lib/libcurses/curses.h
cvs rdiff -u -r1.30 -r1.31 src/lib/libcurses/curses_input.3
cvs rdiff -u -r1.78 -r1.79 src/lib/libcurses/getch.c
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/curses.h
diff -u src/lib/libcurses/curses.h:1.130 src/lib/libcurses/curses.h:1.131
--- src/lib/libcurses/curses.h:1.130 Sat Feb 13 10:37:00 2021
+++ src/lib/libcurses/curses.h Tue May 14 10:22:48 2024
@@ -1,4 +1,4 @@
-/* $NetBSD: curses.h,v 1.130 2021/02/13 10:37:00 rillig Exp $ */
+/* $NetBSD: curses.h,v 1.131 2024/05/14 10:22:48 uwe Exp $ */
/*
* Copyright (c) 1981, 1993, 1994
@@ -652,7 +652,7 @@ int copywin(const WINDOW *, WINDOW *, i
int curs_set(int);
int def_prog_mode(void);
int def_shell_mode(void);
-int define_key(char *, int);
+int define_key(const char *, int);
int delay_output(int);
void delscreen(SCREEN *);
int delwin(WINDOW *);
Index: src/lib/libcurses/curses_input.3
diff -u src/lib/libcurses/curses_input.3:1.30 src/lib/libcurses/curses_input.3:1.31
--- src/lib/libcurses/curses_input.3:1.30 Sat May 21 12:34:44 2022
+++ src/lib/libcurses/curses_input.3 Tue May 14 10:22:48 2024
@@ -1,4 +1,4 @@
-.\" $NetBSD: curses_input.3,v 1.30 2022/05/21 12:34:44 uwe Exp $
+.\" $NetBSD: curses_input.3,v 1.31 2024/05/14 10:22:48 uwe Exp $
.\"
.\" Copyright (c) 2002
.\" Brett Lymn (bl...@netbsd.org, brett_l...@yahoo.com.au)
@@ -76,7 +76,7 @@
.Ft int
.Fn has_key "int key_symbol"
.Ft int
-.Fn define_key "char *sequence" "int key_symbol"
+.Fn define_key "const char *sequence" "int key_symbol"
.Ft int
.Fn getnstr "char *str" "int limit"
.Ft int
Index: src/lib/libcurses/getch.c
diff -u src/lib/libcurses/getch.c:1.78 src/lib/libcurses/getch.c:1.79
--- src/lib/libcurses/getch.c:1.78 Tue Oct 19 06:37:29 2021
+++ src/lib/libcurses/getch.c Tue May 14 10:22:48 2024
@@ -1,4 +1,4 @@
-/* $NetBSD: getch.c,v 1.78 2021/10/19 06:37:29 blymn Exp $ */
+/* $NetBSD: getch.c,v 1.79 2024/05/14 10:22:48 uwe Exp $ */
/*
* Copyright (c) 1981, 1993, 1994
@@ -34,7 +34,7 @@
#if 0
static char sccsid[] = "@(#)getch.c 8.2 (Berkeley) 5/4/94";
#else
-__RCSID("$NetBSD: getch.c,v 1.78 2021/10/19 06:37:29 blymn Exp $");
+__RCSID("$NetBSD: getch.c,v 1.79 2024/05/14 10:22:48 uwe Exp $");
#endif
#endif /* not lint */
@@ -211,7 +211,7 @@ static wchar_t inbuf[INBUF_SZ];
static int start, end, working; /* pointers for manipulating inbuf data */
/* prototypes for private functions */
-static void add_key_sequence(SCREEN *screen, char *sequence, int key_type);
+static void add_key_sequence(SCREEN *screen, const char *sequence, int key_type);
static key_entry_t *add_new_key(keymap_t *current, char ch, int key_type,
int symbol);
static void delete_key_sequence(keymap_t *current, int key_type);
@@ -370,7 +370,7 @@ delete_key_sequence(keymap_t *current, i
* for the given key symbol.
*/
static void
-add_key_sequence(SCREEN *screen, char *sequence, int key_type)
+add_key_sequence(SCREEN *screen, const char *sequence, int key_type)
{
key_entry_t *tmp_key;
keymap_t *current;
@@ -762,7 +762,7 @@ do_keyok(keymap_t *current, int key_type
*
*/
int
-define_key(char *sequence, int symbol)
+define_key(const char *sequence, int symbol)
{
if (symbol <= 0 || _cursesi_screen == NULL)
CVS commit: src/lib/libcurses
Module Name:src Committed By: uwe Date: Tue May 14 10:22:48 UTC 2024 Modified Files: src/lib/libcurses: curses.h curses_input.3 getch.c Log Message: curse: constify define_key() argument define_key() is ncurses extension and ncurses defines its first argument as "const char *". Follow suit. PR lib/58254 To generate a diff of this commit: cvs rdiff -u -r1.130 -r1.131 src/lib/libcurses/curses.h cvs rdiff -u -r1.30 -r1.31 src/lib/libcurses/curses_input.3 cvs rdiff -u -r1.78 -r1.79 src/lib/libcurses/getch.c Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
Re: CVS commit: src/bin/echo
On Tue, May 14, 2024 at 01:32:25 +, David H. Gutteridge wrote: > Log Message: > echo.1: borrow advice about printf(1) from the OpenBSD man page Unfortunately that advice is not true without further caveats. netbsd$ sh -c "printf '-V\n'" -V $ busybox sh -c "printf '-V\n'" -V ubuntu$ $ dash -c "printf '-V\n'" dash: 1: printf: Illegal option -V $ bash -c "printf '-V\n'" bash: line 1: printf: -V: invalid option printf: usage: printf [-v var] format [arguments] -uwe
CVS commit: src/external/cddl/osnet/dist/tools/ctf/cvt
Module Name:src
Committed By: uwe
Date: Sat May 4 18:22:59 UTC 2024
Modified Files:
src/external/cddl/osnet/dist/tools/ctf/cvt: ctfmerge.c
Log Message:
ctfmerge: obey CTFMERGE_TERMINATE_NO_UNLINK as a tool too
To generate a diff of this commit:
cvs rdiff -u -r1.19 -r1.20 \
src/external/cddl/osnet/dist/tools/ctf/cvt/ctfmerge.c
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/external/cddl/osnet/dist/tools/ctf/cvt/ctfmerge.c
diff -u src/external/cddl/osnet/dist/tools/ctf/cvt/ctfmerge.c:1.19 src/external/cddl/osnet/dist/tools/ctf/cvt/ctfmerge.c:1.20
--- src/external/cddl/osnet/dist/tools/ctf/cvt/ctfmerge.c:1.19 Fri May 3 15:50:42 2024
+++ src/external/cddl/osnet/dist/tools/ctf/cvt/ctfmerge.c Sat May 4 18:22:59 2024
@@ -682,7 +682,7 @@ terminate_cleanup(void)
if (outfile == NULL)
return;
-#if !defined (__FreeBSD__) && !defined(__NetBSD__)
+#if !defined (__FreeBSD__) && !(defined(__NetBSD__) || HAVE_NBTOOL_CONFIG_H)
if (dounlink) {
fprintf(stderr, "Removing %s\n", outfile);
unlink(outfile);
CVS commit: src/external/cddl/osnet/dist/tools/ctf/cvt
Module Name:src Committed By: uwe Date: Sat May 4 18:22:59 UTC 2024 Modified Files: src/external/cddl/osnet/dist/tools/ctf/cvt: ctfmerge.c Log Message: ctfmerge: obey CTFMERGE_TERMINATE_NO_UNLINK as a tool too To generate a diff of this commit: cvs rdiff -u -r1.19 -r1.20 \ src/external/cddl/osnet/dist/tools/ctf/cvt/ctfmerge.c Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/external/cddl/osnet/usr.bin/ctfmerge
Module Name:src Committed By: uwe Date: Sat May 4 18:20:44 UTC 2024 Modified Files: src/external/cddl/osnet/usr.bin/ctfmerge: ctfmerge.1 Log Message: ctfmerge(1): brush up markup To generate a diff of this commit: cvs rdiff -u -r1.4 -r1.5 src/external/cddl/osnet/usr.bin/ctfmerge/ctfmerge.1 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/external/cddl/osnet/usr.bin/ctfmerge/ctfmerge.1 diff -u src/external/cddl/osnet/usr.bin/ctfmerge/ctfmerge.1:1.4 src/external/cddl/osnet/usr.bin/ctfmerge/ctfmerge.1:1.5 --- src/external/cddl/osnet/usr.bin/ctfmerge/ctfmerge.1:1.4 Sat May 4 13:11:41 2024 +++ src/external/cddl/osnet/usr.bin/ctfmerge/ctfmerge.1 Sat May 4 18:20:44 2024 @@ -1,4 +1,4 @@ -.\" $NetBSD: ctfmerge.1,v 1.4 2024/05/04 13:11:41 christos Exp $ +.\" $NetBSD: ctfmerge.1,v 1.5 2024/05/04 18:20:44 uwe Exp $ .\" .\" Copyright (c) 2010 The FreeBSD Foundation .\" All rights reserved. @@ -41,7 +41,7 @@ .Fl l Ar label .Fl L Ar labelenv .Fl o Ar outfile -file ... +.Ar .Nm .Op Fl fgstv .Fl l Ar label @@ -50,14 +50,14 @@ file ... .Fl d Ar uniqfile .Op Fl g .Op Fl D Ar uniqlabel -file ... +.Ar .Nm .Op Fl fgstv .Fl l Ar label .Fl L Ar labelenv .Fl o Ar outfile .Fl w Ar withfile -file ... +.Ar .Nm .Op Fl g .Fl c Ar srcfile @@ -69,13 +69,17 @@ utility merges several CTF data sections output file, unifying common data. .Pp The following options are available: -.Bl -tag -width indent +.Bl -tag -width Fl .It Fl f Match global symbols to global CTF data. .It Fl g Don't delete the original debugging sections. .It Fl s -Use the .dynsym ELF section instead of the .symtab ELF section. +Use the +.Ql .dynsym +ELF section instead of the +.Ql .symtab +ELF section. .It Fl t Make sure that all object files have a CTF section. .It Fl v @@ -110,24 +114,32 @@ into .Sh ENVIRONMENT VARIABLES The following environment variables are used in .Nm : -.Bl -tag -width x -.It CTFMERGE_TERMINATE_NO_UNLINK +.Bl -tag -width Ev +.It Ev CTFMERGE_TERMINATE_NO_UNLINK Don't remove temporary files on exit, so that they can be examined for debugging. -.It CTFMERGE_MAX_SLOTS +.It Ev CTFMERGE_MAX_SLOTS Number of round-robin slots in the input queue that it is processed by worker threads. -Each slot represents a file batch (default 5). -.It CTFMERGE_PHASE1_BATCH_SIZE -Number of files in a slot that are needed before processing starts (default 8). -.It CTFMERGE_NUM_THREADS +Each slot represents a file batch +.Pq default 5 . +.It Ev CTFMERGE_PHASE1_BATCH_SIZE +Number of files in a slot that are needed before processing starts +.Pq default 8 . +.It Ev CTFMERGE_NUM_THREADS Set the number of worker threads. If the number of processors can be determined it defaults to -min(processors * 3 / 2, nslots), if not it defaults to 2. -.It CTFMERGE_INPUT_THROTTLE -Max queue size to queue (defaults to 10). -.It CTFMERGE_DEBUG_LEVEL -Increase debugging verbosity (maximum is 3). +.Fo min +.Fa "processors\|*\|3\|/\|2" +.Fa "nslots" +.Fc +if not it defaults to 2. +.It Ev CTFMERGE_INPUT_THROTTLE +Max queue size to queue +.Pq defaults to 10 . +.It Ev CTFMERGE_DEBUG_LEVEL +Increase debugging verbosity +.Pq maximum is 3 . .El .Sh EXIT STATUS .Ex -std
CVS commit: src/external/cddl/osnet/usr.bin/ctfmerge
Module Name:src Committed By: uwe Date: Sat May 4 18:20:44 UTC 2024 Modified Files: src/external/cddl/osnet/usr.bin/ctfmerge: ctfmerge.1 Log Message: ctfmerge(1): brush up markup To generate a diff of this commit: cvs rdiff -u -r1.4 -r1.5 src/external/cddl/osnet/usr.bin/ctfmerge/ctfmerge.1 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: Sun Apr 28 23:10:26 UTC 2024 Modified Files: src/lib/libc/sys: execve.2 Log Message: execve(2): brush up markup To generate a diff of this commit: cvs rdiff -u -r1.46 -r1.47 src/lib/libc/sys/execve.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/execve.2 diff -u src/lib/libc/sys/execve.2:1.46 src/lib/libc/sys/execve.2:1.47 --- src/lib/libc/sys/execve.2:1.46 Sun Apr 28 22:21:21 2024 +++ src/lib/libc/sys/execve.2 Sun Apr 28 23:10:26 2024 @@ -1,4 +1,4 @@ -.\" $NetBSD: execve.2,v 1.46 2024/04/28 22:21:21 rillig Exp $ +.\" $NetBSD: execve.2,v 1.47 2024/04/28 23:10:26 uwe Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -75,35 +75,32 @@ and .Xr a.out 5 . .Pp An interpreter file begins with a line of the form: -.Pp -.Bd -ragged -offset indent -compact -.Sy
CVS commit: src/lib/libc/sys
Module Name:src Committed By: uwe Date: Sun Apr 28 23:10:26 UTC 2024 Modified Files: src/lib/libc/sys: execve.2 Log Message: execve(2): brush up markup To generate a diff of this commit: cvs rdiff -u -r1.46 -r1.47 src/lib/libc/sys/execve.2 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
Re: CVS commit: src/lib/libutil
On Mon, Apr 08, 2024 at 23:31:16 +0200, Roland Illig wrote: > Am 08.04.2024 um 21:18 schrieb Valery Ushakov: > > "=\017FIFTEEN\0" > > > > with its result a few lines below that has: > > > > BURST=0xf=FIFTEEN > > Thank you for explaining this example. I had a gut feeling that there > would be some hidden correlation between some octal/hexadecimal > combinations, but I couldn't name it. Indeed, if the number base for > output is hexadecimal, the field comparisons should be done in > hexadecimal as well. > > I adjusted the description and examples in the manual page accordingly. Thanks! My unscientific impression is that snprintb(3) was not very popular and its uses sometimes are a bit of a cargo-cult, so existing use cases have to be taken with a grain of salt and don't necessarily represent good style. This is why improving the docs with good examples is important, imho. -uwe
Re: CVS commit: src/lib/libutil
On Mon, Apr 08, 2024 at 20:21:07 +0200, Roland Illig wrote: > I didn't eradicate _all_ hexadecimal examples, I just made each example > use only one number base, not mix them both. There are both octal and > hexadecimal examples in the manual page. That's not what "prefer octal in examples" conveys. I would also say that source code that says "=\x0f" "FIFTEEN\0" aligns much better than "=\017FIFTEEN\0" with its result a few lines below that has: BURST=0xf=FIFTEEN -uwe
CVS commit: src/sbin/ifconfig
Module Name:src Committed By: uwe Date: Mon Apr 8 12:32:57 UTC 2024 Modified Files: src/sbin/ifconfig: ifconfig.8 Log Message: ifconfig(8): move laggportpri next to laggport To generate a diff of this commit: cvs rdiff -u -r1.127 -r1.128 src/sbin/ifconfig/ifconfig.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/ifconfig/ifconfig.8 diff -u src/sbin/ifconfig/ifconfig.8:1.127 src/sbin/ifconfig/ifconfig.8:1.128 --- src/sbin/ifconfig/ifconfig.8:1.127 Mon Apr 8 09:25:25 2024 +++ src/sbin/ifconfig/ifconfig.8 Mon Apr 8 12:32:57 2024 @@ -1,4 +1,4 @@ -.\" $NetBSD: ifconfig.8,v 1.127 2024/04/08 09:25:25 kre Exp $ +.\" $NetBSD: ifconfig.8,v 1.128 2024/04/08 12:32:57 uwe Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -630,6 +630,13 @@ Remove the interface named by from the .Xr lagg 4 interface. +.It Cm laggportpri Ar interface Ar n +If the interface is a +.Xr lagg 4 +pseudo-interface, set the priority of +.Ar interface +to +.Ar n .It Cm laggproto Ar proto Set the aggregation protocol of .Xr lagg 4 . @@ -641,13 +648,6 @@ The available options are .Li loadbalance , and .Li none . -.It Cm laggportpri Ar interface Ar n -If the interface is a -.Xr lagg 4 -pseudo-interface, set the priority of -.Ar interface -to -.Ar n .It Cm eee Enable IEEE 802.3az Energy Efficiency Ethernet function. .It Cm -eee
CVS commit: src/sbin/ifconfig
Module Name:src Committed By: uwe Date: Mon Apr 8 12:32:57 UTC 2024 Modified Files: src/sbin/ifconfig: ifconfig.8 Log Message: ifconfig(8): move laggportpri next to laggport To generate a diff of this commit: cvs rdiff -u -r1.127 -r1.128 src/sbin/ifconfig/ifconfig.8 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
Re: CVS commit: src/lib/libutil
On Sun, Apr 07, 2024 at 14:28:27 +, Roland Illig wrote: > Log Message: > snprintb.3: clean up formatting and wording, prefer octal in examples > > Using hexadecimal character escapes requires separate string literals if > the description starts with one of the letters A-F; octal character > escapes have at most 3 digits, reducing ambiguity. 70s are over, very few people speak octal fluently. If anything, the man page should highlight the potential snag. Besides, separate literal for the name is good for readability anyway. Please, revert. -uwe
CVS commit: src/share/man/man4
Module Name:src Committed By: uwe Date: Wed Apr 3 00:40:46 UTC 2024 Modified Files: src/share/man/man4: dk.4 Log Message: dk(4): touch up markup, sort options To generate a diff of this commit: cvs rdiff -u -r1.14 -r1.15 src/share/man/man4/dk.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: Wed Apr 3 00:40:46 UTC 2024
Modified Files:
src/share/man/man4: dk.4
Log Message:
dk(4): touch up markup, sort options
To generate a diff of this commit:
cvs rdiff -u -r1.14 -r1.15 src/share/man/man4/dk.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/dk.4
diff -u src/share/man/man4/dk.4:1.14 src/share/man/man4/dk.4:1.15
--- src/share/man/man4/dk.4:1.14 Tue Apr 2 23:46:19 2024
+++ src/share/man/man4/dk.4 Wed Apr 3 00:40:46 2024
@@ -1,4 +1,4 @@
-.\" $NetBSD: dk.4,v 1.14 2024/04/02 23:46:19 charlotte Exp $
+.\" $NetBSD: dk.4,v 1.15 2024/04/03 00:40:46 uwe Exp $
.\"
.\" Copyright (c) 2006 The NetBSD Foundation, Inc.
.\" All rights reserved.
@@ -39,11 +39,11 @@
driver
.Sh SYNOPSIS
.Cd "options DKWEDGE_AUTODISCOVER"
+.Cd "options DKWEDGE_METHOD_APPLE"
.Cd "options DKWEDGE_METHOD_BSDLABEL"
.Cd "options DKWEDGE_METHOD_GPT"
.Cd "options DKWEDGE_METHOD_MBR"
.Cd "options DKWEDGE_METHOD_RDB"
-.Cd "options DKWEDGE_METHOD_APPLE"
.Cd "options DKWEDGE_METHOD_TOS"
.Sh DESCRIPTION
The
@@ -59,79 +59,107 @@ Wedges need to have unique names.
If a duplicate name is detected during
auto-discovery, that partition is ignored.
.Sh KERNEL OPTIONS
-.Bl -tag -width DKWEDGE_METHOD_BSDLABEL
+.Bl -tag -width Dv
+.\"
.It Dv DKWEDGE_AUTODISCOVER
Automatically detect and configure wedges using any available methods.
+For each partition found, a wedge with a corresponding name is created.
.Pp
Currently only
.Dv DKWEDGE_METHOD_GPT
and
.Dv DKWEDGE_METHOD_APPLE
are enabled by default.
-.Pp
-For each partition found, a wedge with a corresponding name is created.
+.\"
+.It Dv DKWEDGE_METHOD_APPLE
+Apple partition map detection method.
+.\"
.It Dv DKWEDGE_METHOD_BSDLABEL
-BSD disklabel detection method.
+.Tn BSD
+disklabel detection method.
For each configured partition in the
.Xr disklabel 5
that is not of type
.Dv FS_UNUSED ,
a wedge is created and named after the
-.Va d_packname
+.Fa d_packname
field followed by
-.Sq \&/
+.Ql \&/
and the partition letter
-.So a Sc Ns \&.. Ns So p Sc .
+.Sm off
+.So Li a Sc \&.. So Li p Sc .
+.Sm on
.Pp
When the
-.Va d_packname
+.Fa d_packname
is empty or has the value
-.Dq fictitious ,
+.Ql fictitious ,
the regular partition names
are used as wedge names, i.e. the device name, unit number and
partition letter, for example
-.Dq wd0a .
+.Ql wd0a .
+.\"
.It Dv DKWEDGE_METHOD_GPT
Extensible Firmware Interface Globally Unique Identifier Partition Table
-(GPT) detection method.
+.Tn ( GPT )
+detection method.
.Pp
For every GPT partition a wedge is created and named after the
partition label.
-GPT partitions are UTF-16-encoded, this is converted into UTF-8.
+GPT partitions are UTF-16\(enencoded, this is converted into UTF-8.
If a partition has no label, its UUID is used instead.
+.\"
.It Dv DKWEDGE_METHOD_MBR
-IBM PC-compatible Master Boot Record (MBR) partitioning detection method,
-with support for Extended MBRs.
+IBM PC-compatible Master Boot Record
+.Tn ( MBR )
+partitioning detection method, with support for Extended MBRs.
.Pp
For every partition in the MBR a wedge is created and named like a
regular partition name, i.e. the device name, unit number and a
partition letter, for example
-.Dq wd0e .
+.Ql wd0e .
Primary partitions start with
-.Sq e ,
+.Ql e ,
extended partitions start with
-.Sq i .
+.Ql i .
+.\"
.It Dv DKWEDGE_METHOD_RDB
-Amiga Rigid Disk Block (RDB) partitioning detection method.
-.It Dv DKWEDGE_METHOD_APPLE
-Apple partition map detection method.
+Amiga Rigid Disk Block
+.Tn ( RDB )
+partitioning detection method.
+.\"
.It Dv DKWEDGE_METHOD_TOS
-Atari's TOS partition map detection method.
+Atari's
+.Tn TOS
+partition map detection method.
.Pp
For each partition, a wedge is created with a name of the format
-.Dq ATARI_{TYPE}_{NUMBER}
-where TYPE may either be
-.Dq GEM
+.Sm off
+.Li ATARI_ Bro Ar type Brc Li _ Bro Ar number Brc
+.Sm on
+where
+.Ar type
+may either be
+.Ql GEM
or
-.Dq BGM .
-The first partition typically corresponds to the C: drive when read on an
-actual Atari, the second to D: and so on. Extended partitions (those of type
-.Dq XGM )
+.Ql BGM .
+The first partition typically corresponds to the
+.Ql C:
+drive when read on an actual Atari, the second to
+.Ql D:
+and so on.
+Extended partitions
+.Pq those of type Ql XGM
are not currently supported.
.El
.Sh FILES
-.Bl -tag -width /dev/XXrXdkX -compact
-.It Pa /dev/{,r}dk*
+.Bl -tag -width Pa -compact
+.It Pa /dev/dk*
+Block mode
+.Nm
+device special files.
+.It Pa /dev/rdk*
+Raw mode
.Nm
device special files.
.El
Re: CVS commit: src
On Sat, Mar 30, 2024 at 23:20:38 -0400, Christos Zoulas wrote: > Restore the minimum build to install elfdefinitions.h. Provide a pre-built > copy, since we don't have m4 available. Use pax to install it because > using the Makefile needs more stuff available (nbsed) which we have not > built yet. I haven't looked, but on the surface that seems weird. m4 hardly needs elftoolchain to build, so why can't we reorder things? -uwe
CVS commit: src/usr.sbin/mountd
Module Name:src Committed By: uwe Date: Fri Mar 29 22:50:27 UTC 2024 Modified Files: src/usr.sbin/mountd: exports.5 Log Message: exports(5): mark up the list of groups to --maproot as optional To generate a diff of this commit: cvs rdiff -u -r1.38 -r1.39 src/usr.sbin/mountd/exports.5 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: Fri Mar 29 22:50:27 UTC 2024 Modified Files: src/usr.sbin/mountd: exports.5 Log Message: exports(5): mark up the list of groups to --maproot as optional To generate a diff of this commit: cvs rdiff -u -r1.38 -r1.39 src/usr.sbin/mountd/exports.5 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/exports.5 diff -u src/usr.sbin/mountd/exports.5:1.38 src/usr.sbin/mountd/exports.5:1.39 --- src/usr.sbin/mountd/exports.5:1.38 Fri Mar 29 14:15:02 2024 +++ src/usr.sbin/mountd/exports.5 Fri Mar 29 22:50:27 2024 @@ -1,4 +1,4 @@ -.\" $NetBSD: exports.5,v 1.38 2024/03/29 14:15:02 riastradh Exp $ +.\" $NetBSD: exports.5,v 1.39 2024/03/29 22:50:27 uwe Exp $ .\" .\" Copyright (c) 1989, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -155,7 +155,7 @@ on the local machine .Pc . The user may be specified by name or number. .Sm off -.It Fl maproot Li = Ar user\^ Li \&: Ar group1\^ Li \&: group2\^ Li \&: Ar ... +.It Fl maproot Li = Ar user\^ Li \&: Op Ar group1\^ Li \&: group2\^ Li \&: Ar ... .Sm on The colon separated list is used to specify the precise credential to be used for remote access by root. @@ -167,13 +167,13 @@ should be used to distinguish a credenti complete credential for that user. .Sm off .It Fl mapall Li = Ar user -.It Fl mapall Li = Ar user\^ Li \&: Ar group1\^ Li \&: Ar group2\^ Li \&: Ar ... +.It Fl mapall Li = Ar user\^ Li \&: Op Ar group1\^ Li \&: Ar group2\^ Li \&: Ar ... .Sm on Mapping for all client uids (including root) using the same semantics as .Fl maproot . .It Fl r Ar user -.It Fl r Ar user\^ Ns Li \&: Ns Ar group1\^ Ns Li \&: Ns Ar group2\^ Ns Li \&: Ns Ar ... +.It Fl r Ar user\^ Ns Li \&: Ns Op Ar group1\^ Ns Li \&: Ns Ar group2\^ Ns Li \&: Ns Ar ... Synonym for .Fl maproot , for compatibility with older export file formats.
CVS commit: src/usr.sbin/mountd
Module Name:src Committed By: uwe Date: Wed Mar 27 13:11:14 UTC 2024 Modified Files: src/usr.sbin/mountd: exports.5 Log Message: exports(5): improve mark up To generate a diff of this commit: cvs rdiff -u -r1.35 -r1.36 src/usr.sbin/mountd/exports.5 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 27 13:11:14 UTC 2024 Modified Files: src/usr.sbin/mountd: exports.5 Log Message: exports(5): improve mark up To generate a diff of this commit: cvs rdiff -u -r1.35 -r1.36 src/usr.sbin/mountd/exports.5 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/exports.5 diff -u src/usr.sbin/mountd/exports.5:1.35 src/usr.sbin/mountd/exports.5:1.36 --- src/usr.sbin/mountd/exports.5:1.35 Wed Mar 27 01:43:26 2024 +++ src/usr.sbin/mountd/exports.5 Wed Mar 27 13:11:14 2024 @@ -1,4 +1,4 @@ -.\" $NetBSD: exports.5,v 1.35 2024/03/27 01:43:26 riastradh Exp $ +.\" $NetBSD: exports.5,v 1.36 2024/03/27 13:11:14 uwe Exp $ .\" .\" Copyright (c) 1989, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -29,7 +29,7 @@ .\" .\" @(#)exports.5 8.3 (Berkeley) 3/29/95 .\" -.Dd October 8, 2006 +.Dd March 27, 2024 .Dt EXPORTS 5 .Os .Sh NAME @@ -55,16 +55,16 @@ Each entry in is a line with a list of directories followed by a list of hosts, netgroups, and options, separated by spaces or tabs: .Pp -.Dl Pf / Va dir "..." Oo Va host | Va netgroup | Fl Va option Oc "..." +.D1 Li / Ns Ar dir Li ... Oo Ar host | Ar netgroup | Fl Ar option Oc Li ... .Pp All directories in a single line must live in the same filesystem, which is exported to the hosts and netgroups listed, according to the options specified. Exported directories must not have pathname components that are symbolic links, -.Ql "." , +.Ql \&. , or -.Ql ".." . +.Ql \&.. . .Pp .Bf -symbolic Warning: @@ -110,8 +110,9 @@ must come before any hosts, netgroups, o Options begin with .Ql - . All other items on an export line are interpreted either as netgroups -(see -.Xr netgroup 5 ) +.Po see +.Xr netgroup 5 +.Pc or as hosts, which can be either names, as in example.com, or numbers, as in 192.0.2.123 or 2001:db8:1234:abcd::42. Sets of hosts in a contiguous network range can be specified with the @@ -129,7 +130,7 @@ options are exported to hosts on the network, with no access control. .Pp Supported export options: -.Bl -tag -width ".Fl noresvport" +.Bl -tag -width Fl .It Fl alldirs Allow mount requests from clients at any point within the filesystem, including regular files. @@ -144,39 +145,40 @@ A client can still access the whole filesystem via individual RPCs if it wanted to, even if just one subdirectory has been mounted. .Sm off -.It Fl maproot No = Ar user +.It Fl maproot Li = Ar user .Sm on The credential of the specified user is used for remote access by root. The credential includes all the groups to which the user is a member -on the local machine (see -.Xr id 1 ) . +on the local machine +.Po see +.Xr id 1 +.Pc . The user may be specified by name or number. .Sm off -.It Fl maproot No = Ar user : group1 : group2 : ... +.It Fl maproot Li = Ar user\^ Li \&: Ar group1\^ Li \&: group2\^ Li \&: Ar ... .Sm on The colon separated list is used to specify the precise credential to be used for remote access by root. The elements of the list may be either names or numbers. Note that -.Sm off -.Ql Ar user ":" -.Sm on +.Sq Ar user\^ Ns Li \&: +(with the trailing colon) should be used to distinguish a credential containing no groups from a complete credential for that user. .Sm off -.It Fl mapall No = Ar user -.It Fl mapall No = Ar user : group1 : group2 : ... +.It Fl mapall Li = Ar user +.It Fl mapall Li = Ar user\^ Li \&: Ar group1\^ Li \&: Ar group2\^ Li \&: Ar ... .Sm on Mapping for all client uids (including root) using the same semantics as .Fl maproot . .It Fl r Ar user -.It Fl r Ar user Ns : Ns Ar group1 Ns : Ns Ar group2 Ns : Ar ... +.It Fl r Ar user\^ Ns Li \&: Ns Ar group1\^ Ns Li \&: Ns Ar group2\^ Ns Li \&: Ns Ar ... Synonym for .Fl maproot , for compatibility with older export file formats. .Pp -Note: +.Em Note : Not a synonym for the read-only option .Fl ro . .El @@ -196,7 +198,7 @@ If a option is given, all users (including root) will be mapped to that credential in place of their own. -.Bl -tag -width ".Fl noresvport" +.Bl -tag -width Fl .It Fl kerb Specifies that the Kerberos authentication server should be used to authenticate and map client credentials. @@ -204,8 +206,11 @@ used to authenticate and map client cred .It Fl ro Export filesystem read-only. Clients will be forbidden to change or write to anything in the -filesystem (except for named pipes, sockets, and device nodes, where -write semantics is client-side anyway). +filesystem +.Po +except for named pipes, sockets, and device nodes, where +write semantics is client-side anyway +.Pc . .It Fl o Synonym for .Fl ro @@ -226,9 +231,7 @@ Using this option decreases the security (WebNFS) Enables WebNFS export, equivalent to combining .Fl public , -.Sm off -.Fl mapall No = Ar nobody , -.Sm on +.Fl mapall=nobody , and .Fl ro . .It Fl
CVS commit: src/distrib/notes/common
Module Name:src Committed By: uwe Date: Mon Mar 25 13:35:28 UTC 2024 Modified Files: src/distrib/notes/common: main Log Message: distrib/notes: add back the sentence final dot after .Lk It was omitted in previous b/c of a bug in .Lk that was fixed in PR bin/58074 To generate a diff of this commit: cvs rdiff -u -r1.574 -r1.575 src/distrib/notes/common/main Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/distrib/notes/common/main diff -u src/distrib/notes/common/main:1.574 src/distrib/notes/common/main:1.575 --- src/distrib/notes/common/main:1.574 Sun Mar 24 13:18:02 2024 +++ src/distrib/notes/common/main Mon Mar 25 13:35:28 2024 @@ -1,4 +1,4 @@ -.\" $NetBSD: main,v 1.574 2024/03/24 13:18:02 martin Exp $ +.\" $NetBSD: main,v 1.575 2024/03/25 13:35:28 uwe Exp $ .\" .\" Copyright (c) 1999-2012 The NetBSD Foundation, Inc. .\" All rights reserved. @@ -482,7 +482,7 @@ The system architectures, with preliminary support for the others included in source form. For more information please visit -.Lk https://www.NetBSD.org/ +.Lk https://www.NetBSD.org/ . .Pp .Nx is a completely integrated system.
CVS commit: src/distrib/notes/common
Module Name:src Committed By: uwe Date: Mon Mar 25 13:35:28 UTC 2024 Modified Files: src/distrib/notes/common: main Log Message: distrib/notes: add back the sentence final dot after .Lk It was omitted in previous b/c of a bug in .Lk that was fixed in PR bin/58074 To generate a diff of this commit: cvs rdiff -u -r1.574 -r1.575 src/distrib/notes/common/main Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/external/gpl2/groff/dist/tmac
Module Name:src
Committed By: uwe
Date: Sun Mar 24 23:39:21 UTC 2024
Modified Files:
src/external/gpl2/groff/dist/tmac: doc.tmac
Log Message:
doc.tmac: .Lk - handle punctuation without anchor-text correctly
doc-get-arg-type expects that doc-width is set beforehand, so call
doc-get-width to make sure doc-get-arg-type detects the trailing
punctuation correctly.
PR bin/58074
To generate a diff of this commit:
cvs rdiff -u -r1.2 -r1.3 src/external/gpl2/groff/dist/tmac/doc.tmac
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/external/gpl2/groff/dist/tmac/doc.tmac
diff -u src/external/gpl2/groff/dist/tmac/doc.tmac:1.2 src/external/gpl2/groff/dist/tmac/doc.tmac:1.3
--- src/external/gpl2/groff/dist/tmac/doc.tmac:1.2 Wed Jan 13 19:01:59 2016
+++ src/external/gpl2/groff/dist/tmac/doc.tmac Sun Mar 24 23:39:21 2024
@@ -6416,6 +6416,7 @@
. ds doc-str-Lk Sy \$@
.
. ie (\n[.$] > 1) \{\
+.doc-get-width \$2
.doc-get-arg-type \$2
.ie (\n[doc-arg-type] < 3) \{\
. Em \)\$2:
CVS commit: src/external/gpl2/groff/dist/tmac
Module Name:src Committed By: uwe Date: Sun Mar 24 23:39:21 UTC 2024 Modified Files: src/external/gpl2/groff/dist/tmac: doc.tmac Log Message: doc.tmac: .Lk - handle punctuation without anchor-text correctly doc-get-arg-type expects that doc-width is set beforehand, so call doc-get-width to make sure doc-get-arg-type detects the trailing punctuation correctly. PR bin/58074 To generate a diff of this commit: cvs rdiff -u -r1.2 -r1.3 src/external/gpl2/groff/dist/tmac/doc.tmac Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
Re: CVS commit: src/games/larn
On Sun, Mar 24, 2024 at 21:21:39 +0200, Andrius V wrote: > Can you a bit clarify the meaning of "8 space tabs" This is what VT set up screen called "Set 8 Column Tabs", i.e. "set one tab every eight columns, starting at column 9" which was the default setting. https://vt100.net/docs/tp83/chapter4.html#T4-11 https://vt100.net/docs/vt420-uu/chapter5.html#S5.11 Emacs calls this tab-width. vi, I believe calls it tabstop. Both default to 8. I know this is a subject that people are often religious about, but I think it's reasonable to require that when a file is cat(1) to the terminal (say, vt220) or an emulator (say, xterm) in it's default state, it displays as intended. > since file is not exactly following any completely defined pattern. I haven't looked at the rest of the file too closely, but the indented multi-line comments I referred to are definitely meant to be viewed with 8 space tabs and in general the 8 space tabs are the default (see above). If some parts of that file deviate from that they should be fixed, but I was referring specifically to your change that looks like this with the default 8 column tabs (untabified to ensure that it's displayed the same regardless of the viewer's tab settings): * setupvt100() Subroutine to set up terminal in correct mode for game * clearvt100() Subroutine to clean up terminal when the game is over * ttgetch()Routine to read in one character from the terminal * scbr() Function to set cbreak -echo for the terminal * sncbr() Function to set -cbreak echo for the terminal * newgame()Subroutine to save the initial time and seed rnd() That text looks aligned with 4 column tabs (again, the text below is untabified): * setupvt100() Subroutine to set up terminal in correct mode for game * clearvt100() Subroutine to clean up terminal when the game is over * ttgetch()Routine to read in one character from the terminal * scbr() Function to set cbreak -echo for the terminal * sncbr() Function to set -cbreak echo for the terminal * newgame()Subroutine to save the initial time and seed rnd() If you would like to go and fix the rest of the file, that would be nice, but my request was to at least not introduce more non-standart tabs. Thanks! -uwe
CVS commit: src/share/man/man4
Module Name:src Committed By: uwe Date: Sun Mar 24 00:45:06 UTC 2024 Modified Files: src/share/man/man4: wg.4 Log Message: wg(4): specify 4 space offsets as 4n To generate a diff of this commit: cvs rdiff -u -r1.9 -r1.10 src/share/man/man4/wg.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: Sun Mar 24 00:45:06 UTC 2024 Modified Files: src/share/man/man4: wg.4 Log Message: wg(4): specify 4 space offsets as 4n To generate a diff of this commit: cvs rdiff -u -r1.9 -r1.10 src/share/man/man4/wg.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/wg.4 diff -u src/share/man/man4/wg.4:1.9 src/share/man/man4/wg.4:1.10 --- src/share/man/man4/wg.4:1.9 Sat Mar 23 21:34:07 2024 +++ src/share/man/man4/wg.4 Sun Mar 24 00:45:06 2024 @@ -1,4 +1,4 @@ -.\" $NetBSD: wg.4,v 1.9 2024/03/23 21:34:07 riastradh Exp $ +.\" $NetBSD: wg.4,v 1.10 2024/03/24 00:45:06 uwe Exp $ .\" .\" Copyright (c) 2020 The NetBSD Foundation, Inc. .\" All rights reserved. @@ -74,7 +74,7 @@ endpoint IP address outside the tunnel. .\" .Sh EXAMPLES Typical network topology: -.Bd -literal -offset abcd +.Bd -literal -offset 4n Stationary server: Roaming client: +-++-+ |A||B| @@ -96,7 +96,7 @@ Stationary server: .Ed .Pp Generate key pairs on A and B: -.Bd -literal -offset abcd +.Bd -literal -offset 4n A# (umask 0077; wg-keygen > /etc/wg/wg0) A# wg-keygen --pub < /etc/wg/wg0 > /etc/wg/wg0.pub A# cat /etc/wg/wg0.pub @@ -111,13 +111,13 @@ X7EGm3T3IfodBcyilkaC89j0SH3XD6+/pwvp7Dgp Generate a pre-shared key on A and copy it to B to defend against potential future quantum cryptanalysis (not necessary for functionality): -.Bd -literal -offset abcd +.Bd -literal -offset 4n A# (umask 0077; wg-keygen > /etc/wg/wg0.A-B) .Ed .Pp Configure A to listen on port 1234 and allow connections from B to appear in the 10.2.0.0/24 and fd00:2::/64 subnets: -.Bd -literal -offset abcd +.Bd -literal -offset 4n A# ifconfig wg0 create A# ifconfig wg0 inet 10.2.0.1/24 A# ifconfig wg0 inet6 fd00:2::1/64 @@ -138,7 +138,7 @@ wg0: flags=0x8041 .Pp Configure B to connect to A at 192.0.2.123 on port 1234 and the packets can begin to flow: -.Bd -literal -offset abcd +.Bd -literal -offset 4n B# ifconfig wg0 create B# ifconfig wg0 inet 10.2.0.42/24 B# ifconfig wg0 inet6 fd00:2::42/64
Re: CVS commit: src/games/larn
On Sat, Mar 23, 2024 at 21:10:45 +, Andrius Varanavicius wrote: > Modified Files: > src/games/larn: io.c > > Log Message: > Attempt to fix descriptions of the routines in the initial comment block. Please, can you fix this to use 8 space tabs as the rest of the file does, as can be verified by multiline comments formatted as /* ... * ... */ -uwe
CVS commit: src/lib/libc/gen
Module Name:src Committed By: uwe Date: Thu Mar 21 22:27:55 UTC 2024 Modified Files: src/lib/libc/gen: sysconf.3 Log Message: sysconf(3): a few more markup fixes To generate a diff of this commit: cvs rdiff -u -r1.56 -r1.57 src/lib/libc/gen/sysconf.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/sysconf.3 diff -u src/lib/libc/gen/sysconf.3:1.56 src/lib/libc/gen/sysconf.3:1.57 --- src/lib/libc/gen/sysconf.3:1.56 Thu Mar 21 22:21:40 2024 +++ src/lib/libc/gen/sysconf.3 Thu Mar 21 22:27:55 2024 @@ -1,4 +1,4 @@ -.\" $NetBSD: sysconf.3,v 1.56 2024/03/21 22:21:40 uwe Exp $ +.\" $NetBSD: sysconf.3,v 1.57 2024/03/21 22:27:55 uwe Exp $ .\" .\" Copyright (c) 1993 .\" The Regents of the University of California. All rights reserved. @@ -90,7 +90,7 @@ The maximum size of a hostname, includin .Tn NUL . .It Dv _SC_IOV_MAX The maximum number of -.Va iovec +.Vt iovec structures that a process has available for use with .Xr preadv 2 , .Xr pwritev 2 , @@ -189,11 +189,13 @@ Timers option to which the system attempts to conform, otherwise \-1. .It Dv _SC_CPUTIME -The clockID CLOCK_PROCESS_CPUTIME_ID is supported, -otherwise \-1. +The clockID +.Dv CLOCK_PROCESS_CPUTIME_ID +is supported, otherwise \-1. .It Dv _SC_THREAD_CPUTIME -The clockID CLOCK_THREAD_CPUTIME_ID is supported, -otherwise \-1. +The clockID +.Dv CLOCK_THREAD_CPUTIME_ID +is supported, otherwise \-1. .It Dv _SC_DELAYTIMER_MAX The maximum number of overrun for a specific timer, otherwise \-1. @@ -352,6 +354,9 @@ The function first appeared in .Bx 4.4 . .Sh BUGS -The value for _SC_STREAM_MAX is a minimum maximum, and required to be -the same as ANSI C's FOPEN_MAX, so the returned value is a ridiculously -small and misleading number. +The value for +.Dv _SC_STREAM_MAX +is a minimum maximum, and required to be the same as +.Tn ANSI C Ap s +.Dv FOPEN_MAX , +so the returned value is a ridiculously small and misleading number.
CVS commit: src/lib/libc/gen
Module Name:src Committed By: uwe Date: Thu Mar 21 22:27:55 UTC 2024 Modified Files: src/lib/libc/gen: sysconf.3 Log Message: sysconf(3): a few more markup fixes To generate a diff of this commit: cvs rdiff -u -r1.56 -r1.57 src/lib/libc/gen/sysconf.3 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: Thu Mar 21 22:21:40 UTC 2024 Modified Files: src/lib/libc/gen: sysconf.3 Log Message: sysconf(3): the _SC constants are .Dv To generate a diff of this commit: cvs rdiff -u -r1.55 -r1.56 src/lib/libc/gen/sysconf.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/sysconf.3 diff -u src/lib/libc/gen/sysconf.3:1.55 src/lib/libc/gen/sysconf.3:1.56 --- src/lib/libc/gen/sysconf.3:1.55 Thu Mar 21 22:17:27 2024 +++ src/lib/libc/gen/sysconf.3 Thu Mar 21 22:21:40 2024 @@ -1,4 +1,4 @@ -.\" $NetBSD: sysconf.3,v 1.55 2024/03/21 22:17:27 uwe Exp $ +.\" $NetBSD: sysconf.3,v 1.56 2024/03/21 22:21:40 uwe Exp $ .\" .\" Copyright (c) 1993 .\" The Regents of the University of California. All rights reserved. @@ -58,37 +58,37 @@ Symbolic constants for each name value a .In unistd.h . .Pp The available values are as follows: -.Bl -tag -width "123456" -.It Li _SC_ARG_MAX +.Bl -tag -width Dv +.It Dv _SC_ARG_MAX The maximum bytes of argument to .Xr execve 2 . -.It Li _SC_ATEXIT_MAX +.It Dv _SC_ATEXIT_MAX The maximum number of functions that may be registered with .Xr atexit 3 . -.It Li _SC_BARRIERS +.It Dv _SC_BARRIERS The version of .St -p1003.1 and its Barriers option to which the system attempts to conform, otherwise \-1. -.It Li _SC_CLOCK_SELECTION +.It Dv _SC_CLOCK_SELECTION Return the .Tn POSIX version the implementation of the Clock Selection option on this system conforms to, or \-1 if unavailable. -.It Li _SC_CHILD_MAX +.It Dv _SC_CHILD_MAX The maximum number of simultaneous processes per user id. -.It Li _SC_CLK_TCK +.It Dv _SC_CLK_TCK The number of clock ticks per second. -.It Li _SC_FSYNC +.It Dv _SC_FSYNC Return 1 if the File Synchronization option is available on this system, otherwise \-1. -.It Li _SC_HOST_NAME_MAX +.It Dv _SC_HOST_NAME_MAX The maximum size of a hostname, including the terminating .Tn NUL . -.It Li _SC_IOV_MAX +.It Dv _SC_IOV_MAX The maximum number of .Va iovec structures that a process has available for use with @@ -99,114 +99,114 @@ structures that a process has available .Xr sendmsg 2 or .Xr writev 2 . -.It Li _SC_JOB_CONTROL +.It Dv _SC_JOB_CONTROL Return 1 if job control is available on this system, otherwise \-1. -.It Li _SC_LOGIN_NAME_MAX +.It Dv _SC_LOGIN_NAME_MAX Returns the size of the storage required for a login name, in bytes, including the terminating .Tn NUL . -.It Li _SC_MAPPED_FILES +.It Dv _SC_MAPPED_FILES Return 1 if the Memory Mapped Files option is available on this system, otherwise \-1. -.It Li _SC_MEMLOCK +.It Dv _SC_MEMLOCK Return 1 if the Process Memory Locking option is available on this system, otherwise \-1. -.It Li _SC_MEMLOCK_RANGE +.It Dv _SC_MEMLOCK_RANGE Return 1 if the Range Memory Locking option is available on this system, otherwise \-1. -.It Li _SC_MEMORY_PROTECTION +.It Dv _SC_MEMORY_PROTECTION Return 1 if the Memory Protection option is available on this system, otherwise \-1. -.It Li _SC_MONOTONIC_CLOCK +.It Dv _SC_MONOTONIC_CLOCK Return the .Tn POSIX version the implementation of the Monotonic Clock option on this system conforms to, or \-1 if unavailable. -.It Li _SC_NGROUPS_MAX +.It Dv _SC_NGROUPS_MAX The maximum number of supplemental groups. -.It Li _SC_OPEN_MAX +.It Dv _SC_OPEN_MAX The maximum number of open files per process. -.It Li _SC_PAGESIZE +.It Dv _SC_PAGESIZE The size of a system page in bytes. -.It Li _SC_PASS_MAX +.It Dv _SC_PASS_MAX The maximum length of the password, not counting the terminating .Tn NUL . -.It Li _SC_READER_WRITER_LOCKS +.It Dv _SC_READER_WRITER_LOCKS The version of .St -p1003.1 and its Read-Write Locks option to which the system attempts to conform, otherwise \-1. -.It Li _SC_REGEXP +.It Dv _SC_REGEXP Return 1 if .Tn POSIX regular expressions are available on this system, otherwise \-1. -.It Li _SC_SEMAPHORES +.It Dv _SC_SEMAPHORES The version of .St -p1003.1 and its Semaphores option to which the system attempts to conform, otherwise \-1. -.It Li _SC_SEM_NSEMS_MAX +.It Dv _SC_SEM_NSEMS_MAX The maximum number of semaphores that one process can have open at a time, otherwise \-1. -.It Li _SC_SHELL +.It Dv _SC_SHELL Return 1 if .Tn POSIX shell is available on this system, otherwise \-1. -.It Li _SC_SPIN_LOCKS +.It Dv _SC_SPIN_LOCKS The version of .St -p1003.1 and its Spin Locks option to which the system attempts to conform, otherwise \-1. -.It Li _SC_STREAM_MAX +.It Dv _SC_STREAM_MAX The minimum maximum number of streams that a process may have open at any one time. -.It Li _SC_SYMLOOP_MAX +.It Dv _SC_SYMLOOP_MAX The maximum number of symbolic links that may be expanded in a path name. -.It Li _SC_SYNCHRONIZED_IO +.It Dv _SC_SYNCHRONIZED_IO Return 1 if the Synchronized I/O option is available on this system, otherwise \-1. -.It Li _SC_THREADS +.It Dv _SC_THREADS The
CVS commit: src/lib/libc/gen
Module Name:src Committed By: uwe Date: Thu Mar 21 22:21:40 UTC 2024 Modified Files: src/lib/libc/gen: sysconf.3 Log Message: sysconf(3): the _SC constants are .Dv To generate a diff of this commit: cvs rdiff -u -r1.55 -r1.56 src/lib/libc/gen/sysconf.3 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: Thu Mar 21 22:17:27 UTC 2024 Modified Files: src/lib/libc/gen: sysconf.3 Log Message: sysconf(3): NUL is not a defined variable To generate a diff of this commit: cvs rdiff -u -r1.54 -r1.55 src/lib/libc/gen/sysconf.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/sysconf.3 diff -u src/lib/libc/gen/sysconf.3:1.54 src/lib/libc/gen/sysconf.3:1.55 --- src/lib/libc/gen/sysconf.3:1.54 Thu Mar 21 22:14:29 2024 +++ src/lib/libc/gen/sysconf.3 Thu Mar 21 22:17:27 2024 @@ -1,4 +1,4 @@ -.\" $NetBSD: sysconf.3,v 1.54 2024/03/21 22:14:29 uwe Exp $ +.\" $NetBSD: sysconf.3,v 1.55 2024/03/21 22:17:27 uwe Exp $ .\" .\" Copyright (c) 1993 .\" The Regents of the University of California. All rights reserved. @@ -87,7 +87,7 @@ Return 1 if the File Synchronization opt otherwise \-1. .It Li _SC_HOST_NAME_MAX The maximum size of a hostname, including the terminating -.Dv NUL . +.Tn NUL . .It Li _SC_IOV_MAX The maximum number of .Va iovec @@ -104,7 +104,7 @@ Return 1 if job control is available on .It Li _SC_LOGIN_NAME_MAX Returns the size of the storage required for a login name, in bytes, including the terminating -.Dv NUL . +.Tn NUL . .It Li _SC_MAPPED_FILES Return 1 if the Memory Mapped Files option is available on this system, otherwise \-1. @@ -131,7 +131,7 @@ The maximum number of open files per pro The size of a system page in bytes. .It Li _SC_PASS_MAX The maximum length of the password, not counting the terminating -.Dv NUL . +.Tn NUL . .It Li _SC_READER_WRITER_LOCKS The version of .St -p1003.1
CVS commit: src/lib/libc/gen
Module Name:src Committed By: uwe Date: Thu Mar 21 22:17:27 UTC 2024 Modified Files: src/lib/libc/gen: sysconf.3 Log Message: sysconf(3): NUL is not a defined variable To generate a diff of this commit: cvs rdiff -u -r1.54 -r1.55 src/lib/libc/gen/sysconf.3 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: Thu Mar 21 22:14:29 UTC 2024 Modified Files: src/lib/libc/gen: sysconf.3 Log Message: sysconf(3): POSIX text doesn't capitalize "option". To generate a diff of this commit: cvs rdiff -u -r1.53 -r1.54 src/lib/libc/gen/sysconf.3 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: Thu Mar 21 22:14:29 UTC 2024 Modified Files: src/lib/libc/gen: sysconf.3 Log Message: sysconf(3): POSIX text doesn't capitalize "option". To generate a diff of this commit: cvs rdiff -u -r1.53 -r1.54 src/lib/libc/gen/sysconf.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/sysconf.3 diff -u src/lib/libc/gen/sysconf.3:1.53 src/lib/libc/gen/sysconf.3:1.54 --- src/lib/libc/gen/sysconf.3:1.53 Thu Mar 21 14:48:01 2024 +++ src/lib/libc/gen/sysconf.3 Thu Mar 21 22:14:29 2024 @@ -1,4 +1,4 @@ -.\" $NetBSD: sysconf.3,v 1.53 2024/03/21 14:48:01 wiz Exp $ +.\" $NetBSD: sysconf.3,v 1.54 2024/03/21 22:14:29 uwe Exp $ .\" .\" Copyright (c) 1993 .\" The Regents of the University of California. All rights reserved. @@ -75,7 +75,7 @@ otherwise \-1. .It Li _SC_CLOCK_SELECTION Return the .Tn POSIX -version the implementation of the Clock Selection Option +version the implementation of the Clock Selection option on this system conforms to, or \-1 if unavailable. .It Li _SC_CHILD_MAX @@ -83,7 +83,7 @@ The maximum number of simultaneous proce .It Li _SC_CLK_TCK The number of clock ticks per second. .It Li _SC_FSYNC -Return 1 if the File Synchronization Option is available on this system, +Return 1 if the File Synchronization option is available on this system, otherwise \-1. .It Li _SC_HOST_NAME_MAX The maximum size of a hostname, including the terminating @@ -106,21 +106,21 @@ Returns the size of the storage required including the terminating .Dv NUL . .It Li _SC_MAPPED_FILES -Return 1 if the Memory Mapped Files Option is available on this system, +Return 1 if the Memory Mapped Files option is available on this system, otherwise \-1. .It Li _SC_MEMLOCK -Return 1 if the Process Memory Locking Option is available on this system, +Return 1 if the Process Memory Locking option is available on this system, otherwise \-1. .It Li _SC_MEMLOCK_RANGE -Return 1 if the Range Memory Locking Option is available on this system, +Return 1 if the Range Memory Locking option is available on this system, otherwise \-1. .It Li _SC_MEMORY_PROTECTION -Return 1 if the Memory Protection Option is available on this system, +Return 1 if the Memory Protection option is available on this system, otherwise \-1. .It Li _SC_MONOTONIC_CLOCK Return the .Tn POSIX -version the implementation of the Monotonic Clock Option +version the implementation of the Monotonic Clock option on this system conforms to, or \-1 if unavailable. .It Li _SC_NGROUPS_MAX @@ -170,7 +170,7 @@ at any one time. .It Li _SC_SYMLOOP_MAX The maximum number of symbolic links that may be expanded in a path name. .It Li _SC_SYNCHRONIZED_IO -Return 1 if the Synchronized I/O Option is available on this system, +Return 1 if the Synchronized I/O option is available on this system, otherwise \-1. .It Li _SC_THREADS The version of @@ -252,26 +252,26 @@ permitted when using interval notation. The version of POSIX 1003.2 with which the system attempts to comply. .It Li _SC_2_C_BIND Return 1 if the system's C-language development facilities support the -C-Language Bindings Option, otherwise \-1. +C-Language Bindings option, otherwise \-1. .It Li _SC_2_C_DEV -Return 1 if the system supports the C-Language Development Utilities Option, +Return 1 if the system supports the C-Language Development Utilities option, otherwise \-1. .It Li _SC_2_CHAR_TERM Return 1 if the system supports at least one terminal type capable of all operations described in POSIX 1003.2, otherwise \-1. .It Li _SC_2_FORT_DEV -Return 1 if the system supports the FORTRAN Development Utilities Option, +Return 1 if the system supports the FORTRAN Development Utilities option, otherwise \-1. .It Li _SC_2_FORT_RUN -Return 1 if the system supports the FORTRAN Runtime Utilities Option, +Return 1 if the system supports the FORTRAN Runtime Utilities option, otherwise \-1. .It Li _SC_2_LOCALEDEF Return 1 if the system supports the creation of locales, otherwise \-1. .It Li _SC_2_SW_DEV -Return 1 if the system supports the Software Development Utilities Option, +Return 1 if the system supports the Software Development Utilities option, otherwise \-1. .It Li _SC_2_UPE -Return 1 if the system supports the User Portability Utilities Option, +Return 1 if the system supports the User Portability Utilities option, otherwise \-1. .It Li _SC_GETGR_R_SIZE_MAX The minimum size of the
CVS commit: src/share/man/man4
Module Name:src Committed By: uwe Date: Thu Mar 21 11:17:13 UTC 2024 Modified Files: src/share/man/man4: acpihed.4 Log Message: acpihed(4): fix name in Dt, use Ql To generate a diff of this commit: cvs rdiff -u -r1.1 -r1.2 src/share/man/man4/acpihed.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/acpihed.4 diff -u src/share/man/man4/acpihed.4:1.1 src/share/man/man4/acpihed.4:1.2 --- src/share/man/man4/acpihed.4:1.1 Thu Mar 21 02:36:01 2024 +++ src/share/man/man4/acpihed.4 Thu Mar 21 11:17:13 2024 @@ -1,4 +1,4 @@ -.\" $NetBSD: acpihed.4,v 1.1 2024/03/21 02:36:01 riastradh Exp $ +.\" $NetBSD: acpihed.4,v 1.2 2024/03/21 11:17:13 uwe Exp $ .\" .\" Copyright (c) 2024 The NetBSD Foundation, Inc. .\" All rights reserved. @@ -25,7 +25,7 @@ .\" POSSIBILITY OF SUCH DAMAGE. .\" .Dd March 18, 2024 -.Dt APEI 4 +.Dt ACPIHED 4 .Os .\" .Sh NAME @@ -38,8 +38,11 @@ .Sh DESCRIPTION Certain hardware error sources that can be queried by .Xr apei 4 -notify an ACPI node with PNP ID -.Sq Li PNP0C33 +notify an +.Tn ACPI +node with +.Tn PNP ID +.Ql PNP0C33 when an error occurs. The .Nm
CVS commit: src/share/man/man4
Module Name:src Committed By: uwe Date: Thu Mar 21 11:17:13 UTC 2024 Modified Files: src/share/man/man4: acpihed.4 Log Message: acpihed(4): fix name in Dt, use Ql To generate a diff of this commit: cvs rdiff -u -r1.1 -r1.2 src/share/man/man4/acpihed.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/man3
Module Name:src
Committed By: uwe
Date: Sat Mar 9 15:21:38 UTC 2024
Modified Files:
src/share/man/man3: dlfcn.3
Log Message:
dlfcn(3): touch up markup
To generate a diff of this commit:
cvs rdiff -u -r1.40 -r1.41 src/share/man/man3/dlfcn.3
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/man3/dlfcn.3
diff -u src/share/man/man3/dlfcn.3:1.40 src/share/man/man3/dlfcn.3:1.41
--- src/share/man/man3/dlfcn.3:1.40 Thu Mar 7 22:14:20 2024
+++ src/share/man/man3/dlfcn.3 Sat Mar 9 15:21:38 2024
@@ -1,4 +1,4 @@
-.\" $NetBSD: dlfcn.3,v 1.40 2024/03/07 22:14:20 christos Exp $
+.\" $NetBSD: dlfcn.3,v 1.41 2024/03/09 15:21:38 uwe Exp $
.\"
.\" Copyright (c) 1998 The NetBSD Foundation, Inc.
.\" All rights reserved.
@@ -74,7 +74,9 @@ The
.Fn _dlauxinfo
function returns a pointer to the
.Xr elf 5
-array of AuxInfo structures for the current executable.
+array of
+.Vt AuxInfo
+structures for the current executable.
.Pp
The
.Fn dlopen
@@ -88,14 +90,16 @@ only the path provided will be searched.
When just a shared object name is specified, the same search rules apply that
are used for
.Dq intrinsic
-shared object searches.
+shared object searches
.Po
see
.Xr ld.elf_so 1
-.Pc
+.Pc .
.Pp
Shared libraries take the following form:
-.Do lib Ns Ao name Ac Ns .so Ns Oo .xx Ns Oo .yy Oc Oc Dc .
+.Sm off
+.Ic lib\^ Ao Ar name Ac Ic .so Oo Ic \&. Ar xx\^ Oo Ic \&. Ar yy\^ Oc Oc .
+.Sm on
.Pp
The shared object is mapped into the address space, relocated, and
its external references are resolved in the same way as is done
@@ -134,8 +138,9 @@ other objects.
This is the default value if visibility is unspecified.
.El
.Pp
-To specify both resolution time and visibility, bitwise inclusive OR one of
-each of the above values together.
+To specify both resolution time and visibility, bitwise inclusive
+.Tn OR
+one of each of the above values together.
If an object was opened with
.Dv RTLD_LOCAL
and later opened with
@@ -143,7 +148,9 @@ and later opened with
then it is promoted to
.Dv RTLD_GLOBAL .
.Pp
-Additionally, one of the following flags may be ORed into the
+Additionally, one of the following flags may be
+.Tn OR Ap ed
+into the
.Fa mode
argument:
.Bl -tag -width ".Dv RTLD_NODELETE" -offset indent
@@ -272,8 +279,7 @@ is between the base address of the share
symbol
.Va _end
in the same shared object.
-If no object for which this condition holds
-true can be found,
+If no object for which this condition holds true can be found,
.Fn dladdr
will return 0.
Otherwise, a non-zero value is returned and the
@@ -295,11 +301,11 @@ typedef struct {
.Ed
.Pp
The structure members are further described as follows:
-.Bl -tag -width "Va"
-.It Va dli_fname
+.Bl -tag -width Fa
+.It Fa dli_fname
The pathname of the shared object containing the address
.Fa addr .
-.It Va dli_fbase
+.It Fa dli_fbase
The base address at which this shared object is loaded in the process
address space.
This may be zero if the symbol was found in the internally generated
@@ -310,18 +316,19 @@ see
.Xr link 5
.Pc
which is not associated with a file.
-.It Va dli_sname
+.It Fa dli_sname
points at the nul-terminated name of the selected symbol
-.It Va dli_saddr
+.It Fa dli_saddr
is the actual address
.Pq as it appears in the process address space
of the symbol.
.El
.Pp
-Note: both strings pointed at by
-.Va dli_fname
+.Em Note :
+both strings pointed at by
+.Fa dli_fname
and
-.Va dli_sname
+.Fa dli_sname
reside in memory private to the run-time linker module and should not
be modified by the caller.
.Pp
@@ -353,11 +360,14 @@ a second time, immediately following a p
.Dv NULL
being returned.
.Sh ERRORS
-The error
-.Dq Cannot dlopen non-loadable /usr/lib/libpthread.so.1
-is generated when a program
-.Fn dlopen Ns No s
-a module that needs libpthread but isn't linked against it itself.
+.Bl -diag
+.It Cannot dlopen non-loadable /usr/lib/libpthread.so.1
+A program tries to
+.Fn dlopen
+a module that needs
+.Lb libpthread
+but the program isn't linked against it itself.
+.El
.Sh SEE ALSO
.Xr ld 1 ,
.Xr rtld 1 ,
@@ -366,4 +376,4 @@ a module that needs libpthread but isn't
.Sh HISTORY
Some of the
.Nm dl*
-functions first appeared in SunOS 4.
+functions first appeared in SunOS\~4.
CVS commit: src/share/man/man3
Module Name:src Committed By: uwe Date: Sat Mar 9 15:21:38 UTC 2024 Modified Files: src/share/man/man3: dlfcn.3 Log Message: dlfcn(3): touch up markup To generate a diff of this commit: cvs rdiff -u -r1.40 -r1.41 src/share/man/man3/dlfcn.3 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/share/man/man8/man8.macppc
Module Name:src Committed By: uwe Date: Sat Mar 2 00:03:20 UTC 2024 Modified Files: src/share/man/man8/man8.macppc: ofwboot.8 Log Message: ofwboot(8): correct previous example To generate a diff of this commit: cvs rdiff -u -r1.16 -r1.17 src/share/man/man8/man8.macppc/ofwboot.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/man8/man8.macppc
Module Name:src Committed By: uwe Date: Sat Mar 2 00:03:20 UTC 2024 Modified Files: src/share/man/man8/man8.macppc: ofwboot.8 Log Message: ofwboot(8): correct previous example To generate a diff of this commit: cvs rdiff -u -r1.16 -r1.17 src/share/man/man8/man8.macppc/ofwboot.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/man8/man8.macppc/ofwboot.8 diff -u src/share/man/man8/man8.macppc/ofwboot.8:1.16 src/share/man/man8/man8.macppc/ofwboot.8:1.17 --- src/share/man/man8/man8.macppc/ofwboot.8:1.16 Fri Mar 1 22:35:56 2024 +++ src/share/man/man8/man8.macppc/ofwboot.8 Sat Mar 2 00:03:20 2024 @@ -1,4 +1,4 @@ -.\" $NetBSD: ofwboot.8,v 1.16 2024/03/01 22:35:56 uwe Exp $ +.\" $NetBSD: ofwboot.8,v 1.17 2024/03/02 00:03:20 uwe Exp $ .\" .\" Copyright (c) 2001 The NetBSD Foundation, Inc. .\" All rights reserved. @@ -330,7 +330,6 @@ Boot the kernel named .Pa netbsd.new from partition .Dq Pa a -.Pq Ql 0 of the hard disk into .Xr ddb 4 using @@ -338,7 +337,7 @@ using version of .Nm from the USB flash drive: -.Dl 0 > boot usb0/disk:,\eofwboot.elf hd:0/netbsd.new -d +.Dl 0 > boot usb0/disk:,\eofwboot.elf hd/netbsd.new -d . .It Boot from bootable CDROM with Open Firmware 3 or higher:
CVS commit: src/share/man/man8/man8.macppc
Module Name:src Committed By: uwe Date: Fri Mar 1 22:35:56 UTC 2024 Modified Files: src/share/man/man8/man8.macppc: ofwboot.8 Log Message: ofwboot(8): add some practical examples The system you want to boot into the single user mode is probably the default installation, so a simple "boot -s" is enough for that. Don't be redundant and scary. Also provide an example that uses full syntax for the kernel name. It is confusingly similar to the OFW syntax for boot-device yet different. That example also demonstrates how one might test a different version of ofwboot. To generate a diff of this commit: cvs rdiff -u -r1.15 -r1.16 src/share/man/man8/man8.macppc/ofwboot.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/man8/man8.macppc/ofwboot.8 diff -u src/share/man/man8/man8.macppc/ofwboot.8:1.15 src/share/man/man8/man8.macppc/ofwboot.8:1.16 --- src/share/man/man8/man8.macppc/ofwboot.8:1.15 Sat Feb 3 14:15:51 2024 +++ src/share/man/man8/man8.macppc/ofwboot.8 Fri Mar 1 22:35:56 2024 @@ -1,4 +1,4 @@ -.\" $NetBSD: ofwboot.8,v 1.15 2024/02/03 14:15:51 uwe Exp $ +.\" $NetBSD: ofwboot.8,v 1.16 2024/03/01 22:35:56 uwe Exp $ .\" .\" Copyright (c) 2001 The NetBSD Foundation, Inc. .\" All rights reserved. @@ -27,7 +27,7 @@ .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE .\" POSSIBILITY OF SUCH DAMAGE. .\" -.Dd August 18, 2001 +.Dd March 1, 2024 .Dt OFWBOOT 8 macppc .Os .Sh NAME @@ -315,6 +315,10 @@ is the Open Firmware prompt. .Bl -item . .It +Boot the default installation into single user mode. +.Dl 0 > boot -s +. +.It Boot an Open Firmware 3 system, with .Ar netbsd installed on partition @@ -322,8 +326,19 @@ installed on partition .Dl 0 > boot hd:,ofwboot.xcf . .It -Boot into single user mode: -.Dl 0 > boot hd:,ofwboot.xcf netbsd -s +Boot the kernel named +.Pa netbsd.new +from partition +.Dq Pa a +.Pq Ql 0 +of the hard disk into +.Xr ddb 4 +using +.Tn ELF +version of +.Nm +from the USB flash drive: +.Dl 0 > boot usb0/disk:,\eofwboot.elf hd:0/netbsd.new -d . .It Boot from bootable CDROM with Open Firmware 3 or higher:
CVS commit: src/share/man/man8/man8.macppc
Module Name:src Committed By: uwe Date: Fri Mar 1 22:35:56 UTC 2024 Modified Files: src/share/man/man8/man8.macppc: ofwboot.8 Log Message: ofwboot(8): add some practical examples The system you want to boot into the single user mode is probably the default installation, so a simple "boot -s" is enough for that. Don't be redundant and scary. Also provide an example that uses full syntax for the kernel name. It is confusingly similar to the OFW syntax for boot-device yet different. That example also demonstrates how one might test a different version of ofwboot. To generate a diff of this commit: cvs rdiff -u -r1.15 -r1.16 src/share/man/man8/man8.macppc/ofwboot.8 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/lib/libc/arch/sparc/gen
Module Name:src Committed By: uwe Date: Tue Feb 20 00:09:31 UTC 2024 Modified Files: src/lib/libc/arch/sparc/gen: longjmp.c Log Message: fix typo in comment To generate a diff of this commit: cvs rdiff -u -r1.4 -r1.5 src/lib/libc/arch/sparc/gen/longjmp.c 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/arch/sparc/gen/longjmp.c diff -u src/lib/libc/arch/sparc/gen/longjmp.c:1.4 src/lib/libc/arch/sparc/gen/longjmp.c:1.5 --- src/lib/libc/arch/sparc/gen/longjmp.c:1.4 Sun Sep 3 21:41:45 2023 +++ src/lib/libc/arch/sparc/gen/longjmp.c Tue Feb 20 00:09:31 2024 @@ -1,4 +1,4 @@ -/* $NetBSD: longjmp.c,v 1.4 2023/09/03 21:41:45 mrg Exp $ */ +/* $NetBSD: longjmp.c,v 1.5 2024/02/20 00:09:31 uwe Exp $ */ /*- * Copyright (c) 2003 The NetBSD Foundation, Inc. @@ -47,7 +47,7 @@ /* * check that offsets in the above structures match their usage in the * setjmp() side of this setup. a jmp_buf is the 12-word contents of - * the sigcontexst structure, plus 2 more words for g4 and g7. + * the sigcontext structure, plus 2 more words for g4 and g7. */ __CTASSERT(_SIZEOF_SC + _JB_G4 == offsetof(struct __jmp_buf,regs.g4)); __CTASSERT(_SIZEOF_SC + _JB_G7 == offsetof(struct __jmp_buf,regs.g7));
CVS commit: src/lib/libc/arch/sparc/gen
Module Name:src Committed By: uwe Date: Tue Feb 20 00:09:31 UTC 2024 Modified Files: src/lib/libc/arch/sparc/gen: longjmp.c Log Message: fix typo in comment To generate a diff of this commit: cvs rdiff -u -r1.4 -r1.5 src/lib/libc/arch/sparc/gen/longjmp.c Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/lib/libc/net
Module Name:src Committed By: uwe Date: Fri Feb 16 22:50:33 UTC 2024 Modified Files: src/lib/libc/net: getnameinfo.3 Log Message: getnameinfo(3): fix/prettify markup To generate a diff of this commit: cvs rdiff -u -r1.43 -r1.44 src/lib/libc/net/getnameinfo.3 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/lib/libc/net
Module Name:src
Committed By: uwe
Date: Fri Feb 16 22:50:33 UTC 2024
Modified Files:
src/lib/libc/net: getnameinfo.3
Log Message:
getnameinfo(3): fix/prettify markup
To generate a diff of this commit:
cvs rdiff -u -r1.43 -r1.44 src/lib/libc/net/getnameinfo.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/net/getnameinfo.3
diff -u src/lib/libc/net/getnameinfo.3:1.43 src/lib/libc/net/getnameinfo.3:1.44
--- src/lib/libc/net/getnameinfo.3:1.43 Thu Feb 15 15:08:23 2024
+++ src/lib/libc/net/getnameinfo.3 Fri Feb 16 22:50:33 2024
@@ -1,4 +1,4 @@
-.\" $NetBSD: getnameinfo.3,v 1.43 2024/02/15 15:08:23 jkoshy Exp $
+.\" $NetBSD: getnameinfo.3,v 1.44 2024/02/16 22:50:33 uwe Exp $
.\" $KAME: getnameinfo.3,v 1.37 2005/01/05 03:23:05 itojun Exp $
.\" $OpenBSD: getnameinfo.3,v 1.36 2004/12/21 09:48:20 jmc Exp $
.\"
@@ -23,17 +23,25 @@
.Sh NAME
.Nm getnameinfo
.Nd socket address structure to hostname and service name
+.
.Sh SYNOPSIS
.In netdb.h
+.
.Ft int
-.Fn getnameinfo "const struct sockaddr * restrict sa" "socklen_t salen" \
-"char * restrict host" "socklen_t hostlen" "char * restrict serv" \
-"socklen_t servlen" "int flags"
+.Fo getnameinfo
+.Fa "const struct sockaddr * restrict sa"
+.Fa "socklen_t salen"
+.Fa "char * restrict host"
+.Fa "socklen_t hostlen"
+.Fa "char * restrict serv"
+.Fa "socklen_t servlen" "int flags"
+.Fc
+.
.Sh DESCRIPTION
The
.Fn getnameinfo
function is used to convert a
-.Li sockaddr
+.Vt sockaddr
structure to a pair of host name and service strings.
It is a replacement for and provides more flexibility than the
.Xr gethostbyaddr 3
@@ -44,20 +52,20 @@ functions and is the converse of the
function.
.Pp
The
-.Li sockaddr
+.Vt sockaddr
structure
.Fa sa
should point to a
-.Li sockaddr_in
+.Vt sockaddr_in
(for IPv4),
-.Li sockaddr_in6
+.Vt sockaddr_in6
(for IPv6),
-.Li sockaddr_atalk
+.Vt sockaddr_atalk
(for AppleTalk),
-.Li sockaddr_link
+.Vt sockaddr_link
(for link layer),
or
-.Li sockaddr_local
+.Vt sockaddr_local
(for local/unix)
structures that are
.Fa salen
@@ -85,14 +93,16 @@ as defined by
.In netdb.h .
If a length parameter is zero, no string will be stored.
Otherwise, enough space must be provided to store the
-host name or service string plus a byte for the NUL terminator.
+host name or service string plus a byte for the
+.Tn NUL
+terminator.
.Pp
The
.Fa flags
argument is formed by
-.Sy OR Ns 'ing
+.Em or Ap ing
the following values:
-.Bl -tag -width "NI_NUMERICHOSTXX"
+.Bl -tag -width Dv
.It Dv NI_NOFQDN
A fully qualified domain name is not required for local hosts.
The local part of the fully qualified domain name is returned instead.
@@ -106,21 +116,23 @@ If the host name cannot be found in DNS
a non-zero error code is returned.
If the host name is not found and the flag is not set, the
address is returned in numeric form.
-.It NI_NUMERICSCOPE
+.It Dv NI_NUMERICSCOPE
For IPv6 addresses the numeric form of the IPv6 scope identifier is
returned.
This flag is ignored for non-IPv6 addresses.
-.It NI_NUMERICSERV
+.It Dv NI_NUMERICSERV
The service name is returned as a digit string representing the port number.
-.It NI_DGRAM
+.It Dv NI_DGRAM
Specifies that the service being looked up is a datagram
service, and causes
.Xr getservbyport 3
to be called with a second argument of
-.Dq udp
+.Li \*qudp\*q
instead of its default of
-.Dq tcp .
-This is required for the few ports (512\-514) that have different services
+.Li \*qtcp\*q .
+This is required for the few ports
+.Pq 512\(en514
+that have different services
for
.Tn UDP
and
@@ -128,17 +140,19 @@ and
.El
.Pp
This implementation allows numeric IPv6 address notation with scope identifier,
-as documented in chapter 11 of draft-ietf-ipv6-scoping-arch-02.txt.
+as documented in chapter\~11 of draft-ietf-ipv6-scoping-arch-02.txt.
IPv6 link-local address will appear as a string like
-.Dq Li fe80::1%ne0 .
+.Ql fe80::1%ne0 .
Refer to
.Xr getaddrinfo 3
for more information.
+.
.Sh RETURN VALUES
.Fn getnameinfo
returns zero on success or one of the error codes listed in
.Xr gai_strerror 3
if an error occurs.
+.
.Sh EXAMPLES
The following code tries to get a numeric host name, and service name,
for a given socket address.
@@ -167,6 +181,7 @@ if (getnameinfo(sa, sa->sa_len, hbuf, si
}
printf("host=%s\en", hbuf);
.Ed
+.
.Sh SEE ALSO
.Xr gai_strerror 3 ,
.Xr getaddrinfo 3 ,
@@ -205,6 +220,7 @@ printf("host=%s\en", hbuf);
.%B "Proceedings of the FREENIX track: 2000 USENIX annual technical conference"
.%D June 2000
.Re
+.
.Sh STANDARDS
The
.Fn getnameinfo
@@ -213,19 +229,25 @@ function is defined by the
draft specification and documented in
.Sy "RFC 2553" ,
.Dq Basic Socket Interface Extensions for IPv6 .
+.
.Sh CAVEATS
.Fn getnameinfo
-can return both numeric and FQDN forms of the address specified in
+can return both numeric and
+.Tn
CVS commit: src/lib/libc/gen
Module Name:src Committed By: uwe Date: Fri Feb 9 17:24:45 UTC 2024 Modified Files: src/lib/libc/gen: signal.3 Log Message: signal(3): mention old signal(2) syscall in HISTORY To generate a diff of this commit: cvs rdiff -u -r1.29 -r1.30 src/lib/libc/gen/signal.3 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: Fri Feb 9 17:24:45 UTC 2024 Modified Files: src/lib/libc/gen: signal.3 Log Message: signal(3): mention old signal(2) syscall in HISTORY To generate a diff of this commit: cvs rdiff -u -r1.29 -r1.30 src/lib/libc/gen/signal.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/signal.3 diff -u src/lib/libc/gen/signal.3:1.29 src/lib/libc/gen/signal.3:1.30 --- src/lib/libc/gen/signal.3:1.29 Sat Aug 7 03:17:23 2021 +++ src/lib/libc/gen/signal.3 Fri Feb 9 17:24:44 2024 @@ -1,4 +1,4 @@ -.\" $NetBSD: signal.3,v 1.29 2021/08/07 03:17:23 dholland Exp $ +.\" $NetBSD: signal.3,v 1.30 2024/02/09 17:24:44 uwe Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -190,3 +190,11 @@ This .Fn signal facility appeared in .Bx 4.0 . +.Pp +The +.Fn signal +facility used to be a system call that implemented a different +semantics +.Dq ( old signals ) . +It first appeared in +.At v4 .
CVS commit: src/lib/libutil
Module Name:src Committed By: uwe Date: Sun Feb 4 18:44:54 UTC 2024 Modified Files: src/lib/libutil: getrawpartition.3 Log Message: getrawpartition(3): reword to clarify return value, use .Pq "'a' == 0" is, stricly speaking false, and since 'a' is an int, it's not immediately clear if it's 'a' or 0 that is returned. Try to clarify this. To generate a diff of this commit: cvs rdiff -u -r1.11 -r1.12 src/lib/libutil/getrawpartition.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/libutil/getrawpartition.3 diff -u src/lib/libutil/getrawpartition.3:1.11 src/lib/libutil/getrawpartition.3:1.12 --- src/lib/libutil/getrawpartition.3:1.11 Tue May 4 06:41:27 2010 +++ src/lib/libutil/getrawpartition.3 Sun Feb 4 18:44:54 2024 @@ -1,4 +1,4 @@ -.\" $NetBSD: getrawpartition.3,v 1.11 2010/05/04 06:41:27 jruoho Exp $ +.\" $NetBSD: getrawpartition.3,v 1.12 2024/02/04 18:44:54 uwe Exp $ .\" .\" Copyright (c) 1996 The NetBSD Foundation, Inc. .\" All rights reserved. @@ -43,11 +43,15 @@ partition .Fn getrawpartition void .Sh DESCRIPTION .Fn getrawpartition -returns the partition number ( -.Sq a -== 0, -.Sq b -== 1, ...) of the +returns the partition number +.Po +0 for +.Ql a , +1 for +.Ql b , +etc +.Pc +of the .Dq raw partition of the system's disks, or \-1 in case of an error, setting the global
CVS commit: src/lib/libutil
Module Name:src Committed By: uwe Date: Sun Feb 4 18:44:54 UTC 2024 Modified Files: src/lib/libutil: getrawpartition.3 Log Message: getrawpartition(3): reword to clarify return value, use .Pq "'a' == 0" is, stricly speaking false, and since 'a' is an int, it's not immediately clear if it's 'a' or 0 that is returned. Try to clarify this. To generate a diff of this commit: cvs rdiff -u -r1.11 -r1.12 src/lib/libutil/getrawpartition.3 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/share/man/man8/man8.macppc
Module Name:src Committed By: uwe Date: Sat Feb 3 14:15:51 UTC 2024 Modified Files: src/share/man/man8/man8.macppc: ofwboot.8 Log Message: ofwboot(8): improve formatting To generate a diff of this commit: cvs rdiff -u -r1.14 -r1.15 src/share/man/man8/man8.macppc/ofwboot.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/man8/man8.macppc/ofwboot.8 diff -u src/share/man/man8/man8.macppc/ofwboot.8:1.14 src/share/man/man8/man8.macppc/ofwboot.8:1.15 --- src/share/man/man8/man8.macppc/ofwboot.8:1.14 Mon Jul 3 21:31:00 2017 +++ src/share/man/man8/man8.macppc/ofwboot.8 Sat Feb 3 14:15:51 2024 @@ -1,4 +1,4 @@ -.\" $NetBSD: ofwboot.8,v 1.14 2017/07/03 21:31:00 wiz Exp $ +.\" $NetBSD: ofwboot.8,v 1.15 2024/02/03 14:15:51 uwe Exp $ .\" .\" Copyright (c) 2001 The NetBSD Foundation, Inc. .\" All rights reserved. @@ -61,11 +61,13 @@ because it is used to pass arguments to The Open Firmware .Ic boot command takes up to three arguments: +.Bd -literal -offset indent +.Ic boot Oo Ar boot-device Oo Ar boot-file Oc Oc Op Ar options +.Ed .Pp -.Ic boot -.Op Ar boot-device Op Ar boot-file -.Op Ar options -.Bl -tag -width boot-device -compact +where +.Pp +.Bl -tag -width ".Ar boot-device" -offset indent -compact .It Ar boot-device primary bootloader location .It Ar boot-file @@ -78,46 +80,67 @@ The first argument, .Ar boot-device , actually designates the primary bootloader location and its name in the form: -.Dl boot-device:[partition-num],[bootloader-filename] +.Bd -literal -offset indent +.Sm off +.Ar device Ic \&: Op Ar partition-num +.Ic \&, Op Ar bootloader-filename +.Sm on +.Ed +.Pp A typical example, from a PowerBook (FireWire), is +.Pp .Dl /pci@f200/mac-io@17/ata-4@1f000/@0:9,ofwboot.xcf -.\" XXX: can't use Dq or Pq with : or , -Note that colon (`:') delimits the device to the left, and comma (`,') -separates the boot loader filename from the first part. +.Pp +Note that colon +.Pq Ql \&: +delimits the device to the left, and comma +.Pq Ql \&, +separates the bootloader filename from the first part. For Open Firmware versions before 3, the primary bootloader is installed in partition .Dq zero , -and it is not necessary to specify the bootloader-filename. -For Open Firmware version 3, you must specify the bootloader-filename. -.Pp -Open Firmware stores aliases to common devices in NVRAM. -In the example above, +and it is not necessary to specify the +.Ar bootloader-filename . +For Open Firmware version 3, you must specify the bootloader filename. +.Pp +Open Firmware stores aliases to common devices in +.Tn NVRAM . +In the example the above, .Pa /pci@f200/mac-io@17/ata-4@1f000/@0 is the path on a PowerBook -(FireWire) to the built-in ATA/100 hard drive. +(FireWire) to the built-in +.Tn ATA Ns /100 +hard drive. Use the .Ic devalias command in Open Firmware to print out a list of common device names on a particular model. -The command above could then be simplified to: +The +.Ar boot-device +above could then be simplified to: +.Pp .Dl hd:9,ofwboot.xcf .Pp -.Ar boot-loader-file-name +.Ar bootloader-filename is usually .Nm ofwboot.xcf . -(See also the +See also the .Sx FILES -section for further discussion.) +section for further discussion. .Pp -If omitted, the Open Firmware variable -.Va boot-device +If +.Ar boot-device +is omitted from the +.Ic boot +command, the Open Firmware variable +.Ev boot-device is used. .Ss boot-file It may be necessary to specify the .Ar boot-file if Open Firmware does not know where to find the kernel. The default is to load the file named -.Nm netbsd +.Pa netbsd on partition .Dq Pa a from the device used to load the primary bootloader. @@ -134,28 +157,42 @@ Systems with Open Firmware version 3 may The syntax is similar to the .Ar boot-device argument: -.Dl [boot-file-device:partition-num/][kernel-name] -This is a little different, since a kernel-name may be specified without -listing a boot-file-device and partition-num. -Additionally, a boot-file-device and partition-num may need to be -specified, while using the default kernel-name. +.Bd -literal -offset indent +.Sm off +.Op Ar boot-file-device Ic \&: Ar partition-num\^ Ic \&/ +.Op Ar kernel-name +.Sm on +.Ed .Pp -If no kernel-name is specified, the primary bootloader will try to find -kernels named either -.Ar netbsd +This is a little different, since a kernel-name may be specified without +listing a +.Ar boot-file-device +and +.Ar partition-num . +Additionally, a +.Ar boot-file-device +and +.Ar partition-num +may need to be specified, while using the default +.Ar kernel-name . +.Pp +If no +.Ar kernel-name +is specified, the primary bootloader will try to find kernels named either +.Pa netbsd or -.Ar netbsd.gz +.Pa netbsd.gz on the boot-device or (if specified) boot-file-device. .Ss options Possible options are: -.Bl -tag -width x -compact +.Bl -tag -width
CVS commit: src/share/man/man8/man8.macppc
Module Name:src Committed By: uwe Date: Sat Feb 3 14:15:51 UTC 2024 Modified Files: src/share/man/man8/man8.macppc: ofwboot.8 Log Message: ofwboot(8): improve formatting To generate a diff of this commit: cvs rdiff -u -r1.14 -r1.15 src/share/man/man8/man8.macppc/ofwboot.8 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/lib/libutil
Module Name:src Committed By: uwe Date: Mon Jan 22 00:11:21 UTC 2024 Modified Files: src/lib/libutil: snprintb.3 Log Message: snprintb(3): restore empty string in snprintb_m example Restore the empty string at the end of snprintb_m output that was accidentally removed along with empty string placeholders in the format strings. While here, move that example to be next to its snprintb counterpart. To generate a diff of this commit: cvs rdiff -u -r1.28 -r1.29 src/lib/libutil/snprintb.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/libutil/snprintb.3 diff -u src/lib/libutil/snprintb.3:1.28 src/lib/libutil/snprintb.3:1.29 --- src/lib/libutil/snprintb.3:1.28 Sun Jan 21 23:57:49 2024 +++ src/lib/libutil/snprintb.3 Mon Jan 22 00:11:21 2024 @@ -1,4 +1,4 @@ -.\" $NetBSD: snprintb.3,v 1.28 2024/01/21 23:57:49 uwe Exp $ +.\" $NetBSD: snprintb.3,v 1.29 2024/01/22 00:11:21 uwe Exp $ .\" .\" Copyright (c) 1998 The NetBSD Foundation, Inc. .\" All rights reserved. @@ -304,6 +304,19 @@ snprintb(buf, buflen, \(rA "0x800f0701" .Ed .Pp +The same example using snprintb_m: +.Bd -literal -offset indent +snprintb_m(buf, buflen, +"\e177\e020" +"b\e0LSB\e0" "b\e1BITONE\e0" "f\e4\e4NIBBLE2\e0" +"f\ex10\e4BURST\e0" "=\e4FOUR\e0" "=\exfFIFTEEN\e0" +"b\ex1fMSB\e0", +0x800f0701, 34) +\(rA "0x800f0701\e0" + "0x800f0701\e0" + "" +.Ed +.Pp A more complex example from .In sys/mman.h that uses the both bit position @@ -360,19 +373,7 @@ snprintb(buf, buflen, MAP_FMT, 0x0d00123 \(rA "0xd001234" snprintb(buf, buflen, MAP_FMT, 0x2e00) -\(rA "0xd001234<0x2e00 -.Ed -.Pp -An example using snprintb_m: -.Bd -literal -offset indent -snprintb_m(buf, buflen, -"\e177\e020" -"b\e0LSB\e0" "b\e1BITONE\e0" "f\e4\e4NIBBLE2\e0" -"f\ex10\e4BURST\e0" "=\e4FOUR\e0" "=\exfFIFTEEN\e0" -"b\ex1fMSB\e0" "\e0", -0x800f0701, 34) -\(rA "0x800f0701\e0" - "0x800f0701\e0" +\(rA "0xd001234<0x2e00" .Ed .Sh ERRORS .Fn snprintb
CVS commit: src/lib/libutil
Module Name:src Committed By: uwe Date: Mon Jan 22 00:11:21 UTC 2024 Modified Files: src/lib/libutil: snprintb.3 Log Message: snprintb(3): restore empty string in snprintb_m example Restore the empty string at the end of snprintb_m output that was accidentally removed along with empty string placeholders in the format strings. While here, move that example to be next to its snprintb counterpart. To generate a diff of this commit: cvs rdiff -u -r1.28 -r1.29 src/lib/libutil/snprintb.3 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/lib/libutil
Module Name:src Committed By: uwe Date: Sun Jan 21 23:57:49 UTC 2024 Modified Files: src/lib/libutil: snprintb.3 Log Message: snprintb(3): update mmap example Bring over the prettier version of the mmap format string that we have in the header file for some time now. Clarify that the final NUL of the new format string is supplied by the compiler, g/c explicit final \0 from the example that had it. To generate a diff of this commit: cvs rdiff -u -r1.27 -r1.28 src/lib/libutil/snprintb.3 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/lib/libutil
Module Name:src Committed By: uwe Date: Sun Jan 21 23:57:49 UTC 2024 Modified Files: src/lib/libutil: snprintb.3 Log Message: snprintb(3): update mmap example Bring over the prettier version of the mmap format string that we have in the header file for some time now. Clarify that the final NUL of the new format string is supplied by the compiler, g/c explicit final \0 from the example that had it. To generate a diff of this commit: cvs rdiff -u -r1.27 -r1.28 src/lib/libutil/snprintb.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/libutil/snprintb.3 diff -u src/lib/libutil/snprintb.3:1.27 src/lib/libutil/snprintb.3:1.28 --- src/lib/libutil/snprintb.3:1.27 Sun Jan 21 23:44:30 2024 +++ src/lib/libutil/snprintb.3 Sun Jan 21 23:57:49 2024 @@ -1,4 +1,4 @@ -.\" $NetBSD: snprintb.3,v 1.27 2024/01/21 23:44:30 uwe Exp $ +.\" $NetBSD: snprintb.3,v 1.28 2024/01/21 23:57:49 uwe Exp $ .\" .\" Copyright (c) 1998 The NetBSD Foundation, Inc. .\" All rights reserved. @@ -260,6 +260,10 @@ The new format string is terminated by a .Tn NUL character at the end, following that delimiting the last bit-position\(endescription pair. +This +.Tn NUL +is supplied by the compiler to terminate the string literal and +doesn't need to be written explicitly. .Sh RETURN VALUES The .Fn snprintb @@ -295,7 +299,7 @@ snprintb(buf, buflen, "b\e0LSB\e0" "b\e1BITONE\e0" "f\e4\e4NIBBLE2\e0" "f\ex10\e4BURST\e0" "=\e4FOUR\e0" "=\exfFIFTEEN\e0" -"b\ex1fMSB\e0" "\e0", +"b\ex1fMSB\e0", 0x800f0701) \(rA "0x800f0701" .Ed @@ -303,53 +307,58 @@ snprintb(buf, buflen, A more complex example from .In sys/mman.h that uses the both bit position -.Sq b +.Sq Cm b formatting as well as the -.Sq F -multi-field formatting with a default case: +.Sq Cm F +multibit field formatting with a default case +.Pq Sq Cm \&* : .Bd -literal -offset indent -#define MAP_FMT "\e177\e020\e -b\e0SHARED\e0\e -b\e1PRIVATE\e0\e -b\e2COPY\e0\e -b\e4FIXED\e0\e -b\e5RENAME\e0\e -b\e6NORESERVE\e0\e -b\e7INHERIT\e0\e -b\e11HASSEMAPHORE\e0\e -b\e12TRYFIXED\e0\e -b\e13WIRED\e0\e -F\e14\e1\e0\e -:\e0FILE\e0\e -:\e1ANONYMOUS\e0\e -b\e15STACK\e0\e -F\e30\e010\e0\e -:\e000ALIGN=NONE\e0\e -:\e012ALIGN=1KB\e0\e -:\e013ALIGN=2KB\e0\e -:\e014ALIGN=4KB\e0\e -:\e015ALIGN=8KB\e0\e -:\e016ALIGN=16KB\e0\e -:\e017ALIGN=32KB\e0\e -:\e020ALIGN=64KB\e0\e -:\e021ALIGN=128KB\e0\e -:\e022ALIGN=256KB\e0\e -:\e023ALIGN=512KB\e0\e -:\e024ALIGN=1MB\e0\e -:\e030ALIGN=16MB\e0\e -:\e034ALIGN=256MB\e0\e -:\e040ALIGN=4GB\e0\e -:\e044ALIGN=64GB\e0\e -:\e050ALIGN=1TB\e0\e -:\e054ALIGN=16TB\e0\e -:\e060ALIGN=256TB\e0\e -:\e064ALIGN=4PB\e0\e -:\e070ALIGN=64PB\e0\e -:\e074ALIGN=256PB\e0\e -*ALIGN=2^%jd\e0\e -" +#define MAP_FMT "\e177\e020" \e +"b\e0" "SHARED\e0" \e +"b\e1" "PRIVATE\e0" \e +"b\e2" "COPY\e0" \e +"b\e4" "FIXED\e0"\e +"b\e5" "RENAME\e0" \e +"b\e6" "NORESERVE\e0"\e +"b\e7" "INHERIT\e0" \e +"b\e11" "HASSEMAPHORE\e0" \e +"b\e12" "TRYFIXED\e0" \e +"b\e13" "WIRED\e0"\e +"F\e14\e1\e0" \e +":\e0" "FILE\e0" \e +":\e1" "ANONYMOUS\e0" \e +"b\e15" "STACK\e0"\e +"F\e30\e010\e0"\e +":\e000" "ALIGN=NONE\e0" \e +":\e012" "ALIGN=1KB\e0" \e +":\e013" "ALIGN=2KB\e0" \e +":\e014" "ALIGN=4KB\e0" \e +":\e015" "ALIGN=8KB\e0" \e +":\e016" "ALIGN=16KB\e0" \e +":\e017" "ALIGN=32KB\e0" \e +":\e020" "ALIGN=64KB\e0" \e +":\e021" "ALIGN=128KB\e0" \e +":\e022" "ALIGN=256KB\e0" \e +":\e023" "ALIGN=512KB\e0" \e +":\e024" "ALIGN=1MB\e0" \e +":\e025" "ALIGN=2MB\e0" \e +":\e026" "ALIGN=4MB\e0" \e +":\e027" "ALIGN=8MB\e0" \e +":\e030" "ALIGN=16MB\e0" \e +":\e034" "ALIGN=256MB\e0" \e +":\e040" "ALIGN=4GB\e0" \e +":\e044" "ALIGN=64GB\e0" \e +":\e050" "ALIGN=1TB\e0" \e +":\e054" "ALIGN=16TB\e0" \e +":\e060" "ALIGN=256TB\e0" \e +":\e064" "ALIGN=4PB\e0" \e +":\e070" "ALIGN=64PB\e0" \e +
CVS commit: src/lib/libutil
Module Name:src Committed By: uwe Date: Sun Jan 21 23:44:30 UTC 2024 Modified Files: src/lib/libutil: snprintb.3 Log Message: snprintb(3): try to improve narration Try to make the narration more coherent. Make the old and new syntaxes easy to distinguish and go out of our way to highlight that the old syntax uses 1-based bit positions. To generate a diff of this commit: cvs rdiff -u -r1.26 -r1.27 src/lib/libutil/snprintb.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/libutil/snprintb.3 diff -u src/lib/libutil/snprintb.3:1.26 src/lib/libutil/snprintb.3:1.27 --- src/lib/libutil/snprintb.3:1.26 Sun Jan 21 22:06:46 2024 +++ src/lib/libutil/snprintb.3 Sun Jan 21 23:44:30 2024 @@ -1,4 +1,4 @@ -.\" $NetBSD: snprintb.3,v 1.26 2024/01/21 22:06:46 rillig Exp $ +.\" $NetBSD: snprintb.3,v 1.27 2024/01/21 23:44:30 uwe Exp $ .\" .\" Copyright (c) 1998 The NetBSD Foundation, Inc. .\" All rights reserved. @@ -57,14 +57,46 @@ of size .Fa buflen , using a specified radix and an interpretation of the bits within that integer as though they were flags. -The buffer is always NUL-terminated. +The buffer is always +.Tn NUL Ns -terminated. If the buffer .Fa buf is too small to hold the formatted output, .Fn snprintb will fill as much as it can, and return the number of bytes that it would have written if the buffer were long enough excluding the -terminating NUL. +terminating +.Tn NUL . +.Pp +The +.Fn snprintb_m +function accepts an additional +.Fa max +argument. +If this argument is zero, the +.Fn snprintb_m +function returns exactly the same results in the +.Fa buf +as the +.Fn snprintb +function. +If the +.Fa max +argument has a non-zero value, it represents the maximum length of a +formatted string. +If the formatted string would require more than +.Fa max +characters, the +.Fn snprintb_m +function returns multiple formatted strings in the output buffer +.Fa buf . +Each string is +.Tn NUL Ns -terminated , +and the last string is followed by an +additional +.Tn NUL +character +.Pq or, if you prefer, a zero-length string . .Pp The decoding directive string .Fa fmt @@ -80,7 +112,7 @@ formatting is that it is capable of hand The first character of .Fa fmt may be -.Li \e177 , +.Ql \e177 , indicating that the remainder of the format string follows the .Dq new syntax. @@ -91,142 +123,143 @@ output numeral base in which the bitfiel Recognized radix values .Pq in C escape-character format are -.Li \e10 +.Ql \e10 .Pq octal , -.Li \e12 +.Ql \e12 .Pq decimal , and -.Li \e20 +.Ql \e20 .Pq hexadecimal . .Pp The remaining characters in .Fa fmt are interpreted as a list of bit-position\(endescription pairs. From here the syntaxes diverge. +. +.Ss Old Syntax .Pp The .Dq old format syntax is series of bit-position\(endescription pairs. -Each begins with a binary character value that represents the position -of the bit being described. -A bit position value of one describes the least significant bit. +.Pp +Each description begins with a binary character value that represents +the position of the bit being described. +.Pp +.Sy NB : +the bit positions in the old syntax are +.Em 1-based\^ ! +A bit position value of 1 +.Pq Ql \e1 +describes the least significant bit. Whereas a position value of 32 -.Pq octal 40, hexadecimal 20, the ASCII space character +.Po octal +.Ql \e040 , +hexadecimal +.Ql \ex20 , +the ASCII space character +.Pc describes the most significant bit. +The old syntax is limited to 32-bit values. +.Pp +The remaining characters are the description to print should the bit +being described be set. .Pp -The remaining characters in a bit-position\(endescription pair are the -characters to print should the bit being described be set. Description strings are delimited by the next bit position value character encountered .Pq distinguishable by its value being \*[Le] 32 , or the end of the decoding directive string itself. +. +.Ss New Syntax .Pp For the .Dq new -format syntax, a bit-position\(endescription begins with a field type -followed by a binary bit-position and possibly a field length. -The least significant bit is bit-position zero, unlike the -.Dq old -syntax where it is one. -.Bl -tag -width "x" -.It Cm b\eB -Describes a bit position. -The bit-position -.Fa B -indicates the corresponding bit, as in the -.Dq old -format. -.It Cm f\eB\eL +format syntax, a field description begins with a field type followed +by a binary field position and possibly a field length. +The bit positions are 0-based, +the least significant bit is bit-position zero. +Each description is terminated by a +.Tn NUL +byte. +. +.Bl -tag -width Cm +. +.It Cm b\e Ns Ar B +Describes a single bit at bit-position +.Ar B . +The remaining characters are the description to print should the bit +being described be set. +This field description is similar in function to the old format.
CVS commit: src/lib/libutil
Module Name:src Committed By: uwe Date: Sun Jan 21 23:44:30 UTC 2024 Modified Files: src/lib/libutil: snprintb.3 Log Message: snprintb(3): try to improve narration Try to make the narration more coherent. Make the old and new syntaxes easy to distinguish and go out of our way to highlight that the old syntax uses 1-based bit positions. To generate a diff of this commit: cvs rdiff -u -r1.26 -r1.27 src/lib/libutil/snprintb.3 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
Re: CVS commit: src/lib/libutil
On Sun, Jan 21, 2024 at 21:31:23 +, Roland Illig wrote: > and also didn't make it clear that a few bits were omitted from > having descriptions. I dislike this part. It's internally inconsistent as it doesn't add the placeholders for the low bits; and in many real-life scenarios there will be *lots* of gaps in the defined bits, so implying in the man page that the placeholders are good style just places the people in a situation where they have to make the sensible thing, but go against the style suggested in the man page. I don't think that's helpful. Please, can we remove the placeholders from this example? -uwe
Re: CVS commit: src/bin/date
On Sun, Jan 21, 2024 at 11:55:56 -0500, Christos Zoulas wrote: > Consider providing parsedate(3) in libcompat, but then we'd need > yacc... We already have yacc in tools - src/tools/yacc -uwe
Re: CVS commit: src/sys/arch/macppc/conf
On Thu, Jan 18, 2024 at 06:43:21 +1100, matthew green wrote: > > Log Message: > > macppc: enable FFS_EI in GENERIC > > > > I'd say it should be enabled for anything with USB. > > > > ok macallan > > yay. i think we should enable it basically everywhere that it > is not a space issue. I think the size impact should be trivial (though I didn't measure). The option basically guards just a couple dozens of "bit test plus bswap call" snippets. > USB is just one common way, but i can also modify or create my own > images anyway, and maybe copy them over the network to my machine > with USB...or maybe i'll setup the disk on this machine's scsi for > that machine ;) Yeah. I just didn't want to open that can of yaks to shave... :) -uwe
CVS commit: src/sys/arch/macppc/conf
Module Name:src Committed By: uwe Date: Wed Jan 17 13:23:30 UTC 2024 Modified Files: src/sys/arch/macppc/conf: GENERIC Log Message: macppc: enable FFS_EI in GENERIC I'd say it should be enabled for anything with USB. ok macallan To generate a diff of this commit: cvs rdiff -u -r1.377 -r1.378 src/sys/arch/macppc/conf/GENERIC 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/macppc/conf/GENERIC diff -u src/sys/arch/macppc/conf/GENERIC:1.377 src/sys/arch/macppc/conf/GENERIC:1.378 --- src/sys/arch/macppc/conf/GENERIC:1.377 Thu Feb 9 14:09:49 2023 +++ src/sys/arch/macppc/conf/GENERIC Wed Jan 17 13:23:30 2024 @@ -1,4 +1,4 @@ -# $NetBSD: GENERIC,v 1.377 2023/02/09 14:09:49 abs Exp $ +# $NetBSD: GENERIC,v 1.378 2024/01/17 13:23:30 uwe Exp $ # # GENERIC machine description file # @@ -22,7 +22,7 @@ include "arch/macppc/conf/std.macppc" options INCLUDE_CONFIG_FILE # embed config file in kernel binary -#ident "GENERIC-$Revision: 1.377 $" +#ident "GENERIC-$Revision: 1.378 $" maxusers 32 @@ -84,7 +84,7 @@ include "conf/filesystems.config" # File system options options APPLE_UFS # Apple UFS support in FFS -#options FFS_EI # FFS Endian Independent support +options FFS_EI # FFS Endian Independent support #options FFS_NO_SNAPSHOT # No FFS snapshot support options QUOTA # legacy UFS quotas options QUOTA2 # new, in-filesystem UFS quotas
CVS commit: src/sys/arch/macppc/conf
Module Name:src Committed By: uwe Date: Wed Jan 17 13:23:30 UTC 2024 Modified Files: src/sys/arch/macppc/conf: GENERIC Log Message: macppc: enable FFS_EI in GENERIC I'd say it should be enabled for anything with USB. ok macallan To generate a diff of this commit: cvs rdiff -u -r1.377 -r1.378 src/sys/arch/macppc/conf/GENERIC Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/external/bsd/tmux/usr.bin/tmux
Module Name:src Committed By: uwe Date: Thu Jan 4 13:20:22 UTC 2024 Modified Files: src/external/bsd/tmux/usr.bin/tmux: Makefile Log Message: tmux: perform substitution(s) in the man page To generate a diff of this commit: cvs rdiff -u -r1.31 -r1.32 src/external/bsd/tmux/usr.bin/tmux/Makefile Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/external/bsd/tmux/usr.bin/tmux
Module Name:src
Committed By: uwe
Date: Thu Jan 4 13:20:22 UTC 2024
Modified Files:
src/external/bsd/tmux/usr.bin/tmux: Makefile
Log Message:
tmux: perform substitution(s) in the man page
To generate a diff of this commit:
cvs rdiff -u -r1.31 -r1.32 src/external/bsd/tmux/usr.bin/tmux/Makefile
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/external/bsd/tmux/usr.bin/tmux/Makefile
diff -u src/external/bsd/tmux/usr.bin/tmux/Makefile:1.31 src/external/bsd/tmux/usr.bin/tmux/Makefile:1.32
--- src/external/bsd/tmux/usr.bin/tmux/Makefile:1.31 Wed Jun 28 22:47:39 2023
+++ src/external/bsd/tmux/usr.bin/tmux/Makefile Thu Jan 4 13:20:22 2024
@@ -1,4 +1,4 @@
-# $NetBSD: Makefile,v 1.31 2023/06/28 22:47:39 wiz Exp $
+# $NetBSD: Makefile,v 1.32 2024/01/04 13:20:22 uwe Exp $
.include
@@ -247,4 +247,10 @@ COPTS.tty.c += -Wno-pointer-sign
COPTS.utempter.c+= ${CC_WNO_STRINGOP_TRUNCATION}
COPTS.window-copy.c+= ${CC_WNO_MAYBE_UNINITIALIZED} -Wno-pointer-sign
+# The man page needs substitutions, but the dist file usurps the
+# output file suffix.
+.NOPATH: tmux.1
+tmux.1: $(SRCDIR)/tmux.1
+ sed -e 's|@SYSCONFDIR@|/etc|g' $> > $@
+
.include
Re: CVS commit: src/share/mk
On Wed, Jan 03, 2024 at 02:48:06 +, Jason R Thorpe wrote: > Add virt68k to MACHINES.m68k. "virt" is too generic a name, if this is specifically a qemu version, may be it should have been called qemu68k... Guess it's too late now. -uwe
Re: CVS commit: src/sys/sys
On Wed, Jan 03, 2024 at 01:06:57 +0100, Joerg Sonnenberger wrote: > Date: Wed, 03 Jan 2024 01:06:57 +0100 > From: Joerg Sonnenberger > Subject: Re: CVS commit: src/sys/sys > To: source-changes-d@netbsd.org > > On Tuesday, January 2, 2024 8:27:57 PM CET Christos Zoulas wrote: > > Module Name:src > > Committed By: christos > > Date: Tue Jan 2 19:27:57 UTC 2024 > > > > Modified Files: > > src/sys/sys: rbtree.h > > > > Log Message: > > This uses size_t, so it always needs , remove ifdefs. > > sys/types.h is one of the most polluting headers we have. This is a huge > step backwards... Yes, I think we should keep the ifdef and for userland uses should include stddef.h where size_t is supposed to come from (is inttypes.h really needed there, or is it it just b/c it happens to include most of the same stuff that stddef.h does and hence define size_t?) -uwe
CVS commit: src/share/man/man8
Module Name:src Committed By: uwe Date: Tue Jan 2 23:21:22 UTC 2024 Modified Files: src/share/man/man8: creds_msdos.8 Log Message: creds_msdos(8): move descriptions into the list itself To generate a diff of this commit: cvs rdiff -u -r1.3 -r1.4 src/share/man/man8/creds_msdos.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/man8/creds_msdos.8 diff -u src/share/man/man8/creds_msdos.8:1.3 src/share/man/man8/creds_msdos.8:1.4 --- src/share/man/man8/creds_msdos.8:1.3 Tue Jan 2 19:15:59 2024 +++ src/share/man/man8/creds_msdos.8 Tue Jan 2 23:21:22 2024 @@ -1,4 +1,4 @@ -.\" $NetBSD: creds_msdos.8,v 1.3 2024/01/02 19:15:59 uwe Exp $ +.\" $NetBSD: creds_msdos.8,v 1.4 2024/01/02 23:21:22 uwe Exp $ .\" .\" Copyright (c) 2019 Matthew R. Green .\" All rights reserved. @@ -54,61 +54,47 @@ it will inspect the file .Pa creds.txt for any credentials to be added to the system. .Pp -These are the supported options in the credentials files: -.Pp -.Bl -tag -compact -width Ic -offset indent -.It Ic sshkeyfile Ar user Ar keyfile -.It Ic sshkey Ar user Ar keystring -.It Ic useraddpwhash Ar user Ar pwhash -.It Ic useradd Ar user Ar password -.El -.Pp +The following list gives the supported options in the credentials files. In all cases .Ar user -is the username to be added, and the user will be -added to the +is the username to be created, and the user will be added to the .Ql wheel group. -.Pp -The -.Ic sshkeyfile -method looks in the MSDOS boot partition for -the specified file and merges ssh keys from this file into -.Ar user Ap s +.Bl -tag -width Ic +.\" +.It Ic sshkeyfile Ar user Ar keyfile +Look for the +.Ar keyfile +in the MSDOS boot partition and merge ssh keys from this file into user's .Pa ~/.ssh/authorized_keys file. -.Pp -The -.Ic sshkey -method adds the +.\" +.It Ic sshkey Ar user Ar keystring +Add the .Ar keystring -to the -.Ar user Ap s +to the user's .Pa ~/.ssh/authorized_keys file. -.Pp -The -.Ic useraddpwhash -method uses +.\" +.It Ic useraddpwhash Ar user Ar pwhash +Use .Ar pwhash -as the -.Ar users Ap s -password hash. -.Pp -The above three methods are the preferred methods. -.Pp -For the -.Ic useradd -method +as the users's password hash. +.\" +.It Ic useradd Ar user Ar password +Use .Ar password -is an unencrypted raw password that will be hashed and added to the system. -This method is not recommended as it leaves unencrypted passwords -around until such time that the script runs. +as the users's unencrypted raw password that will be hashed. +.Pp +This method is +.Em not recommended +as it leaves unencrypted passwords around until such time that the script runs. If this method is used then the .Pa creds.txt file will be shredded and deleted using .Ql rm -P after the credentials are updated. +.El .Sh FILES .Pa /boot/creds.txt .Sh SEE ALSO
CVS commit: src/share/man/man8
Module Name:src Committed By: uwe Date: Tue Jan 2 23:21:22 UTC 2024 Modified Files: src/share/man/man8: creds_msdos.8 Log Message: creds_msdos(8): move descriptions into the list itself To generate a diff of this commit: cvs rdiff -u -r1.3 -r1.4 src/share/man/man8/creds_msdos.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/man8
Module Name:src Committed By: uwe Date: Tue Jan 2 19:15:59 UTC 2024 Modified Files: src/share/man/man8: creds_msdos.8 Log Message: creds_msdos(8): touch up mark up a bit To generate a diff of this commit: cvs rdiff -u -r1.2 -r1.3 src/share/man/man8/creds_msdos.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/man8
Module Name:src Committed By: uwe Date: Tue Jan 2 19:15:59 UTC 2024 Modified Files: src/share/man/man8: creds_msdos.8 Log Message: creds_msdos(8): touch up mark up a bit To generate a diff of this commit: cvs rdiff -u -r1.2 -r1.3 src/share/man/man8/creds_msdos.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/man8/creds_msdos.8 diff -u src/share/man/man8/creds_msdos.8:1.2 src/share/man/man8/creds_msdos.8:1.3 --- src/share/man/man8/creds_msdos.8:1.2 Sat Dec 11 19:24:19 2021 +++ src/share/man/man8/creds_msdos.8 Tue Jan 2 19:15:59 2024 @@ -1,4 +1,4 @@ -.\" $NetBSD: creds_msdos.8,v 1.2 2021/12/11 19:24:19 mrg Exp $ +.\" $NetBSD: creds_msdos.8,v 1.3 2024/01/02 19:15:59 uwe Exp $ .\" .\" Copyright (c) 2019 Matthew R. Green .\" All rights reserved. @@ -55,34 +55,41 @@ it will inspect the file for any credentials to be added to the system. .Pp These are the supported options in the credentials files: -.Bl -tag -compact -width "sshkeyfilepl" -offset indent -.It Sy sshkeyfile Ar user Ar keyfile -.It Sy sshkey Ar user Ar keystring -.It Sy useraddpwhash Ar user Ar pwhash -.It Sy useradd Ar user Ar password +.Pp +.Bl -tag -compact -width Ic -offset indent +.It Ic sshkeyfile Ar user Ar keyfile +.It Ic sshkey Ar user Ar keystring +.It Ic useraddpwhash Ar user Ar pwhash +.It Ic useradd Ar user Ar password .El .Pp In all cases .Ar user is the username to be added, and the user will be added to the -.Dq wheel +.Ql wheel group. .Pp -The sshkeyfile method looks in the MSDOS boot partition for +The +.Ic sshkeyfile +method looks in the MSDOS boot partition for the specified file and merges ssh keys from this file into .Ar user Ap s .Pa ~/.ssh/authorized_keys file. .Pp -The sshkey method adds the +The +.Ic sshkey +method adds the .Ar keystring to the .Ar user Ap s .Pa ~/.ssh/authorized_keys file. .Pp -The useraddpwhash method uses +The +.Ic useraddpwhash +method uses .Ar pwhash as the .Ar users Ap s @@ -90,7 +97,9 @@ password hash. .Pp The above three methods are the preferred methods. .Pp -For the useradd method +For the +.Ic useradd +method .Ar password is an unencrypted raw password that will be hashed and added to the system. This method is not recommended as it leaves unencrypted passwords @@ -98,7 +107,7 @@ around until such time that the script r If this method is used then the .Pa creds.txt file will be shredded and deleted using -.Dq rm -P +.Ql rm -P after the credentials are updated. .Sh FILES .Pa /boot/creds.txt
CVS commit: src/usr.sbin/syslogd
Module Name:src Committed By: uwe Date: Sun Dec 31 23:39:27 UTC 2023 Modified Files: src/usr.sbin/syslogd: syslog.conf.5 Log Message: syslog.conf(5): add back .Pp lost in previous To generate a diff of this commit: cvs rdiff -u -r1.27 -r1.28 src/usr.sbin/syslogd/syslog.conf.5 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/syslogd/syslog.conf.5 diff -u src/usr.sbin/syslogd/syslog.conf.5:1.27 src/usr.sbin/syslogd/syslog.conf.5:1.28 --- src/usr.sbin/syslogd/syslog.conf.5:1.27 Sun Dec 31 19:41:22 2023 +++ src/usr.sbin/syslogd/syslog.conf.5 Sun Dec 31 23:39:27 2023 @@ -1,4 +1,4 @@ -.\" $NetBSD: syslog.conf.5,v 1.27 2023/12/31 19:41:22 uwe Exp $ +.\" $NetBSD: syslog.conf.5,v 1.28 2023/12/31 23:39:27 uwe Exp $ .\" .\" Copyright (c) 1990, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -477,10 +477,11 @@ List of fingerprints of trusted client c .It Ic tls_allow_clientcerts List of filenames with trusted client certificates. .El +.Pp One function of TLS is mutual authentication of client and server. Unless authentication is disabled by setting .Ql tls_verify=off -the following rules are used: +the following rules are used. .Ss "Client Authentication" A client can be configured not to check a server's certificate by setting the
CVS commit: src/usr.sbin/syslogd
Module Name:src Committed By: uwe Date: Sun Dec 31 23:39:27 UTC 2023 Modified Files: src/usr.sbin/syslogd: syslog.conf.5 Log Message: syslog.conf(5): add back .Pp lost in previous To generate a diff of this commit: cvs rdiff -u -r1.27 -r1.28 src/usr.sbin/syslogd/syslog.conf.5 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/usr.sbin/syslogd
Module Name:src Committed By: uwe Date: Sun Dec 31 19:41:22 UTC 2023 Modified Files: src/usr.sbin/syslogd: syslog.conf.5 Log Message: syslog.conf(5): improve markup Use tagged lists, mark up literals, be consistent about options (global): vs parameters (of a TLS action), fold TLS authentication description into the TLS options section. To generate a diff of this commit: cvs rdiff -u -r1.26 -r1.27 src/usr.sbin/syslogd/syslog.conf.5 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/syslogd/syslog.conf.5 diff -u src/usr.sbin/syslogd/syslog.conf.5:1.26 src/usr.sbin/syslogd/syslog.conf.5:1.27 --- src/usr.sbin/syslogd/syslog.conf.5:1.26 Wed Sep 1 13:44:02 2021 +++ src/usr.sbin/syslogd/syslog.conf.5 Sun Dec 31 19:41:22 2023 @@ -1,4 +1,4 @@ -.\" $NetBSD: syslog.conf.5,v 1.26 2021/09/01 13:44:02 andvar Exp $ +.\" $NetBSD: syslog.conf.5,v 1.27 2023/12/31 19:41:22 uwe Exp $ .\" .\" Copyright (c) 1990, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -43,7 +43,12 @@ The file is the configuration file for the .Xr syslogd 8 program. -It consists of extended options (lines with one key="value" assignment) +It consists of extended options +.Po +lines with one +.Ar key\^ Ns Li = Ns Ar value +assignment +.Pc and blocks of lines separated by .Em program and @@ -62,15 +67,22 @@ field is separated from the .Em action field by one or more tab characters. .Pp +Blank lines and lines whose first non-blank character is a hash +.Pq Ql # +character are ignored. +.\" +.Ss Selectors +.Pp The -.Em Selectors +.Em selector Ns s function are encoded as a .Em facility , a period -.Pq Sq \&. , -an optional set of comparison flags -.Pq Bo ! Bc Bq <=> , +.Pq Ql \&. , +an optional set of +.Em comparison flags +.Pq Oo Li \&! Oc Ns Op Li <=> , and a .Em level , with no intervening white-space. @@ -83,11 +95,31 @@ are case insensitive. The .Em facility describes the part of the system generating the message, and is one of -the following keywords: auth, authpriv, cron, ftp, daemon, kern, lpr, -mail, mark, news, syslog, user, uucp and local0 through local7. -These keywords (with the exception of mark) correspond to the -similar -.Dq Dv LOG_ +the following keywords: +.Ic auth , +.Ic authpriv , +.Ic cron , +.Ic daemon , +.Ic ftp , +.Ic kern , +.Ic lpr , +.Ic mail , +.Ic mark , +.Ic news , +.Ic syslog , +.Ic user , +.Ic uucp , +and +.Ic local0 +through +.Ic local7 . +These keywords +.Po +with the exception of +.Ic mark +.Pc +correspond to the similar +.Ql LOG_ values specified to the .Xr openlog 3 and @@ -98,32 +130,40 @@ The .Em comparison flags may be used to specify exactly what levels are logged. If unspecified, the default comparison is -.Sq >= +.Ql >= .Pq greater than or equal to , or, if the .Fl U option is passed to .Xr syslogd 8 , -.Sq = +.Ql = .Pq equal to . Comparison flags beginning with -.So ! Sc +.Ql \&! will have their logical sense inverted. Thus, -.Sq !=info +.Ql !=info means all levels except info and -.Sq !notice +.Ql !notice has the same meaning as -.Sq
CVS commit: src/usr.sbin/syslogd
Module Name:src Committed By: uwe Date: Sun Dec 31 19:41:22 UTC 2023 Modified Files: src/usr.sbin/syslogd: syslog.conf.5 Log Message: syslog.conf(5): improve markup Use tagged lists, mark up literals, be consistent about options (global): vs parameters (of a TLS action), fold TLS authentication description into the TLS options section. To generate a diff of this commit: cvs rdiff -u -r1.26 -r1.27 src/usr.sbin/syslogd/syslog.conf.5 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/etc
Module Name:src Committed By: uwe Date: Sun Dec 31 03:57:48 UTC 2023 Modified Files: src/etc: newsyslog.conf Log Message: newsyslog.conf: collate npflog0.pcap properly To generate a diff of this commit: cvs rdiff -u -r1.24 -r1.25 src/etc/newsyslog.conf Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/etc/newsyslog.conf diff -u src/etc/newsyslog.conf:1.24 src/etc/newsyslog.conf:1.25 --- src/etc/newsyslog.conf:1.24 Thu May 16 20:12:35 2019 +++ src/etc/newsyslog.conf Sun Dec 31 03:57:48 2023 @@ -1,4 +1,4 @@ -# $NetBSD: newsyslog.conf,v 1.24 2019/05/16 20:12:35 nakayama Exp $ +# $NetBSD: newsyslog.conf,v 1.25 2023/12/31 03:57:48 uwe Exp $ # # Configuration file for newsyslog(8). # @@ -8,9 +8,9 @@ /var/log/cron root:wheel 600 3100 *Z /var/log/kerberos.log 640 7*24 ZN /var/log/lpd-errs 640 7100 *Z -/var/log/npflog0.pcap 600 7100 *ZB /var/run/npfd.pid /var/log/maillog 600 7*24 Z /var/log/messages 644 10 250 *Z +/var/log/npflog0.pcap 600 7100 *ZB /var/run/npfd.pid /var/log/wtmp root:utmp 664 7*168 ZBN /var/log/wtmpx root:utmp 664 7*168 ZBN /var/log/xferlog 640 7250 *Z
CVS commit: src/etc
Module Name:src Committed By: uwe Date: Sun Dec 31 03:57:48 UTC 2023 Modified Files: src/etc: newsyslog.conf Log Message: newsyslog.conf: collate npflog0.pcap properly To generate a diff of this commit: cvs rdiff -u -r1.24 -r1.25 src/etc/newsyslog.conf Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/sys/arch/netwinder/conf
Module Name:src
Committed By: uwe
Date: Wed Dec 27 19:58:22 UTC 2023
Modified Files:
src/sys/arch/netwinder/conf: kern.ldscript
Log Message:
netwinder: kern.ldscript - preserve the .text section alignment
This change from evbarm was omitted in previous, but older binutils in
netbsd-10 seem to need it.
To generate a diff of this commit:
cvs rdiff -u -r1.11 -r1.12 src/sys/arch/netwinder/conf/kern.ldscript
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/netwinder/conf/kern.ldscript
diff -u src/sys/arch/netwinder/conf/kern.ldscript:1.11 src/sys/arch/netwinder/conf/kern.ldscript:1.12
--- src/sys/arch/netwinder/conf/kern.ldscript:1.11 Mon Dec 18 23:12:43 2023
+++ src/sys/arch/netwinder/conf/kern.ldscript Wed Dec 27 19:58:22 2023
@@ -1,4 +1,4 @@
-/* $NetBSD: kern.ldscript,v 1.11 2023/12/18 23:12:43 uwe Exp $ */
+/* $NetBSD: kern.ldscript,v 1.12 2023/12/27 19:58:22 uwe Exp $ */
SECTIONS
{
@@ -12,8 +12,8 @@ SECTIONS
}
/* Read-only sections, merged into text segment: */
- .text (KERNEL_BASE_virt + SIZEOF(.start)) :
- AT (LOADADDR(.start) + SIZEOF(.start))
+ .text (KERNEL_BASE_virt + ALIGN(SIZEOF(.start), ALIGNOF(.text))) :
+ AT (LOADADDR(.start) + ALIGN(SIZEOF(.start), ALIGNOF(.text)))
{
*(.text)
*(.text.*)
CVS commit: src/sys/arch/netwinder/conf
Module Name:src Committed By: uwe Date: Wed Dec 27 19:58:22 UTC 2023 Modified Files: src/sys/arch/netwinder/conf: kern.ldscript Log Message: netwinder: kern.ldscript - preserve the .text section alignment This change from evbarm was omitted in previous, but older binutils in netbsd-10 seem to need it. To generate a diff of this commit: cvs rdiff -u -r1.11 -r1.12 src/sys/arch/netwinder/conf/kern.ldscript Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
CVS commit: src/sys/arch/netwinder/conf
Module Name:src Committed By: uwe Date: Tue Dec 19 02:35:17 UTC 2023 Modified Files: src/sys/arch/netwinder/conf: GENERIC Log Message: netwinder: GENERIC - trim down some more Disable more stuff to make GENERIC just about fit. To generate a diff of this commit: cvs rdiff -u -r1.146 -r1.147 src/sys/arch/netwinder/conf/GENERIC 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/netwinder/conf/GENERIC diff -u src/sys/arch/netwinder/conf/GENERIC:1.146 src/sys/arch/netwinder/conf/GENERIC:1.147 --- src/sys/arch/netwinder/conf/GENERIC:1.146 Tue Dec 19 01:52:44 2023 +++ src/sys/arch/netwinder/conf/GENERIC Tue Dec 19 02:35:17 2023 @@ -1,4 +1,4 @@ -# $NetBSD: GENERIC,v 1.146 2023/12/19 01:52:44 uwe Exp $ +# $NetBSD: GENERIC,v 1.147 2023/12/19 02:35:17 uwe Exp $ # # GENERIC machine description file # @@ -54,7 +54,7 @@ file-system FFS # UFS file-system MFS # memory file system file-system NFS # Network file system #file-system ADOSFS # AmigaDOS-compatible file system -file-system EXT2FS # second extended file system (linux) +#file-system EXT2FS # second extended file system (linux) #file-system CD9660 # ISO 9660 + Rock Ridge file system file-system MSDOSFS # MS-DOS file system file-system FDESC # /dev/fd @@ -75,7 +75,7 @@ file-system TMPFS # Efficient memory fi #options UFS_DIRHASH # UFS Large Directory Hashing #options UFS_EXTATTR # Extended attribute support for UFS1 options WAPBL # File system journaling support -options NFSSERVER # Network File System server +#options NFSSERVER # Network File System server # Networking options @@ -147,7 +147,7 @@ options SYSCTL_INCLUDE_DESCR # Include options DDB # in-kernel debugger options DDB_HISTORY_SIZE=100 # Enable history editing in DDB #makeoptions DEBUG="-g" # compile full symbol table -makeoptions COPY_SYMTAB=1 +#makeoptions COPY_SYMTAB=1 # see also ksyms below config netbsd root on ? type ? @@ -260,8 +260,8 @@ spkr* at audio? # PC speaker (synthesiz # Pseudo-Devices -pseudo-device crypto # /dev/crypto device -pseudo-device swcrypto # software crypto implementation +#pseudo-device crypto # /dev/crypto device +#pseudo-device swcrypto # software crypto implementation # disk/mass storage pseudo-devices #pseudo-device md # memory disk device (ramdisk) @@ -273,7 +273,7 @@ pseudo-device fss # file system snapsh # network pseudo-devices pseudo-device bpfilter # Berkeley packet filter pseudo-device carp # Common Address Redundancy Protocol -pseudo-device pppoe # PPP over Ethernet (RFC 2516) +#pseudo-device pppoe # PPP over Ethernet (RFC 2516) pseudo-device bridge # simple inter-network bridging #pseudo-device vether # Virtual Ethernet for bridge pseudo-device loop # network loopback @@ -295,7 +295,7 @@ pseudo-device swwdog # software watch pseudo-device wsmux # mouse & keyboard multiplexor #pseudo-device wsfont -include "dev/veriexec.config" +#include "dev/veriexec.config" # Pull in optional local configuration - always at end cinclude "arch/netwinder/conf/GENERIC.local"
CVS commit: src/sys/arch/netwinder/conf
Module Name:src Committed By: uwe Date: Tue Dec 19 02:35:17 UTC 2023 Modified Files: src/sys/arch/netwinder/conf: GENERIC Log Message: netwinder: GENERIC - trim down some more Disable more stuff to make GENERIC just about fit. To generate a diff of this commit: cvs rdiff -u -r1.146 -r1.147 src/sys/arch/netwinder/conf/GENERIC Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
