diff options
Diffstat (limited to 'upstream/mageia-cauldron/man5')
67 files changed, 831 insertions, 371 deletions
diff --git a/upstream/mageia-cauldron/man5/anacrontab.5 b/upstream/mageia-cauldron/man5/anacrontab.5 index 507cfd80..f7ca5c00 100644 --- a/upstream/mageia-cauldron/man5/anacrontab.5 +++ b/upstream/mageia-cauldron/man5/anacrontab.5 @@ -81,6 +81,10 @@ and .I MAILTO variables are expanded, so setting them as in the following example works as expected: MAILFROM=cron-$USER@cron.com ($USER is replaced by the system user) ) .PP +If +.I NO_MAIL_OUTPUT +is defined (and non-empty), the standard output and error descriptors of job processes are not redirected and e-mailed. +.PP .PP Empty lines are either blank lines, line containing white spaces only, or lines with white spaces followed by a '#' followed by an arbitrary diff --git a/upstream/mageia-cauldron/man5/btrfs.5 b/upstream/mageia-cauldron/man5/btrfs.5 index 254a8894..4d63f28f 100644 --- a/upstream/mageia-cauldron/man5/btrfs.5 +++ b/upstream/mageia-cauldron/man5/btrfs.5 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "BTRFS" "5" "Jan 09, 2024" "6.6.3" "BTRFS" +.TH "BTRFS" "5" "Mar 10, 2024" "6.7.1" "BTRFS" .SH NAME btrfs \- topics about the BTRFS filesystem (mount options, supported file attributes and other) .SH DESCRIPTION @@ -1058,7 +1058,7 @@ there\(aqs no increase. Each data block has a separate checksum stored, with additional overhead of the b\-tree leaves. .sp Approximate relative performance of the algorithms, measured against CRC32C -using reference software implementations on a 3.5GHz intel CPU: +using implementations on a 11th gen 3.6GHz intel CPU: .TS center; |l|l|l|l|. @@ -1076,19 +1076,19 @@ _ T{ CRC32C T} T{ -1700 +470 T} T{ 1.00 T} T{ -CPU instruction +CPU instruction, PCL combination T} _ T{ XXHASH T} T{ -2500 +870 T} T{ -1.44 +1.9 T} T{ reference impl. T} @@ -1096,61 +1096,131 @@ _ T{ SHA256 T} T{ -105000 +7600 T} T{ -61 +16 T} T{ -reference impl. +libgcrypt T} _ T{ SHA256 T} T{ -36000 +8500 T} T{ -21 +18 +T} T{ +openssl +T} +_ +T{ +SHA256 T} T{ -libgcrypt/AVX2 +8700 +T} T{ +18 +T} T{ +botan T} _ T{ SHA256 T} T{ -63000 +32000 T} T{ -37 +68 T} T{ -libsodium/AVX2 +builtin, CPU instruction +T} +_ +T{ +SHA256 +T} T{ +37000 +T} T{ +78 +T} T{ +libsodium +T} +_ +T{ +SHA256 +T} T{ +78000 +T} T{ +166 +T} T{ +builtin, reference impl. T} _ T{ BLAKE2b T} T{ -22000 +10000 T} T{ -13 +21 T} T{ -reference impl. +builtin/AVX2 +T} +_ +T{ +BLAKE2b +T} T{ +10900 +T} T{ +23 +T} T{ +libgcrypt +T} +_ +T{ +BLAKE2b +T} T{ +13500 +T} T{ +29 +T} T{ +builtin/SSE41 +T} +_ +T{ +BLAKE2b +T} T{ +13700 +T} T{ +29 +T} T{ +libsodium +T} +_ +T{ +BLAKE2b +T} T{ +14100 +T} T{ +30 +T} T{ +openssl T} _ T{ BLAKE2b T} T{ -19000 +14500 T} T{ -11 +31 T} T{ -libgcrypt/AVX2 +kcapi T} _ T{ BLAKE2b T} T{ -19000 +14500 T} T{ -11 +34 T} T{ -libsodium/AVX2 +builtin, reference impl. T} _ .TE diff --git a/upstream/mageia-cauldron/man5/crontab.5 b/upstream/mageia-cauldron/man5/crontab.5 index 5d898627..341c119b 100644 --- a/upstream/mageia-cauldron/man5/crontab.5 +++ b/upstream/mageia-cauldron/man5/crontab.5 @@ -98,7 +98,8 @@ This option is useful if you decide to use /bin/mail instead of aliasing and UUCP usually does not read its mail. If .I MAILFROM is defined (and non-empty), it is used as the envelope sender address, -otherwise, ``root'' is used. +otherwise, the username of the executing user is used. This variable is +also inherited from the crond process environment. .PP (Note: Both .I MAILFROM @@ -223,7 +224,10 @@ For example, "0-23/2" can be used in the 'hours' field to specify command execution for every other hour (the alternative in the V7 standard is "0,\:2,\:4,\:6,\:8,\:10,\:12,\:14,\:16,\:18,\:20,\:22"). Step values are also permitted after an asterisk, so if specifying a job to be run every -two hours, you can use "*/2". +two hours, you can use "*/2". Please note that steps are evaluated just +within the field they are applied to. For example "*/23" in hours field +means to execute the job on the hour 0 and the hour 23 within a calendar +day. See "NOTES" below for a workaround. .PP Names can also be used for the 'month' and 'day of week' fields. Use the first three letters of the particular day or month (case does not @@ -287,6 +291,20 @@ optional. MAILTO=root * * * * * root touch /tmp/file .fi +.SH NOTES +As noted above, skip values only operate within the time period they\'re +attached to. For example, specifying "0/35" for the minute field of a +crontab entry won\'t cause that entry to be executed every 35 minutes; +instead, it will be executed twice every hour, at 0 and 35 minutes past. +For more fine-grained control you can do something like this: +.nf +* * * * * if [ $(expr \\( $(date +%s) / 60 \\) % 58) = 0 ]; then echo this runs every 58 minutes; fi +0 * * * * if [ $(expr \\( $(date +%s) / 3600 \\) % 23) = 0 ]; then echo this runs every 23 hours on the hour; fi +.fi +Adjust as needed if your +.BR date (1) +command does not accept "+%s" as the format string specifier to output +the current UNIX timestamp. .SH SELinux with multi level security (MLS) In a crontab, it is important to specify a security level by .I crontab \-s diff --git a/upstream/mageia-cauldron/man5/crypttab.5 b/upstream/mageia-cauldron/man5/crypttab.5 index 1a621795..ea25e7c6 100644 --- a/upstream/mageia-cauldron/man5/crypttab.5 +++ b/upstream/mageia-cauldron/man5/crypttab.5 @@ -206,7 +206,7 @@ option described below to use this mechanism\&. .PP For the latter five mechanisms the source for the key material used for unlocking the volume is primarily configured in the third field of each /etc/crypttab -line, but may also configured in +line, but may also be configured in /etc/cryptsetup\-keys\&.d/ and /run/cryptsetup\-keys\&.d/ @@ -852,7 +852,7 @@ stream socket in the file system, the key is acquired by connecting to the socke \fBAF_UNIX\fR socket name in the abstract namespace, see \fBunix\fR(7) -for details\&. The source socket name is chosen according the following format: +for details\&. The source socket name is chosen according to the following format: .sp .if n \{\ .RS 4 diff --git a/upstream/mageia-cauldron/man5/depmod.d.5 b/upstream/mageia-cauldron/man5/depmod.d.5 index 43de3638..ac6fa8fc 100644 --- a/upstream/mageia-cauldron/man5/depmod.d.5 +++ b/upstream/mageia-cauldron/man5/depmod.d.5 @@ -2,12 +2,12 @@ .\" Title: depmod.d .\" Author: Jon Masters <jcm@jonmasters.org> .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/> -.\" Date: 02/09/2023 +.\" Date: 03/05/2024 .\" Manual: depmod.d .\" Source: kmod .\" Language: English .\" -.TH "DEPMOD\&.D" "5" "02/09/2023" "kmod" "depmod.d" +.TH "DEPMOD\&.D" "5" "03/05/2024" "kmod" "depmod.d" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -31,6 +31,8 @@ depmod.d \- Configuration directory for depmod .SH "SYNOPSIS" .PP +/lib/depmod\&.d/*\&.conf +.PP /usr/lib/depmod\&.d/*\&.conf .PP /usr/local/lib/depmod\&.d/*\&.conf diff --git a/upstream/mageia-cauldron/man5/icewm-env.5 b/upstream/mageia-cauldron/man5/icewm-env.5 index d9aeb44a..d2e27cd0 100644 --- a/upstream/mageia-cauldron/man5/icewm-env.5 +++ b/upstream/mageia-cauldron/man5/icewm-env.5 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "ICEWM-ENV 5" -.TH ICEWM-ENV 5 2023-12-28 "icewm 3.4.5" "Standards, Environments and Macros" +.TH ICEWM-ENV 5 2024-05-20 "icewm 3.5.0" "Standards, Environments and Macros" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/mageia-cauldron/man5/icewm-focus_mode.5 b/upstream/mageia-cauldron/man5/icewm-focus_mode.5 index 08551870..5848997b 100644 --- a/upstream/mageia-cauldron/man5/icewm-focus_mode.5 +++ b/upstream/mageia-cauldron/man5/icewm-focus_mode.5 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "ICEWM-FOCUS_MODE 5" -.TH ICEWM-FOCUS_MODE 5 2023-12-28 "icewm 3.4.5" "Standards, Environments and Macros" +.TH ICEWM-FOCUS_MODE 5 2024-05-20 "icewm 3.5.0" "Standards, Environments and Macros" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/mageia-cauldron/man5/icewm-keys.5 b/upstream/mageia-cauldron/man5/icewm-keys.5 index d6e959b7..a60b59c2 100644 --- a/upstream/mageia-cauldron/man5/icewm-keys.5 +++ b/upstream/mageia-cauldron/man5/icewm-keys.5 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "ICEWM-KEYS 5" -.TH ICEWM-KEYS 5 2023-12-28 "icewm 3.4.5" "Standards, Environments and Macros" +.TH ICEWM-KEYS 5 2024-05-20 "icewm 3.5.0" "Standards, Environments and Macros" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l @@ -102,7 +102,10 @@ following four ways, which are identical: \& key "Ctrl++" xterm .Ve .PP -To bind the mouse use \f(CW\*(C`Pointer_Button1\*(C'\fR for button 1, and so on. +To bind the mouse, use \f(CW\*(C`Pointer_Button1\*(C'\fR for button 1, and so on. +This only works when the mouse is over the root window. +See below for examples. +.PP The command \f(CW\*(C`icesh keys\*(C'\fR instructs icewm to reload this file. .SS FORMAT .IX Subsection "FORMAT" diff --git a/upstream/mageia-cauldron/man5/icewm-menu.5 b/upstream/mageia-cauldron/man5/icewm-menu.5 index c523891c..eb0c925c 100644 --- a/upstream/mageia-cauldron/man5/icewm-menu.5 +++ b/upstream/mageia-cauldron/man5/icewm-menu.5 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "ICEWM-MENU 5" -.TH ICEWM-MENU 5 2023-12-28 "icewm 3.4.5" "Standards, Environments and Macros" +.TH ICEWM-MENU 5 2024-05-20 "icewm 3.5.0" "Standards, Environments and Macros" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/mageia-cauldron/man5/icewm-preferences.5 b/upstream/mageia-cauldron/man5/icewm-preferences.5 index 94bdd49e..0f55d182 100644 --- a/upstream/mageia-cauldron/man5/icewm-preferences.5 +++ b/upstream/mageia-cauldron/man5/icewm-preferences.5 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "ICEWM-PREFERENCES 5" -.TH ICEWM-PREFERENCES 5 2023-12-28 "icewm 3.4.5" "Standards, Environments and Macros" +.TH ICEWM-PREFERENCES 5 2024-05-20 "icewm 3.5.0" "Standards, Environments and Macros" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/mageia-cauldron/man5/icewm-prefoverride.5 b/upstream/mageia-cauldron/man5/icewm-prefoverride.5 index ff68c344..eb1fbe00 100644 --- a/upstream/mageia-cauldron/man5/icewm-prefoverride.5 +++ b/upstream/mageia-cauldron/man5/icewm-prefoverride.5 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "ICEWM-PREFOVERRIDE 5" -.TH ICEWM-PREFOVERRIDE 5 2023-12-28 "icewm 3.4.5" "Standards, Environments and Macros" +.TH ICEWM-PREFOVERRIDE 5 2024-05-20 "icewm 3.5.0" "Standards, Environments and Macros" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/mageia-cauldron/man5/icewm-programs.5 b/upstream/mageia-cauldron/man5/icewm-programs.5 index fa8733fa..f76c1910 100644 --- a/upstream/mageia-cauldron/man5/icewm-programs.5 +++ b/upstream/mageia-cauldron/man5/icewm-programs.5 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "ICEWM-PROGRAMS 5" -.TH ICEWM-PROGRAMS 5 2023-12-28 "icewm 3.4.5" "Standards, Environments and Macros" +.TH ICEWM-PROGRAMS 5 2024-05-20 "icewm 3.5.0" "Standards, Environments and Macros" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/mageia-cauldron/man5/icewm-shutdown.5 b/upstream/mageia-cauldron/man5/icewm-shutdown.5 index d8029628..534772b8 100644 --- a/upstream/mageia-cauldron/man5/icewm-shutdown.5 +++ b/upstream/mageia-cauldron/man5/icewm-shutdown.5 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "ICEWM-SHUTDOWN 5" -.TH ICEWM-SHUTDOWN 5 2023-12-28 "icewm 3.4.5" "Standards, Environments and Macros" +.TH ICEWM-SHUTDOWN 5 2024-05-20 "icewm 3.5.0" "Standards, Environments and Macros" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/mageia-cauldron/man5/icewm-startup.5 b/upstream/mageia-cauldron/man5/icewm-startup.5 index 2c797cfe..22044517 100644 --- a/upstream/mageia-cauldron/man5/icewm-startup.5 +++ b/upstream/mageia-cauldron/man5/icewm-startup.5 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "ICEWM-STARTUP 5" -.TH ICEWM-STARTUP 5 2023-12-28 "icewm 3.4.5" "Standards, Environments and Macros" +.TH ICEWM-STARTUP 5 2024-05-20 "icewm 3.5.0" "Standards, Environments and Macros" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/mageia-cauldron/man5/icewm-theme.5 b/upstream/mageia-cauldron/man5/icewm-theme.5 index 138a6d6a..6775255c 100644 --- a/upstream/mageia-cauldron/man5/icewm-theme.5 +++ b/upstream/mageia-cauldron/man5/icewm-theme.5 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "ICEWM-THEME 5" -.TH ICEWM-THEME 5 2023-12-28 "icewm 3.4.5" "Standards, Environments and Macros" +.TH ICEWM-THEME 5 2024-05-20 "icewm 3.5.0" "Standards, Environments and Macros" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/mageia-cauldron/man5/icewm-toolbar.5 b/upstream/mageia-cauldron/man5/icewm-toolbar.5 index afea02bd..7ea7e4e9 100644 --- a/upstream/mageia-cauldron/man5/icewm-toolbar.5 +++ b/upstream/mageia-cauldron/man5/icewm-toolbar.5 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "ICEWM-TOOLBAR 5" -.TH ICEWM-TOOLBAR 5 2023-12-28 "icewm 3.4.5" "Standards, Environments and Macros" +.TH ICEWM-TOOLBAR 5 2024-05-20 "icewm 3.5.0" "Standards, Environments and Macros" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/mageia-cauldron/man5/icewm-winoptions.5 b/upstream/mageia-cauldron/man5/icewm-winoptions.5 index ba04a452..7a257ecb 100644 --- a/upstream/mageia-cauldron/man5/icewm-winoptions.5 +++ b/upstream/mageia-cauldron/man5/icewm-winoptions.5 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "ICEWM-WINOPTIONS 5" -.TH ICEWM-WINOPTIONS 5 2023-12-28 "icewm 3.4.5" "Standards, Environments and Macros" +.TH ICEWM-WINOPTIONS 5 2024-05-20 "icewm 3.5.0" "Standards, Environments and Macros" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/mageia-cauldron/man5/modprobe.d.5 b/upstream/mageia-cauldron/man5/modprobe.d.5 index fb2ac159..8b54f18b 100644 --- a/upstream/mageia-cauldron/man5/modprobe.d.5 +++ b/upstream/mageia-cauldron/man5/modprobe.d.5 @@ -2,12 +2,12 @@ .\" Title: modprobe.d .\" Author: Jon Masters <jcm@jonmasters.org> .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/> -.\" Date: 02/09/2023 +.\" Date: 03/05/2024 .\" Manual: modprobe.d .\" Source: kmod .\" Language: English .\" -.TH "MODPROBE\&.D" "5" "02/09/2023" "kmod" "modprobe.d" +.TH "MODPROBE\&.D" "5" "03/05/2024" "kmod" "modprobe.d" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -33,6 +33,8 @@ modprobe.d \- Configuration directory for modprobe .PP /lib/modprobe\&.d/*\&.conf .PP +/usr/lib/modprobe\&.d/*\&.conf +.PP /usr/local/lib/modprobe\&.d/*\&.conf .PP /run/modprobe\&.d/*\&.conf diff --git a/upstream/mageia-cauldron/man5/modules.dep.5 b/upstream/mageia-cauldron/man5/modules.dep.5 index ac9e2846..cdd0bfff 100644 --- a/upstream/mageia-cauldron/man5/modules.dep.5 +++ b/upstream/mageia-cauldron/man5/modules.dep.5 @@ -2,12 +2,12 @@ .\" Title: modules.dep .\" Author: Jon Masters <jcm@jonmasters.org> .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/> -.\" Date: 02/09/2023 +.\" Date: 03/05/2024 .\" Manual: modules.dep .\" Source: kmod .\" Language: English .\" -.TH "MODULES\&.DEP" "5" "02/09/2023" "kmod" "modules.dep" +.TH "MODULES\&.DEP" "5" "03/05/2024" "kmod" "modules.dep" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- diff --git a/upstream/mageia-cauldron/man5/org.freedesktop.resolve1.5 b/upstream/mageia-cauldron/man5/org.freedesktop.resolve1.5 index 4f3b397f..2046567f 100644 --- a/upstream/mageia-cauldron/man5/org.freedesktop.resolve1.5 +++ b/upstream/mageia-cauldron/man5/org.freedesktop.resolve1.5 @@ -420,6 +420,32 @@ set) so that all settings take effect during the full time the network interface The \fBRevertLink()\fR method may be used to revert all per\-link settings described above to the defaults\&. +.PP +The +\fBFlushCaches()\fR +flushes all resource record caches maintained by the resolver, and ensures that any subsequent lookups re\-request their responses from their sources\&. +.PP +The +\fBResetServerFeatures()\fR +flushes any feature information learned about remote DNS servers\&. This ensures that subsequent lookups will be initially attempted at the highest DNS protocol feature level again, possibly requiring a (potentially slow) downgrade cycle to recognize the supported feature level again\&. +.PP +The +\fBRegisterService()\fR +method may be used to register a DNS\-SD service on the host\&. This functionality is closely related to the functionality provided by +\fBsystemd.dnssd\fR(5) +files\&. It takes a server identifier string as first parameter (this is jus a local identifier, and should be chosen so that it neither collides with the basename of +*\&.dnssd +files nor with names chosen by other IPC clients)\&. It also takes a name template string for the DNS\-SD service name visible on the network\&. This string is subject to specifier expansation, as documented for the +\fIName=\fR +setting in +*\&.dnssd +files\&. It also takes a service type string containing the DNS\-SD service type, as well as an IP port, a priority/weight pair for the DNS\-SD SRV record\&. Finally, it takes an array of TXT record data\&. It returns an object path which may be used as handle to the registered service\&. +.PP +The +\fBUnregisterService()\fR +method undoes the effect of +\fBRegisterService()\fR +and deletes a DNS\-SD service previously created via IPC again\&. .sp .it 1 an-trap .nr an-no-space-flag 1 @@ -646,6 +672,10 @@ property reports whether the stub listener on port 53 is enabled\&. Possible val (only the UDP listener is enabled), and "tcp" (only the TCP listener is enabled)\&. +.PP +The +\fIDNSSECNegativeTrustAnchors\fR +property contains a list of recognized DNSSEC negative trust anchors and contains a list of domains\&. .SH "LINK OBJECT" .sp .if n \{\ diff --git a/upstream/mageia-cauldron/man5/repart.d.5 b/upstream/mageia-cauldron/man5/repart.d.5 index 17e247f9..ef7c0968 100644 --- a/upstream/mageia-cauldron/man5/repart.d.5 +++ b/upstream/mageia-cauldron/man5/repart.d.5 @@ -366,7 +366,7 @@ too\&. The logic is capable of automatically tracking down the backing partition "CopyBlocks=auto" is useful for implementing "self\-replicating" systems, i\&.e\&. systems that are their own installer\&. .sp -The file specified here must have a size that is a multiple of the basic block size 512 and not be empty\&. If this option is used, the size allocation algorithm is slightly altered: the partition is created as least as big as required to fit the data in, i\&.e\&. the data size is an additional minimum size value taken into consideration for the allocation algorithm, similar to and in addition to the +The file specified here must have a size that is a multiple of the basic block size 512 and not be empty\&. If this option is used, the size allocation algorithm is slightly altered: the partition is created at least as big as required to fit the data in, i\&.e\&. the data size is an additional minimum size value taken into consideration for the allocation algorithm, similar to and in addition to the \fISizeMin=\fR value configured above\&. .sp @@ -390,7 +390,7 @@ Takes a file system name, such as "erofs", "squashfs" or the special value -"swap"\&. If specified and the partition is newly created it is formatted with the specified file system (or as swap device)\&. The file system UUID and label are automatically derived from the partition UUID and label\&. If this option is used, the size allocation algorithm is slightly altered: the partition is created as least as big as required for the minimal file system of the specified type (or 4KiB if the minimal size is not known)\&. +"swap"\&. If specified and the partition is newly created it is formatted with the specified file system (or as swap device)\&. The file system UUID and label are automatically derived from the partition UUID and label\&. If this option is used, the size allocation algorithm is slightly altered: the partition is created at least as big as required for the minimal file system of the specified type (or 4KiB if the minimal size is not known)\&. .sp This option has no effect if the partition already exists\&. .sp diff --git a/upstream/mageia-cauldron/man5/rsyncd.conf.5 b/upstream/mageia-cauldron/man5/rsyncd.conf.5 index 249edd46..ce91b49a 100644 --- a/upstream/mageia-cauldron/man5/rsyncd.conf.5 +++ b/upstream/mageia-cauldron/man5/rsyncd.conf.5 @@ -1,4 +1,4 @@ -.TH "rsyncd.conf" "5" "20 Oct 2022" "rsyncd.conf from rsync 3.2.7" "User Commands" +.TH "rsyncd.conf" "5" "6 Apr 2024" "rsyncd.conf from rsync 3.3.0" "User Commands" .\" prefix=/usr .P .SH "NAME" @@ -10,7 +10,9 @@ rsyncd.conf \- configuration file for rsync in daemon mode rsyncd.conf .P The online version of this manpage (that includes cross-linking of topics) -is available at https://download.samba.org/pub/rsync/rsyncd.conf.5. +is available at +.UR https://download.samba.org/pub/rsync/rsyncd.conf.5 +.UE . .P .SH "DESCRIPTION" .P @@ -85,25 +87,7 @@ reread the \fBrsyncd.conf\fP file. The file is re-read on each client connection .SH "GLOBAL PARAMETERS" .P The first parameters in the file (before a [module] header) are the global -parameters. Rsync also allows for the use of a "[global]" module name to -indicate the start of one or more global-parameter sections (the name must be -lower case). -.P -You may also include any module parameters in the global part of the config -file in which case the supplied value will override the default for that -parameter. -.P -You may use references to environment variables in the values of parameters. -String parameters will have %VAR% references expanded as late as possible (when -the string is first used in the program), allowing for the use of variables -that rsync sets at connection time, such as RSYNC_USER_NAME. Non-string -parameters (such as true/false settings) are expanded when read from the config -file. If a variable does not exist in the environment, or if a sequence of -characters is not a valid reference (such as an un-paired percent sign), the -raw characters are passed through unchanged. This helps with backward -compatibility and safety (e.g. expanding a non-existent %VAR% to an empty -string in a path could result in a very unsafe path). The safest way to insert -a literal % into a value is to use %%. +parameters: .P .IP "\fBmotd\ file\fP" This parameter allows you to specify a "message of the day" (MOTD) to display @@ -136,6 +120,22 @@ can also be specified via the \fB\-\-sockopts\fP command-line option. You can override the default backlog value when the daemon listens for connections. It defaults to 5. .P +You may also include any MODULE PARAMETERS in the global part of the +config file, in which case the supplied value will override the default for +that parameter. +.P +You may use references to environment variables in the values of parameters. +String parameters will have %VAR% references expanded as late as possible (when +the string is first used in the program), allowing for the use of variables +that rsync sets at connection time, such as RSYNC_USER_NAME. Non-string +parameters (such as true/false settings) are expanded when read from the config +file. If a variable does not exist in the environment, or if a sequence of +characters is not a valid reference (such as an un-paired percent sign), the +raw characters are passed through unchanged. This helps with backward +compatibility and safety (e.g. expanding a non-existent %VAR% to an empty +string in a path could result in a very unsafe path). The safest way to insert +a literal % into a value is to use %%. +.P .SH "MODULE PARAMETERS" .P After the global parameters you should define a number of modules, each module @@ -144,11 +144,17 @@ a module name in square brackets [module] followed by the parameters for that module. The module name cannot contain a slash or a closing square bracket. If the name contains whitespace, each internal sequence of whitespace will be changed into a single space, while leading or trailing whitespace will be -discarded. Also, the name cannot be "global" as that exact name indicates that -global parameters follow (see above). +discarded. +.P +There is also a special module name of "[global]" that does not define a module +but instead switches back to the global settings context where default +parameters can be specified. Because each defined module gets its full set of +parameters as a combination of the default values that are set at that position +in the config file plus its own parameter list, the use of a "[global]" section +can help to maintain shared config values for multiple modules. .P -As with GLOBAL PARAMETERS, you may use references to environment variables in -the values of parameters. See the GLOBAL PARAMETERS section for more details. +As with GLOBAL PARAMETERS, you may use references to environment variables +in the values of parameters. See that section for details. .P .IP "\fBcomment\fP" This parameter specifies a description string that is displayed next to the @@ -1021,7 +1027,7 @@ before it begins. Any output from the \fBpre-xfer\ exec\fP command on stdout \fInot\fP displayed if the script returns success. The other programs cannot send any text to the user. All output except for the \fBpre-xfer\ exec\fP stdout goes to the corresponding daemon's stdout/stderr, which is typically -discarded. See the \fB\-\-no-detatch\fP option for a way to see the daemon's +discarded. See the \fB\-\-no-detach\fP option for a way to see the daemon's output, which can assist with debugging. .IP Note that the \fBearly\ exec\fP command runs before any part of the transfer @@ -1284,19 +1290,25 @@ susan:herpass .SH "BUGS" .P Please report bugs! The rsync bug tracking system is online at -https://rsync.samba.org/. +.UR https://rsync.samba.org/ +.UE . .P .SH "VERSION" .P -This manpage is current for version 3.2.7 of rsync. +This manpage is current for version 3.3.0 of rsync. .P .SH "CREDITS" .P Rsync is distributed under the GNU General Public License. See the file COPYING for details. .P -An rsync web site is available at https://rsync.samba.org/ and its github -project is https://github.com/WayneD/rsync. +An rsync web site is available at +.UR https://rsync.samba.org/ +.UE +and its github +project is +.UR https://github.com/WayneD/rsync +.UE . .P .SH "THANKS" .P @@ -1310,4 +1322,5 @@ people have later contributed to it. It is currently maintained by Wayne Davison. .P Mailing lists for support and development are available at -https://lists.samba.org/. +.UR https://lists.samba.org/ +.UE . diff --git a/upstream/mageia-cauldron/man5/sane-airscan.5 b/upstream/mageia-cauldron/man5/sane-airscan.5 new file mode 100644 index 00000000..d60ae0a9 --- /dev/null +++ b/upstream/mageia-cauldron/man5/sane-airscan.5 @@ -0,0 +1,154 @@ +.\" generated with Ronn-NG/v0.9.1 +.\" http://github.com/apjanke/ronn-ng/tree/0.9.1 +.TH "SANE\-AIRSCAN" "5" "May 2022" "" "AirScan (eSCL) and WSD SANE backend" +.SH "NAME" +\fBsane\-airscan\fR \- SANE backend for AirScan (eSCL) and WSD scanners and MFP +.SH "DESCRIPTION" +The \fBsane\-airscan\fR is the universal backend for "driverless" document scanning\. Currently it supports two protocols: +.IP "" 4 +.nf +1\. eSCL, also known as AirScan or AirPrint scan +2\. WSD, also known as WS\-Scan +.fi +.IP "" 0 +.SH "CONFIGURATION" +The sane\-airscan loads its configuration files from the following places: +.IP "" 4 +.nf +1\. /etc/sane\.d/airscan\.conf +2\. /etc/sane\.d/airscan\.d/* +.fi +.IP "" 0 +.P +The configuration file syntax is very similar to the \.INI file syntax\. It consist of sections, each section contains some variables\. Comments are started from # or ; characters and continies until end of line +.IP "" 4 +.nf +# This is a comment +[section 1] +variable 1 = value 1 ; and another comment +variable 2 = value 2 +.fi +.IP "" 0 +.P +Leading and trailing spaces of variable name and value are striped\. If you want to preserve them, put name or value into quotes ("like this")\. +.SH "CONFIGURATION OF DEVICES" +If scanner and computer are connected to the same LAN segment, everything expected to "just work" out of box, without any need of manual configuration\. +.P +However, in some cases manual configuration can be useful\. For example: +.IP "" 4 +.nf +1\. If computer and scanner are connected via IP router +2\. There are a lot of devices on a corporate network, but + only few of them are interesting +3\. Automatic discovery works unreliable +.fi +.IP "" 0 +.P +To manually configure a device, add the following section to the configuration file: +.IP "" 4 +.nf +[devices] +"Kyocera eSCL" = http://192\.168\.1\.102:9095/eSCL, eSCL +"Kyocera WSD" = http://192\.168\.1\.102:5358/WSDScanner, WSD +"Device I do not want to see" = disable +.fi +.IP "" 0 +.P +The \fB[devices]\fR section contains all manually configured devices, one line per device, and each line contains a device name on a left side of equation and device URL on a rights side, followed by protocol (eSCL or WSD)\. If protocol is omitted, eSCL is assumed\. You may also disable particular device by using the \fBdisable\fR keyword instead of URL\. +.P +In addition, you can manually configure a device by directly passing its URL in a device name without adding it to the configuration file\. This takes the format \fBprotocol:Device Name:URL\fR\. The examples above could be written as \fBescl:Kyocera eSCL:http://192\.168\.1\.102:9095/eSCL\fR and \fBwsd:Kyocera WSD:http://192\.168\.1\.102:5358/WSDScanner\fR\. +.P +To figure out URLs of available devices, the simplest way is to run the supplied \fBairscan\-discover(1)\fR tool on a computer connected with scanner to the same LAN segment\. On success, this program will dump to its standard output a list of discovered devices in a format suitable for inclusion into the configuration file\. +.P +If running \fBairscan\-discover(1)\fR on the same LAN segment as a scanner is not possible, you will have to follow a hard way\. Your administrator must know device IP address, consult your device manual for the eSCL port, and the URL path component most likely is the "/eSCL", though on some devices it may differ\. Discovering WSD URLs doing this way is much harder, because it is very difficult to guess TCP port and URL path, that in a case of eSCL\. +.P +For eSCL devices, the URL can also use the unix:// scheme, such as unix://scanner\.sock/eSCL\. The "host" from the URL is a file name that will be searched for in the directory specified by socket_dir (see below)\. When connecting to the scanner, all traffic will be sent to the specified UNIX socket instead of a TCP connection\. +.SH "CONFIGURATION OPTIONS" +Miscellaneous options all goes to the \fB[options]\fR section\. Currently the following options are supported: +.IP "" 4 +.nf +[options] +; If there are a lot of scanners around and you are only +; interested in few of them, disable auto discovery and +; configure scanners manually\. +discovery = enable | disable + +; Choose what SANE apps will show in a list of devices: +; scanner network name (the default) or hardware model name\. +model = network | hardware + +; If device supports both eSCL and WSD protocol, sane\-airscan +; may either choose the "best" protocol automatically, or +; expose all variants for user, allowing manual protocol selection\. +; The default is "auto"\. +protocol = auto | manual + +; Discovery of WSD devices may be "fast" or "full"\. The "fast" +; mode works as fast as DNS\-SD discovery, but in some cases +; may be unreliable\. The "full" mode is slow and reliable\. +; It is also possible to disable automatic discovery +; of WSD devices\. The default is "fast"\. +ws\-discovery = fast | full | off + +; Scanners that use the unix:// schema in their URL can only specify a +; socket name (not a full path)\. The name will be searched for in the +; directory specified here\. The default is /var/run\. +socket_dir = /path/to/directory +.fi +.IP "" 0 +.SH "BLACKLISTING DEVICES" +This feature can be useful, if you are on a very big network and have a lot of devices around you, while interesting only in a few of them\. +.IP "" 4 +.nf +[blacklist] +model = "Xerox*" ; blacklist by model name +name = "HP*" ; blacklist by network name +ip = 192\.168\.0\.1 ; blacklist by address +ip = 192\.168\.0\.0/24 ; blacklist the whole subnet +.fi +.IP "" 0 +.P +Network names come from DNS\-SD, WS\-Discovery doesn\'t provide this information\. For filtering by network name to work, Avahi must be enabled and device must be discoverable via DNS\-SD (not necessarily as a scanner, it\'s enough if WSD scanner is discoverable as a printer via DNS\-SD)\. +.P +Blacklisting only affects automatic discovery, and doesn\'t affect manually configured devices\. +.SH "DEBUGGING" +sane\-airscan provides very good instrumentation for troubleshooting without physical access to the problemmatic device\. +.P +Debugging facilities can be controlled using the \fB[debug]\fR section of the configuration file: +.IP "" 4 +.nf +[debug] +; Enable or disable console logging +enable = false | true + +; Enable protocol trace and configure output directory +; for trace files\. Like in shell, to specify path relative to +; the home directory, start it with tilda character, followed +; by slash, i\.e\., "~/airscan/trace"\. The directory will +; be created automatically\. +trace = path + +; Hex dump all traffic to the trace file (very verbose!) +hexdump = false | true +.fi +.IP "" 0 +.SH "FILES" +.TP +\fB/etc/sane\.d/airscan\.conf\fR, \fB/etc/sane\.d/airscan\.d/*\fR +The backend configuration files +.TP +\fB/usr/LIBDIR/sane/libsane\-airscan\.so\fR +The shared library implementing this backend +.SH "ENVIRONMENT" +.TP +\fBSANE_DEBUG_AIRSCAN\fR +This variable if set to \fBtrue\fR or non\-zero numerical value, enables debug messages, that are printed to stdout +.TP +\fBSANE_CONFIG_DIR\fR +This variable alters the search path for configuration files\. This is a colon\-separated list of directories\. These directories are searched for the airscan\.conf configuration file and for the airscan\.d subdirectory, before the standard path (/etc/sane\.d) is searched\. +.SH "BUGS AND SUPPORT" +If you have found a bug, please file a GitHub issue on a GitHub project page: \fBhttps://github\.com/alexpevzner/sane\-airscan\fR +.SH "SEE ALSO" +\fBsane(7), scanimage(1), xsane(1), airscan\-discover(1)\fR +.SH "AUTHOR" +Alexander Pevzner <pzz@apevzner\.com> diff --git a/upstream/mageia-cauldron/man5/sane-apple.5 b/upstream/mageia-cauldron/man5/sane-apple.5 index a78579df..123bbee9 100644 --- a/upstream/mageia-cauldron/man5/sane-apple.5 +++ b/upstream/mageia-cauldron/man5/sane-apple.5 @@ -84,7 +84,7 @@ support dynamic loading). .SH ENVIRONMENT .TP .B SANE_CONFIG_DIR -This environment variable is list of directories where SANE looks +This environment variable is a list of directories where SANE looks for the configuration file. On *NIX systems, directory names are separated by a colon (`:'), under OS/2 by a semi-colon (`;'). If SANE_CONFIG_DIR is not set, SANE defaults to @@ -177,7 +177,6 @@ bugs. We know we have a GUI bug when a parameter is not showing up when it should (active) or vice versa. Finding out which parameters are active across various Apple modes and models from the documentation -.I ftp://ftpdev.info.apple.com/devworld/Technical_Documentation/Peripherals_Documentation/ is an interesting exercise. I may have missed some dependencies. For example of the threshold parameter the Apple Scanners Programming Guide says nothing. I had to assume it is valid only in LineArt mode. @@ -238,7 +237,8 @@ looks like, goto to .I apple.h and #define the .B NEUTRALIZE_BACKEND -macro. You can select the scanner model through the APPLE_MODEL_SELECT +macro. You can select the scanner model through the +.B APPLE_MODEL_SELECT macro. Available options are .BR APPLESCANNER , .BR ONESCANNER , @@ -246,7 +246,9 @@ and .BR COLORONESCANNER . .PP If you encounter a SCSI bus error or trimmed and/or displaced images please -set the environment variable SANE_DEBUG_SANEI_SCSI to 255 before sending me +set the environment variable +.B SANE_DEBUG_SANEI_SCSI +to 255 before sending me the report. .SH TODO @@ -257,12 +259,12 @@ Make a non blocking backend. Properly support .BR sane_set_io_mode () and -.BR sane_get_select_fd () +.BR sane_get_select_fd (). .TP .B Scan Make scanning possible for all models in all supported modes. .PP -Add other missing functionality +Add other missing functionality. .SH "SEE ALSO" .BR sane (7), @@ -274,4 +276,4 @@ The backend was written not entirely from scratch by Milon Firikis. It is mostly based on the .BR sane\-mustek (5) -backend from David Mosberger and Andreas Czechanowski +backend from David Mosberger and Andreas Czechanowski. diff --git a/upstream/mageia-cauldron/man5/sane-artec_eplus48u.5 b/upstream/mageia-cauldron/man5/sane-artec_eplus48u.5 index 7df45067..be6c290e 100644 --- a/upstream/mageia-cauldron/man5/sane-artec_eplus48u.5 +++ b/upstream/mageia-cauldron/man5/sane-artec_eplus48u.5 @@ -50,7 +50,9 @@ find the firmware file under .SH CONFIGURATION The contents of the .I artec_eplus48u.conf -file is a list of usb lines containing vendor and product ids that correspond +file is a list of +.I usb +lines containing vendor and product ids that correspond to USB scanners. The file can also contain option lines. Empty lines and lines starting with a hash mark (#) are ignored. The scanners are autodetected by @@ -59,7 +61,9 @@ statements which are already included into .I artec_eplus48u.conf . "vendor_id" and "product_id" are hexadecimal numbers that identify the scanner. .PP -Every usb section can have additional options. +Every +.I usb +section can have additional options. .TP .B artecFirmwareFile /usr/share/sane/artec_eplus48u/Artec48.usb The path to the firmware file. This option is required. diff --git a/upstream/mageia-cauldron/man5/sane-bh.5 b/upstream/mageia-cauldron/man5/sane-bh.5 index 129c6a40..81d23a3d 100644 --- a/upstream/mageia-cauldron/man5/sane-bh.5 +++ b/upstream/mageia-cauldron/man5/sane-bh.5 @@ -89,7 +89,7 @@ compression is disabled and the image is delivered in a frame. .TP .B \-\-mode lineart|halftone [lineart] -Selects the scan mode (e.g., lineart,monochrome, or color). +Selects the scan mode (e.g., lineart, monochrome, or color). .TP .B \-\-resolution 200|240|300dpi [200] Sets the resolution of the scanned image. Each scanner model supports @@ -148,7 +148,8 @@ Bottom-right y position of scan area. .B \-\-source Automatic Document Feeder|Manual Feed Tray [Automatic Document Feeder] Selects the scan source (such as a document feeder). This option is provided to allow multiple image scans with -.BR xsane (1); it has no other purpose. +.BR xsane (1); +it has no other purpose. .TP .B \-\-batch[=(yes|no)] [no] Enable/disable batch mode scanning. Batch mode allows scanning at maximum throughput @@ -171,7 +172,7 @@ Sets the timeout in seconds for semi-automatic feeder. The value 0 specifies the hardware default value which varies based on the scanner model. .TP .B \-\-check\-adf[=(yes|no)] [no] -Check ADF Status prior to starting scan using the OBJECT POSITION command. +Check ADF status prior to starting scan using the OBJECT POSITION command. Note that this feature requires RSC firmware level 1.5 or higher and dip switch 4 must be in the on position. NOTE: This option has not been tested extensively and may produce undesirable results. @@ -381,7 +382,7 @@ with a hash mark (#) are ignored. .SH OPTIONS The following options can be specified in the .I bh.conf -file. +file: .TP .B disable\-optional\-frames This option prevents the backend from sending any optional frames. This @@ -544,7 +545,9 @@ prior to initiating the last scan command. Currently, there is no mechanism available for the frontend to pass this knowledge to the backend. If batch mode is enabled and the .B \-\-end\-count -terminates a scanadf session, +terminates a +.BR scanadf (1) +session, an extra page will be pulled through the scanner, but is neither read nor delivered to the frontend. The issue can be avoided by specifying .B \-\-batch=no @@ -556,7 +559,7 @@ with revision 1.2 or higher that is faster and more reliable than the standard Bar/Patch code decoder. This is not currently supported. .SH BUGS -This is a new backend; detailed bug reports are welcome -- and expected ;) +Detailed bug reports are welcome -- and expected ;) .PP If you have found something that you think is a bug, please attempt to recreate it with the diff --git a/upstream/mageia-cauldron/man5/sane-canon_pp.5 b/upstream/mageia-cauldron/man5/sane-canon_pp.5 index 799695ba..ffc46aa4 100644 --- a/upstream/mageia-cauldron/man5/sane-canon_pp.5 +++ b/upstream/mageia-cauldron/man5/sane-canon_pp.5 @@ -68,30 +68,28 @@ The supported options are currently and .BR force_nibble -Option -.B ieee1284 -.IR port-name -defines which port to use. The format of port-name is OS dependent, based on -the names presented by libieee1284. Please only have one of these lines, or +.TP +.B ieee1284 port-name +Defines which port to use. The format of port-name is OS dependent, based on +the names presented by +.BR libieee1284 (3). +Please only have one of these lines, or all but one will be ignored. -Option -.B calibrate -.IR cal-file -.IR [port-name] -defines which calibration file to use on a per-port basis. If you only have +.TP +.B calibrate cal-file [port-name] +Defines which calibration file to use on a per-port basis. If you only have one parport, the port-name argument may be omitted \- but be careful as this will cause problems on multi-scanner systems. You may have as many of these lines as you like, as long as each has a unique port name. The tilde (`~') -character is acceptable and will be expanded to the value of the HOME -environment. +character is acceptable and will be expanded to the value of the +.B HOME +environment variable. -Option -.B init_mode -.IR <AUTO|FB620P|FB630P> -.IR [portname] -defines which initialisation (wake-up) mode to use on a per-port basis. -If you only have one parport, the portname argument may be omitted \- but +.TP +.B init_mode <AUTO|FB620P|FB630P> [port-name] +Defines which initialisation (wake-up) mode to use on a per-port basis. +If you only have one parport, the port-name argument may be omitted \- but be careful as this may cause problems on multi-scanner systems. You may have as many of these lines as you like, as long as each has a unique port name. The valid initialisation modes are FB620P (which strobes 10101010 @@ -100,10 +98,11 @@ on the data pins) and AUTO, which will try FB630P mode first then FB620P mode second. The FB620P mode is also used by the FB320P. The FB630P mode is used by the FB330P, N340P, and N640P. -Option +.TP .B force_nibble -forces the driver to use nibble mode even if ECP mode is reported to work by -libieee1284. This works-around the rare issue of ECP mode being reported to +Forces the driver to use nibble mode even if ECP mode is reported to work by +.BR libieee1284 (3). +This works-around the rare issue of ECP mode being reported to work by the library, then not working. .SH TIPS @@ -174,7 +173,9 @@ one returned during calibration) will be loaded. .PP .B Communication Problems .PP -ECP mode in libieee1284 doesn't always work properly, even with new hardware. +ECP mode in +.BR libieee1284 (3) +doesn't always work properly, even with new hardware. We believe that this is a ppdev problem. If you change the configuration file to include .B force_nibble diff --git a/upstream/mageia-cauldron/man5/sane-coolscan2.5 b/upstream/mageia-cauldron/man5/sane-coolscan2.5 index bec35913..6cbe0e1c 100644 --- a/upstream/mageia-cauldron/man5/sane-coolscan2.5 +++ b/upstream/mageia-cauldron/man5/sane-coolscan2.5 @@ -123,9 +123,9 @@ Eject the film strip or mounted slide when using the slide loader. .TP .B \-\-reset Reset scanner. The scanner will perform the same action as when power is -turned on: it will eject the film strip (with the SF\-200 bulk feeder) +turned on: it will eject the slide (with the SF\-200 bulk feeder) and calibrate itself. Use this whenever the scanner refuses to load -a film strip properly, as a result of +a slide properly, as a result of which .B \-\-eject does not work. diff --git a/upstream/mageia-cauldron/man5/sane-coolscan3.5 b/upstream/mageia-cauldron/man5/sane-coolscan3.5 index 24b0dc5b..0b329dcc 100644 --- a/upstream/mageia-cauldron/man5/sane-coolscan3.5 +++ b/upstream/mageia-cauldron/man5/sane-coolscan3.5 @@ -82,7 +82,9 @@ unit is mm). If set to "yes", the scanner will read the infrared channel, thus allowing defect removal in software. The infrared image is read during a second scan, with no options altered. The backend must not be restarted between the scans. -If you use scanimage, perform a batch scan with +If you use +.BR scanimage (1), +perform a batch scan with .B \-\-batch\-count=2 to obtain the IR information. .TP @@ -120,9 +122,9 @@ Eject the film strip or mounted slide when using the slide loader. .TP .B \-\-reset Reset scanner. The scanner will perform the same action as when power is -turned on: it will eject the film strip (with the SF\-200 bulk loader) +turned on: it will eject the slide (with the SF\-200 bulk loader) and calibrate itself. Use this -whenever the scanner refuses to load a film strip properly, as a result of +whenever the scanner refuses to load a slide properly, as a result of which .B \-\-eject does not work. diff --git a/upstream/mageia-cauldron/man5/sane-dmc.5 b/upstream/mageia-cauldron/man5/sane-dmc.5 index 92ed2f1a..1c3e198a 100644 --- a/upstream/mageia-cauldron/man5/sane-dmc.5 +++ b/upstream/mageia-cauldron/man5/sane-dmc.5 @@ -49,7 +49,9 @@ This image is a 1599-by-1200 pixel full-color image constructed by filtering and interpolating the "raw" image. The filtering and interpolation is done in software, so this mode is very slow. Also, this mode places restrictions on how the image is read which means that the "preview" mode -of xscanimage does not work in Super Resolution mode. +of +.BR xscanimage (1) +does not work in Super Resolution mode. .RB ( xcam (1) and the non-preview modes of .BR scanimage (1) @@ -146,8 +148,8 @@ like. .BR sane\-scsi (5) .SH AUTHOR -David F. Skoll +Dianne Skoll <dianne@skoll.ca> .PP The backend is derived from .BR sane\-hp (5) -by David Mosberger +by David Mosberger. diff --git a/upstream/mageia-cauldron/man5/sane-epjitsu.5 b/upstream/mageia-cauldron/man5/sane-epjitsu.5 index 7eb345bd..7b462166 100644 --- a/upstream/mageia-cauldron/man5/sane-epjitsu.5 +++ b/upstream/mageia-cauldron/man5/sane-epjitsu.5 @@ -2,7 +2,7 @@ .IX sane\-epjitsu .SH NAME -sane\-epjitsu \- SANE backend for Epson-based Fujitsu USB scanners. +sane\-epjitsu \- SANE backend for Epson-based Fujitsu USB scanners .SH DESCRIPTION The @@ -35,12 +35,12 @@ Selects the source for the scan. Options may include "Flatbed", "ADF Front", "AD Selects the mode for the scan. Options may include "Lineart", "Gray", "Color". .RE .PP -.B resolution, y\-resolution +.BR resolution , " y\-resolution" .RS Controls scan resolution. Setting .B \-\-resolution also sets -.B \-\-y\-resolution, +.BR \-\-y\-resolution , though this behavior is overridden by some frontends. .RE .PP diff --git a/upstream/mageia-cauldron/man5/sane-epson.5 b/upstream/mageia-cauldron/man5/sane-epson.5 index 44ecf875..61fa35c5 100644 --- a/upstream/mageia-cauldron/man5/sane-epson.5 +++ b/upstream/mageia-cauldron/man5/sane-epson.5 @@ -5,12 +5,12 @@ sane\-epson \- SANE backend for EPSON scanners .SH DESCRIPTION The .B sane\-epson -library implements a SANE Scanner Access Now Easy) backend that +library implements a SANE (Scanner Access Now Easy) backend that provides access to Epson flatbed scanners. Some functions of this backend should be considered .B beta-quality software! Most functions have been stable for a long time, but of -course new development can not and often times will not function properly from +course new development can not and often will not function properly from the very first day. Please report any strange behavior to the maintainer of the backend. .PP @@ -255,8 +255,9 @@ The parallel interface can be configured in two ways: An integer value starting at the beginning of a line will be interpreted as the IO address of the parallel port. To make it clearer that a configured IO address is a parallel port the port address can be preceded by the string "PIO". The PIO connection does not -use a special device file in the /dev directory. The IO address can be specified -in hex mode (prefixed with "0x"). +use a special device file in the +.I /dev +directory. The IO address can be specified in hex mode (prefixed with "0x"). .TP .I USB A device file that is preceded by the string "USB" is treated as a scanner diff --git a/upstream/mageia-cauldron/man5/sane-epson2.5 b/upstream/mageia-cauldron/man5/sane-epson2.5 index 854ec02f..883652f4 100644 --- a/upstream/mageia-cauldron/man5/sane-epson2.5 +++ b/upstream/mageia-cauldron/man5/sane-epson2.5 @@ -266,7 +266,7 @@ will ignore this option. The .B \-\-bay -option selects which bay to scan +option selects which bay to scan. The .B \-\-eject diff --git a/upstream/mageia-cauldron/man5/sane-fujitsu.5 b/upstream/mageia-cauldron/man5/sane-fujitsu.5 index 34864cb6..3885cde2 100644 --- a/upstream/mageia-cauldron/man5/sane-fujitsu.5 +++ b/upstream/mageia-cauldron/man5/sane-fujitsu.5 @@ -1,16 +1,16 @@ -.TH sane\-fujitsu 5 "15 Nov 2022" "" "SANE Scanner Access Now Easy" +.TH sane\-fujitsu 5 "24 Mar 2023" "" "SANE Scanner Access Now Easy" .IX sane\-fujitsu .SH NAME -sane\-fujitsu \- SANE backend for Fujitsu flatbed and ADF scanners +sane\-fujitsu \- SANE backend for Fujitsu and Ricoh fi series scanners .SH DESCRIPTION The .B sane\-fujitsu library implements a SANE (Scanner Access Now Easy) backend which provides -access to most Fujitsu flatbed and ADF scanners. +access to most Fujitsu flatbed and ADF scanners, and the subsequent Ricoh models. -This document describes backend version 139, which initially shipped with SANE 1.1.2. +This document describes backend version 140. .SH SUPPORTED HARDWARE This version supports every known model which speaks the Fujitsu SCSI and @@ -20,14 +20,14 @@ supported. Please see the list at .I http://www.sane\-project.org/sane\-supported\-devices.html for details. -This backend may support other Fujitsu scanners. The best +This backend may support other Fujitsu or newer Ricoh scanners. The best way to determine level of support is to test the scanner directly, or to collect a trace of the windows driver in action. Please contact the author for help or with test results. .SH UNSUPPORTED HARDWARE The following scanners are known NOT to work with this backend, -either because they have a non\-Fujitsu chipset, or an unsupported +either because they have an unsupported chipset, or an unsupported interface type. Some of these scanners may be supported by another backend. .PP @@ -152,7 +152,7 @@ specify one. Probably should not be used with the other "scsi" line above. .RS Requests backend to search all usb buses in the system for a device which uses that vendor and product id. The device will then be queried -to determine if it is a Fujitsu scanner. +to determine if it is a supported scanner. .RE .PP "usb /dev/usb/scanner0" (or other device file) diff --git a/upstream/mageia-cauldron/man5/sane-genesys.5 b/upstream/mageia-cauldron/man5/sane-genesys.5 index 72ef8de0..72a82d41 100644 --- a/upstream/mageia-cauldron/man5/sane-genesys.5 +++ b/upstream/mageia-cauldron/man5/sane-genesys.5 @@ -48,7 +48,8 @@ GL841, GL843, GL847 or GL124 chipset, you can try to add it to the backend. .SH "CALIBRATION" To give correct image quality, sheet fed scanners need to be calibrated using the calibration sheet sold with the scanner. To do calibration, you must insert this target -in the feeder then start calibration either by passing the \-\-calibrate option to scanimage +in the feeder then start calibration either by passing the \-\-calibrate option to +.BR scanimage (1) or by clicking on the available 'calibrate' button in the 'advanced options' in a graphical frontend. The result of the calibration is stored in a file in the home directory of the user doing it. If you plug the scanner in another machine or use it with another account, calibration @@ -100,7 +101,7 @@ Disable use of a software adaptive algorithm to generate lineart and rely on har .TP .B \-\-color-filter None|Red|Green|Blue When using gray or lineart this option selects the used color. Using a color filter -will give a monochrome scan. CIS based scanners can to true gray when no filter (None value) is +will give a monochrome scan. CIS based scanners can do true gray when no filter (None value) is selected. .TP @@ -123,7 +124,7 @@ users. .B \-\-expiration\-time Specify the time (in minutes) a cached calibration is considered valid. If older than the given value, a new calibration is done. A value of -1 means no expiration and cached value are kept forever unless cleared by -userwith the calibration clear option. A value of 0 means cache is disabled. +user with the calibration clear option. A value of 0 means cache is disabled. .PP Additionally, several 'software' options are exposed by the backend. These @@ -248,9 +249,7 @@ Syscan/Ambir DocketPORT 467/485/487/665/685 Xerox Travel Scanner 100, Onetouch 2400 .RE .TP -cncsolutions -.RI ( http://www.cncsolutions.com.br ) -sponsored and supported the work on the Panasonic KV-SS080. +cncsolutions sponsored and supported the work on the Panasonic KV-SS080. .br .TP Brian Paavo from Benthic Science Limited for donating a Canoscan LiDE 700F. @@ -298,7 +297,8 @@ due to the way image sensors are built. .PP This backend will be much slower if not using libusb\-1.0. So be sure that sane\-backends is built with the -.B \-\-enable-libusb_1_0 option. +.B \-\-enable-libusb_1_0 +option. .SH "BUGS" For the LiDE 200, the scanned data at 4800 dpi is obtained "as is" from sensor. diff --git a/upstream/mageia-cauldron/man5/sane-gphoto2.5 b/upstream/mageia-cauldron/man5/sane-gphoto2.5 index f3ffb819..2e1c129f 100644 --- a/upstream/mageia-cauldron/man5/sane-gphoto2.5 +++ b/upstream/mageia-cauldron/man5/sane-gphoto2.5 @@ -32,7 +32,7 @@ through the gphoto2 interface. Valid ports and cameras can be obtained by .I "gphoto2 \-\-list\-cameras" and -.I "gphoto2 \-\-list\-ports". +.IR "gphoto2 \-\-list\-ports" . .PP The .B dumpinquiry @@ -122,9 +122,9 @@ Set to 1, 2, or 3, to enable various levels of debugging within the gphoto2 libraries. .SH "SEE ALSO" -.BR sane (7) , -.BR scanimage (1) , -.BR xscanimage (1) , +.BR sane (7), +.BR scanimage (1), +.BR xscanimage (1), .BR libgphoto2 (3) .SH AUTHOR diff --git a/upstream/mageia-cauldron/man5/sane-hp.5 b/upstream/mageia-cauldron/man5/sane-hp.5 index e8f725d5..4ae4ac4f 100644 --- a/upstream/mageia-cauldron/man5/sane-hp.5 +++ b/upstream/mageia-cauldron/man5/sane-hp.5 @@ -45,19 +45,18 @@ and .IR http://penguin-breeder.org/kernel/download/ . .PP -Support for models 5200C/62X0C/63X0C connected to the USB require -the kernel scanner driver or libusb. See +Support for models 5200C/62X0C/63X0C connected to USB requires +libusb. See .BR sane\-usb (5) for more details. .PP The .B sane\-hp backend no longer supports OfficeJet multi-function peripherals. -For these devices use the external "hpoj" backend in version 0.90 and later of -the "HP OfficeJet Linux driver", available at -.br -.IR http://hpoj.sourceforge.net -. +For these devices use the external "hplip" packages available at: +.IR https://developers.hp.com/hp\-linux\-imaging\-and\-printing/ . +For information about the previous hpoj driver, see: +.IR http://hpoj.sourceforge.net/ . .PP Because Hewlett-Packard does no longer produce scanners that support SCL (beside the OfficeJets), the above list of supported scanners is @@ -70,7 +69,7 @@ You can also watch the sane\-devel mailing list at .IR http://www.sane\-project.org/mailing\-lists.html . .PP More details about the hp backend can be found on its homepage -.IR http://www.kirchgessner.net/sane.html . +.IR http://web.archive.org/web/20070206115546/http://www.kirchgessner.net/sane.html . .PP .SH "DEVICE NAMES" This backend expects device names of the form: @@ -220,8 +219,9 @@ levels reduce verbosity. .TP .B SANE_HOME_HP Only used for OS/2 and along with use of HP PhotoSmart PhotoScanner. -Must be set to the directory where the directory .sane is located. -Is used to save and read the calibration file. +Must be set to the directory where the directory +.I .sane +is located. Is used to save and read the calibration file. .TP .B SANE_HP_KEEPOPEN_SCSI .TP diff --git a/upstream/mageia-cauldron/man5/sane-lexmark_x2600.5 b/upstream/mageia-cauldron/man5/sane-lexmark_x2600.5 new file mode 100644 index 00000000..bf9cb76f --- /dev/null +++ b/upstream/mageia-cauldron/man5/sane-lexmark_x2600.5 @@ -0,0 +1,62 @@ +.TH "sane\-lexmark_x2600" "5" "23 Dec 2023" "" "SANE Scanner Access Now Easy" +.IX sane\-lexmark_x2600 +.SH "NAME" +sane\-lexmark_x2600 \- SANE backend for Lexmark X2600 Series scanners +.SH "DESCRIPTION" +The +.B sane\-lexmark +library implements a SANE (Scanner Access Now Easy) backend that +provides access to the scanner part of Lexmark X2600 AIOs. +.PP +The scanners that should work with this backend are: +.PP +.RS +.ft CR +.nf + Vendor Model status +\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\- + Lexmark X2670 good +.fi +.ft R +.RE + +The options the backend supports can either be selected through +command line options to programs like +.BR scanimage (1) +or through GUI elements in +.BR xscanimage (1) +, +.BR xsane (1). +or +.BR simple-scan (1). +.br +If you notice any strange behavior, please report to the backend +maintainer or to the SANE mailing list. + +.SH "FILES" +.TP +.I /usr/lib64/sane/libsane\-lexmark_x2600.a +The static library implementing this backend. +.TP +.I /usr/lib64/sane/libsane\-lexmark_x2600.so +The shared library implementing this backend (present on systems that +support dynamic loading). + +.SH "ENVIRONMENT" +.TP +.B SANE_DEBUG_LEXMARK_X2600 +If the library was compiled with debug support enabled, this +environment variable controls the debug level for this backend. E.g., +a value of 255 requests all debug output to be printed. Smaller levels +reduce verbosity. + +.SH "AUTHOR" +.TP +The backend was originally written by Benoit Juin. +.RI < benoit.juin@gmail.com > + +.SH "CREDITS" +.TP +Many thanks go to: +@skelband aka Ralph Little who help me to dive in the sane-backencode and +reviewed the sources. diff --git a/upstream/mageia-cauldron/man5/sane-matsushita.5 b/upstream/mageia-cauldron/man5/sane-matsushita.5 index 29855e9a..e0321c08 100644 --- a/upstream/mageia-cauldron/man5/sane-matsushita.5 +++ b/upstream/mageia-cauldron/man5/sane-matsushita.5 @@ -27,14 +27,14 @@ backend: .ft R .RE .PP -(*) WARNING: None of the advanced options of these scanners are available (ie no color, no high resolution, no automatic cropping). Basically, the driver does no more than what it does for the KV-SS25. I don't have access to such scanners, and thus cannot add these options. +(*) WARNING: None of the advanced options of these scanners are available (i.e. no color, no high resolution, no automatic cropping). Basically, the driver does no more than what it does for the KV-SS25. I don't have access to such scanners, and thus cannot add these options. Other Panasonic high speed scanners may or may not work with that backend. -Valid command line options and their syntax can be listed by using +Valid command line options and their syntax can be listed by using: .RS .PP -scanimage \-\-help \-d matsushita +.I scanimage \-\-help \-d matsushita .RE .TP @@ -58,13 +58,13 @@ selects the number of pages to scan (one or until the tray is empty). .TP .B \-\-paper\-size A4|...|Legal|Letter [A4] -options selects the area to scan. It adjust the +selects the area to scan. It adjusts the .B \-l \-t \-x \-y options accordingly. It does not need to be the real size of the paper. .TP .B \-l \-t \-x \-y -control the scan area: \-l sets the top left x coordinate, \-t the top +controls the scan area: \-l sets the top left x coordinate, \-t the top left y coordinate, \-x selects the width and \-y the height of the scan area. All parameters are specified in millimeters. It is possible to use the option @@ -85,28 +85,28 @@ controls the contrast of the acquired image. Some models do not support that opt automatically sets brightness, contrast, white level, gamma, noise reduction and image emphasis. These options are not available when automatic\-threshold is in use. .TP .B \-\-halftone\-pattern -option sets the tonal gradation for the halftone mode. Pattern downloading is not implemented by the backend. +sets the tonal gradation for the halftone mode. Pattern downloading is not implemented by the backend. .TP .B \-\-autoseparation provides automatic separation of text and images. .TP .B \-\-white\-level -option indicate the source of the white base. +indicates the source of the white base. .TP .B \-\-noise\-reduction reduces the isolated dot noise. This option is not supported by all scanners. .TP .B \-\-image\-emphasis -option sets the image emphasis. Some selection are not available on all scanners. +sets the image emphasis. Some selection are not available on all scanners. .TP .B \-\-gamma -options set the gamma curve. It is only valid for Gray modes, and is not available on all scanners. Gamma downloading is not implemented by the backend. +sets the gamma curve. It is only valid for Gray modes, and is not available on all scanners. Gamma downloading is not implemented by the backend. .SH CONFIGURATION FILE The configuration file .I /etc/sane.d/matsushita.conf -supports the device name to use (eg +supports the device name to use (e.g. .IR /dev/scanner ) and the SCSI option to auto-detect the scanners supported. diff --git a/upstream/mageia-cauldron/man5/sane-microtek.5 b/upstream/mageia-cauldron/man5/sane-microtek.5 index 4f56f018..ad6ab8f3 100644 --- a/upstream/mageia-cauldron/man5/sane-microtek.5 +++ b/upstream/mageia-cauldron/man5/sane-microtek.5 @@ -104,7 +104,7 @@ ignored. A sample configuration file is shown below: The configuration file may also contain the special tokens .I norealcal or -.I noprecal. +.IR noprecal . .I norealcal will disable the use of magic, undocumented scanner calibration commands which are known to work on the E6, but may not work with other models. diff --git a/upstream/mageia-cauldron/man5/sane-microtek2.5 b/upstream/mageia-cauldron/man5/sane-microtek2.5 index d02bd615..3395cf68 100644 --- a/upstream/mageia-cauldron/man5/sane-microtek2.5 +++ b/upstream/mageia-cauldron/man5/sane-microtek2.5 @@ -7,9 +7,7 @@ The library implements a SANE (Scanner Access Now Easy) backend that provides access to Microtek scanners with a SCSI-2 command set. This backend can be considered alpha to beta. Some scanner models are reported -to work well, others not. New development versions of this backend can be -obtained from -.IR http://karstenfestag.gmxhome.de . +to work well, others not. .PP There exists a different backend for Microtek scanners with SCSI-1 command set. @@ -17,7 +15,7 @@ Refer to .BR sane\-microtek (5) for details. .PP -And there is work in progress for the ScanMaker 3600. +And there is partial progress for the ScanMaker 3600. See .IR http://sourceforge.net/projects/sm3600 . .PP @@ -155,7 +153,9 @@ The configuration file may also contain options. Global options that are valid for all devices are placed above the device names. Device-specific options are placed under the device name. Note that, except for option dump <n> and -option strip-height <n>, the entry in the microtek2.conf file only enables +option strip-height <n>, the entry in the +.I microtek2.conf +file only enables the corresponding option for being showed in the frontend. There, in the frontend, you can switch the options on and off. Currently the following options are supported: diff --git a/upstream/mageia-cauldron/man5/sane-mustek.5 b/upstream/mageia-cauldron/man5/sane-mustek.5 index c934b6e3..79953b49 100644 --- a/upstream/mageia-cauldron/man5/sane-mustek.5 +++ b/upstream/mageia-cauldron/man5/sane-mustek.5 @@ -181,7 +181,9 @@ is 128. Because of double buffering the buffer actually sent to the scanner is half the size of this value. Try to increase this value to achieve higher scan speeds. Note that some ScanExpress scanners don't like buffer sizes above 64 kb (buffersize = 128). If your sg driver can't set SCSI buffer sizes at -runtime you may have to change that value, too. See sane\-scsi(5) for details. +runtime you may have to change that value, too. See +.BR sane\-scsi (5) +for details. .PP Option .B blocksize @@ -312,7 +314,7 @@ I/O ports. Thus, either make frontends such as .BR scanimage (1) and .BR xscanimage (1) -setuid root (generally not recommended for safety reasons) or, alternatively, +setuid root (generally not recommended for security reasons) or, alternatively, access this backend through the network daemon .BR saned (8). .PP diff --git a/upstream/mageia-cauldron/man5/sane-mustek_pp.5 b/upstream/mageia-cauldron/man5/sane-mustek_pp.5 index 99b78fa9..df40b594 100644 --- a/upstream/mageia-cauldron/man5/sane-mustek_pp.5 +++ b/upstream/mageia-cauldron/man5/sane-mustek_pp.5 @@ -100,7 +100,7 @@ Note that the backend needs to run as root or has to have appropriate access rights to .I /dev/parport* if libieee1284 support is compiled in. To allow user -access to the scanner run the backend through the network interface (See +access to the scanner run the backend through the network interface (see .BR saned (8) and .BR sane\-net (5)). @@ -109,15 +109,12 @@ Note also that the backend support .IR "parport sharing" , i.e. if you try printing while scanning, your computer may crash. To enable -parport sharing, you have to enable libieee1284 at compile time. This backend -also conflicts with the -.BR sane\-musteka4s2 (5) -backend. You can only enable one of them in your +parport sharing, you have to enable +.BR libieee1284 (3) +at compile time. +You may also have to enable the backend explicitly in your .IR dll.conf . -However, you have -to enable the backend explicitly in your -.IR dll.conf , -just remove the hash mark in the line "mustek_pp". +Just remove the hash mark in the line "mustek_pp". .SH "DEVICE DEFINITION" This backend allows multiple devices being defined and configured via the diff --git a/upstream/mageia-cauldron/man5/sane-mustek_usb.5 b/upstream/mageia-cauldron/man5/sane-mustek_usb.5 index a2018b7e..47ef1f33 100644 --- a/upstream/mageia-cauldron/man5/sane-mustek_usb.5 +++ b/upstream/mageia-cauldron/man5/sane-mustek_usb.5 @@ -86,7 +86,7 @@ Instead of using the device name, the scanner can be autodetected by statements which are already included into .IR mustek_usb.conf . This is only supported with Linux 2.4.8 and higher and all systems that -support libsub. "vendor_id" and "product_id" are hexadecimal numbers that +support libusb. "vendor_id" and "product_id" are hexadecimal numbers that identify the scanner. If this doesn't work, a device name and the option specifying the scanner type must be placed in .I mustek_usb.conf diff --git a/upstream/mageia-cauldron/man5/sane-net.5 b/upstream/mageia-cauldron/man5/sane-net.5 index f3782449..fd7c5623 100644 --- a/upstream/mageia-cauldron/man5/sane-net.5 +++ b/upstream/mageia-cauldron/man5/sane-net.5 @@ -93,10 +93,8 @@ are contacted in addition to the hosts listed above. For this backend to function properly, it is also necessary to define the .B sane\-port service in -.IR /etc/services . -The -.B sane -service should be defined using a line of the following form: +.I /etc/services +using a line of the following form: .PP .RS sane\-port 6566/tcp # SANE network scanner daemon diff --git a/upstream/mageia-cauldron/man5/sane-p5.5 b/upstream/mageia-cauldron/man5/sane-p5.5 index bf2418ce..7907c510 100644 --- a/upstream/mageia-cauldron/man5/sane-p5.5 +++ b/upstream/mageia-cauldron/man5/sane-p5.5 @@ -28,7 +28,7 @@ This backend expects device names of the form: .RE .PP Where -\fBvalue\fR is : +\fBvalue\fR is: .RS .TP @@ -151,7 +151,9 @@ your .IR /etc/sane.d/dll.conf . If your scanner isn't detected, make sure you've defined the right port address, or the correct device -in your p5.conf. +in your +.I p5.conf +file. .TP .I the name of your scanner/vendor also a worthy information. Please also include the optical resolution and lamp type of your diff --git a/upstream/mageia-cauldron/man5/sane-pixma.5 b/upstream/mageia-cauldron/man5/sane-pixma.5 index 1271832e..e73dd704 100644 --- a/upstream/mageia-cauldron/man5/sane-pixma.5 +++ b/upstream/mageia-cauldron/man5/sane-pixma.5 @@ -19,9 +19,9 @@ Currently, the following models work with this backend: .RS PIXMA E410, E510, E4500 .br -PIXMA G600, G2000, G2010, G2100, G4000, G4511 +PIXMA G600, G2000, G2010, G2030, G2070, G2100, G3030, G3070, G4000, G4070, G4511 .br -PIXMA GX6000, GX7000 +PIXMA GX1000, GX2000, GX3000, GX4000, GX6000, GX6500, GX7000 .br PIXMA MG2100, MG2200, MG2400, MG2500, MG2900, MG3000, MG3100 .br @@ -55,13 +55,15 @@ PIXMA MX410, MX420, MX470, MX510, MX520, MX530, MX700, MX720 .br PIXMA MX850, MX860, MX870, MX882, MX885, MX890, MX920, MX7600 .br +PIXMA TC-20M, TC-5200M +.br PIXMA TR4500, TR4600, TR4700 .br PIXMA TS2400, TS2600, TS3100, TS3300, TS3450, TS3451, TS3452 .br PIXMA TS3500, TS5000, TS5100, TS5350i, TS5400, TS6100, TS6200 .br -PIXMA TS7530, TS7450i ,TS8000, TS8530, TS8200 +PIXMA TS7530, TS7450i ,TS8000, TS8200, TS8530, TS8630, TS8630 .br PIXUS MP10 .br @@ -123,25 +125,27 @@ PIXMA MX320, MX390, MX430, MX450, MX490, MX710 .br PIXMA G3000, G3010, G4010, G6000, G6080, G7000, GM4000, GM4080 .br -PIXMA TR7500, TR7530, TR7600, TR8500, TR8530, TR8580, TR8600 +PIXMA TR7500, TR7530, TR7600, TR7800, TR8500, TR8530, TR8580 TR8600 .br PIXMA TR8630, TR9530 .br PIXMA TS3400, TS5100, TS6000, TS6130, TS6180, TS6230, TS6280, TS6300 .br -PIXMA TS6330, TS6330, TS6380, TS6400, TS7330, TS7400, TS7430, TS8100 +PIXMA TS6330, TS6330, TS6380, TS6400, TS6630, TS6730, TS7330, TS7400, +.br +PIXMA TS7430, TS7600i, TS7700, TS7700A, TS7700i, TS8100, TS8130 .br -PIXMA TS8130, TS8180, TS8230, TS8280, TS8300, TS8330, TS8380, TS9000 +PIXMA TS8180, TS8230, TS8280, TS8300, TS8330, TS8380, TS8700, TS9000 .br PIXMA TS9100, TS9180, TS9500, TS9580 .br -PIXUS MP5, XK50, XK60, XK70, XK80, XK90, XK100, XK500 +PIXUS MP5, XK50, XK60, XK70, XK80, XK90, XK100, XK110, XK120, XK500 .br imageCLASS MF720, MF810/820, MF5630, MF5650, MF5750, MF8170c .br imageCLASS MPC190, D550 .br -i-SENSYS MF110, MF220, MF260, MF410, MF420, MF510, MF520, MF740 +i-SENSYS MF110, MF220, MF260, MF410, MF420, MF510, MF520, MF740, MF750 .br i-SENSYS MF5880dn, MF5900, MF6680dn, MF8500C .br @@ -167,7 +171,7 @@ The backend supports: .br * a custom gamma table, .br -* Automatic Document Feeder, Simplex and Duplex. +* Automatic Document Feeder, Simplex and Duplex, .br * Transparency Unit, 24 or 48 bits depth. Infrared channel on certain models. .RE @@ -183,7 +187,7 @@ where aaaa is the scanners model and bbbb is the hostname or ip-adress. Example: pixma:MF4800_192.168.1.45 is a MF4800 Series multi-function peripheral. .PP This backend, based on cloning original Canon drivers protocols, is in -a production stage. Designed has been carried out without any applicable +a production stage. Design has been carried out without any applicable manufacturer documentation, probably never available. However, we have tested it as well as we could, but it may not work in all situations. You will find an up-to-date status at the project homepage. (See below). @@ -235,8 +239,8 @@ backward compatibility reasons. .TP .I button\-1 button\-2 (read only) These options will return the value of the respective buttons. -value 0 means that the button was not pressed, 1 is returned when the button -was pressed. Some scanners with more than two buttons send the button number +Value 0 means that the button was not pressed, 1 is returned when the button +was pressed. Some scanners, with more than two buttons, send the button number as target. .TP .I original @@ -293,7 +297,7 @@ only scanners that cannot be auto-detected because they are on a different subnet shall be listed here. If you do not use Linux and your OS does not allow enumeration of interfaces (i.e. it does not support the .BR getifaddrs () -qfunction) you also may need +function) you also may need to add your scanner here as well. .PP Scanners shall be listed in the configuration file as follows: @@ -302,48 +306,56 @@ Scanners shall be listed in the configuration file as follows: .I <method>://<host>[:port][/timeout=<value>] .RE .PP -where method indicates the protocol used (bjnp is used for inkjet multi-functionals -and mfnp is used for laser multi-functionals). -.PP -host is the hostname or IP address of the scanner, e.g. bjnp://10.0.1.4 -for IPv4, bjnp://[2001:888:118e:18e2:21e:8fff:fe36:b64a] for a literal -IPv6-address or bjnp://myscanner.mydomain.org for a hostname. -.PP -The port number is optional and in normally implied by the method. +.TP +.B method +indicates the protocol used. +.I bjnp +is used for inkjet multi-functionals and +.I mfnp +is used for laser multi-functionals). +.TP +.B host +is the hostname or IP address of the scanner, e.g. +.I bjnp://10.0.1.4 +for IPv4, +.I bjnp://[2001:888:118e:18e2:21e:8fff:fe36:b64a] +for a literal IPv6-address or +.I bjnp://myscanner.mydomain.org +for a hostname. +.TP +.B port +is optional and is normally implied by the method. Port 8610 is the standard port for mfnp, 8612 for bjnp. +.TP +.B timeout +scanner-specific timeout value for the network protocol. The value is in ms. .PP -A scanner specific timeout value for the network protocol can be set using the -bjnp-timeout parameter. The value is in ms. -.PP -Define scanners each on a new line. +Define each scanner each on a separate line. .PP -More globally applicable timeouts can be set using the bjnp-timeout parameter as follows: +More globally-applicable timeouts can be set using the bjnp-timeout parameter as follows: .PP .RS .I bjnp-timeout=<value> .RE .PP A timeout defined using bjnp-timeout will apply to the following scanner definitions -in the file. If required the bjnp-timeout setting +in the file. If required, the bjnp-timeout setting can be defined multiple times, where each setting will apply only to the scanners that -follow the setting. The last setting is used for the auto discovered scanners. +follow the setting. The last setting is used for auto-discovered scanners. If not explicitly set, the default 1000ms setting will apply. .PP Setting timeouts should only be required in exceptional cases. .PP .RE .PP -If so desired networking can be disabled as follows: +If so desired, networking can be disabled as follows: .RS -.IP - -If the first non-commented line contains -.B networking=no -all networking will be disabled. -This will cause all further statements in the configuration file to be ignored. -.IP - -A line that contains -.B auto_detection=no -will cause auto-detection to be skipped. Explicitly defined network scanners will still be probed. +.IP \fInetworking=no\FR +If the first non-commented line contains this entry all networking will be disabled. +All further statements in the configuration file will be ignored. +.IP \fIauto_detection=no\fR +This line will cause auto-detection to be skipped. +Explicitly defined network scanners will still be probed. .SH USB SUPPORT USB scanners will be auto-detected and require no configuration. .SH NETWORKING SUPPORT @@ -446,7 +458,7 @@ the verbosity and includes the information printed at the lower levels. .RE .TP .B PIXMA_EXPERIMENT -Setting to a non-zero value will enable the support for experimental models. +Setting to a non-zero value will enable experimental support for further models. You should also set SANE_DEBUG_PIXMA to 11. .TP .B SANE_CONFIG_DIR diff --git a/upstream/mageia-cauldron/man5/sane-plustek.5 b/upstream/mageia-cauldron/man5/sane-plustek.5 index 83d9b7b3..55e2c235 100644 --- a/upstream/mageia-cauldron/man5/sane-plustek.5 +++ b/upstream/mageia-cauldron/man5/sane-plustek.5 @@ -411,7 +411,9 @@ means autocalibration. .RE .PP -See the plustek.conf file for examples. +See the +.I plustek.conf +file for examples. .PP .B Note: .br @@ -475,7 +477,7 @@ export SANE_DEBUG_PLUSTEK=10 .BR sane\-usb (5), .BR sane\-u12 (5), .BR sane\-gt68xx (5), -.BR sane-\mustek_pp (5), +.BR sane\-mustek_pp (5), .BR sane\-find\-scanner (1), .BR scanimage (1) .br @@ -486,24 +488,20 @@ Please send any information and bug-reports to: .br .B SANE Mailing List .PP -Additional info and hints can be obtained from our -.br -Mailing-List archive at: -.br -.I http://www.sane\-project.org/mailing\-lists.html +Additional info and hints can be obtained from our mailing-List archive at: +.IR http://www.sane\-project.org/mailing\-lists.html . .PP To obtain debug messages from the backend, please set the environment-variable .B SANE_DEBUG_PLUSTEK -before calling your favorite scan-frontend (i.e. -.BR scanimage (1)), i.e.: - -.br +before calling your favorite SANE frontend (e.g. +.BR scanimage (1)): +.PP .I export SANE_DEBUG_PLUSTEK=20 ; scanimage .PP -The value controls the verbosity of the backend. Please note, that -values greater than 24 force the backend to output raw data files, -which could be rather large. The ending of these files is ".raw". +The value controls the verbosity of the output. Please note that +values greater than 24 force the backend to output raw data files +which could be rather large. The suffix of these files is ".raw". For problem reports it should be enough the set the verbosity to 13. diff --git a/upstream/mageia-cauldron/man5/sane-plustek_pp.5 b/upstream/mageia-cauldron/man5/sane-plustek_pp.5 index ef8b5f6c..68516d0c 100644 --- a/upstream/mageia-cauldron/man5/sane-plustek_pp.5 +++ b/upstream/mageia-cauldron/man5/sane-plustek_pp.5 @@ -291,21 +291,18 @@ Please send any information and bug-reports to: .br .B SANE Mailing List .PP -Additional info and hints can be obtained from our -.br -Mailing-List archive at: -.br -.I http://www.sane\-project.org/mailing\-lists.html +Additional info and hints can be obtained from our mailing-List archive at: +.IR http://www.sane\-project.org/mailing\-lists.html . .PP To obtain debug messages from the backend, please set the environment-variable .B SANE_DEBUG_PLUSTEK_PP -before calling your favorite scan-frontend (i.e. -.BR xscanimage (1)), i.e.: -.br +before calling your favorite SANE frontend (e.g. +.BR xscanimage (1)): +.PP .I export SANE_DEBUG_PLUSTEK_PP=20 ; xscanimage .PP -The value controls the verbosity of the backend. +The value controls the verbosity of the output. .PP .SH "KNOWN BUGS & RESTRICTIONS" diff --git a/upstream/mageia-cauldron/man5/sane-scsi.5 b/upstream/mageia-cauldron/man5/sane-scsi.5 index 01f00f7d..87894ae1 100644 --- a/upstream/mageia-cauldron/man5/sane-scsi.5 +++ b/upstream/mageia-cauldron/man5/sane-scsi.5 @@ -44,7 +44,7 @@ is the SCSI vendor string, .I MODEL is the SCSI model string, .I TYPE -is type SCSI device type string, +is the SCSI device type string, .I BUS is the SCSI bus number (named "host" in .IR /proc/scsi/scsi ), @@ -195,7 +195,7 @@ maximum buffer size can be changed at program run time, and there is no restrict version 2.2.7 on. If the new SG driver is available some backends (e.g. .BR sane\-umax (5), -.BR sane\-mustek (5) , +.BR sane\-mustek (5), .BR sane\-sharp (5)) automatically request larger SCSI buffers. If a backend does not automatically request a larger SCSI buffer, set @@ -204,9 +204,9 @@ the environment variable to the desired buffer size in bytes. It is not recommended to use more than 1 MB, because for large values the probability increases that the SG driver cannot allocate the necessary buffer(s). For ISA cards, even -1 MB might be a too large value. For a detailed discussion of memory -issues of the SG driver, see -.I http://www.torque.net/sg. +1 MB might be a too large value. +For a detailed discussion of the Linux SG SCSI driver see: +.IR https://tldp.org/HOWTO/SCSI-Generic-HOWTO . .PP For Linux kernels before version 2.2.7 the size of the buffer is only 32KB. This works, but for many cheaper scanners this causes scanning to be slower by @@ -299,7 +299,7 @@ of the form ``restart (ncr dead ?)'' in your .I /var/log/messages file or on the system console, it's an indication that the timeout is too short. In this case, find the line ``if (np->latetime>10)'' in file -.I ncr53c8xx. +.I ncr53c8xx.c (normally in directory .IR /usr/src/linux/drivers/scsi ) and change the constant 10 to, say, 60 (one minute). @@ -329,7 +329,7 @@ and with target-id 0 would be called .IR /dev/sg0a , and the device with target-id 1 on that same bus would be called -.IR /dev/sg0b, +.IR /dev/sg0b , and so on. .SH ENVIRONMENT diff --git a/upstream/mageia-cauldron/man5/sane-sharp.5 b/upstream/mageia-cauldron/man5/sane-sharp.5 index ef9f5659..9a10ae1d 100644 --- a/upstream/mageia-cauldron/man5/sane-sharp.5 +++ b/upstream/mageia-cauldron/man5/sane-sharp.5 @@ -98,7 +98,7 @@ default selection. .TP .B \-\-custom\-gamma -Custom Gamma This option determines whether a builtin or a custom +Custom Gamma. This option determines whether a builtin or a custom gamma table is used. Possible settings are: .I yes (enables custom gamma tables) or @@ -197,7 +197,7 @@ This option is only available in scan mode .TP .B \-\-threshold-red -Sets the threshold for the red component of a pixel in +Sets the threshold for the red component of a pixel in lineart color scan mode. Possible values are 1..255. The default value is 128. This option is only available in scan mode color @@ -205,7 +205,7 @@ This option is only available in scan mode color .TP .B \-\-threshold-green -Sets the threshold for the green component of a pixel in +Sets the threshold for the green component of a pixel in lineart color scan mode. Possible values are 1..255. The default value is 128. This option is only available in scan mode color @@ -213,7 +213,7 @@ This option is only available in scan mode color .TP .B \-\-threshold-blue -Sets the threshold for the blue component of a pixel in +Sets the threshold for the blue component of a pixel in lineart color scan mode. Possible values are 1..255. The default value is 128. This option is only available in scan mode color @@ -321,11 +321,11 @@ stops. Stops of the carriage can be caused by the following reasons: .PP .RS -\- too much "traffic" on the SCSI bus +\- too much "traffic" on the SCSI bus, .br \- slow responses by the backend to the scanner, .br -\- a program which processes the data acquired by the backend too slow. +\- a program which processes the data acquired by the backend is too slow. .PP .RE Too much "traffic" on the SCSI bus: This happens for example, if hard disks @@ -409,12 +409,12 @@ backend. At present, the scanner must power off and on to stop this annoying behaviour. .RE -2. Threshold level does not work (only JX-610) +2. Threshold level does not work (only JX\-610) .PP -3. The maximum resolution is limited to 600 dpi(JX-610 supported -to 1200 dpi) resp. 400 dpi (JX-250) +3. The maximum resolution is limited to 600 dpi (JX\-610 supported +to 1200 dpi) resp. 400 dpi (JX\-250) .PP -4. If the JX250 is used with an ADF, the following situation can occur: After +4. If the JX\-250 is used with an ADF, the following situation can occur: After several scans, the scanner moves, after loading a new sheet of paper, the carriage to the idle position, and then back to the position used for ADF scans. This happens for @@ -436,8 +436,8 @@ tested. Kazuya Fukuda, Abel Deuring .SH CREDITS -The Sharp backend is based on the Canon backend written by Helmut Koeberle +The Sharp backend is based on the Canon backend written by Helmut Koeberle. .PP Parts of this man page are a plain copy of .BR sane\-mustek (5) -by David Mosberger-Tang, Andreas Czechanowski and Andreas Bolsch +by David Mosberger-Tang, Andreas Czechanowski and Andreas Bolsch. diff --git a/upstream/mageia-cauldron/man5/sane-stv680.5 b/upstream/mageia-cauldron/man5/sane-stv680.5 index 060db32f..42f57492 100644 --- a/upstream/mageia-cauldron/man5/sane-stv680.5 +++ b/upstream/mageia-cauldron/man5/sane-stv680.5 @@ -82,7 +82,7 @@ scanimage \-\-help \-d stv680 .TP .B \-\-mode -selects the basic mode of operation of the webcams valid choices. +selects the basic mode of operation of the webcam's valid choices. The read resolution mode is 8 bits, output resolution is 24 bits. Selects the resolution for a scan. @@ -113,7 +113,7 @@ value loaded into the scanner. Scale \-32 .. 0 .. +32 in steps of 1. .TP .B \-\-white\-level\-g \-32..+32 Selects what green radiance level should be -considered "white", when scanning some sheets by changing the calibration i +considered "white", when scanning some sheets by changing the calibration value loaded into the scanner. Scale \-32 .. 0 .. +32 in steps of 1. .TP diff --git a/upstream/mageia-cauldron/man5/sane-teco2.5 b/upstream/mageia-cauldron/man5/sane-teco2.5 index 5574f097..2b503859 100644 --- a/upstream/mageia-cauldron/man5/sane-teco2.5 +++ b/upstream/mageia-cauldron/man5/sane-teco2.5 @@ -94,7 +94,7 @@ For a restricted set of resolutions are available. .B Note: -All values with ydpi > 300 (300 x 600) or 600 (600 x 1200) result in +All values with vertical resolution in dpi > 300 (300 x 600) or 600 (600 x 1200) result in a wrong proportion for the scan. The proportion can be adjusted with the following .BR convert (1) diff --git a/upstream/mageia-cauldron/man5/sane-test.5 b/upstream/mageia-cauldron/man5/sane-test.5 index c78f346d..69e81f45 100644 --- a/upstream/mageia-cauldron/man5/sane-test.5 +++ b/upstream/mageia-cauldron/man5/sane-test.5 @@ -235,7 +235,7 @@ constraint. Minimum is 4, maximum 192, and quant is 2. .PP Option .B int\-constraint\-array\-constraint\-word\-list -(6/7) is an int test option with unit percent and using an array a word list +(6/7) is an int test option with unit percent and using an array or word list constraint. .PP Option @@ -258,7 +258,7 @@ set. Minimum is \-42.17, maximum 32767.9999, and quant is 2.0. .PP Option .B fixed\-constraint\-word\-list -(3/3) is a Fixed test option with no unit and constraint word list set. +(3/3) is a fixed test option with no unit and constraint word list set. .PP .SH STRING TEST OPTIONS diff --git a/upstream/mageia-cauldron/man5/sane-u12.5 b/upstream/mageia-cauldron/man5/sane-u12.5 index fa66b59a..919919b2 100644 --- a/upstream/mageia-cauldron/man5/sane-u12.5 +++ b/upstream/mageia-cauldron/man5/sane-u12.5 @@ -167,20 +167,15 @@ Please send any information and bug-reports to: .br .B SANE Mailing List .PP -Additional info and hints can be obtained from our -.br -Mailing-List archive at: -.br -.I http://www.sane\-project.org/mailing\-lists.html +Additional info and hints can be obtained from our mailing-List archive at: +.IR http://www.sane\-project.org/mailing\-lists.html . .PP To obtain debug messages from the backend, please set the environment-variable .B SANE_DEBUG_U12 -before calling your favorite scan-frontend (i.e. -.BR xscanimage (1)), -i.e.: - -.br +before calling your favorite SANE frontend (e.g. +.BR xscanimage (1)): +.PP .I export SANE_DEBUG_U12=20 ; xscanimage .PP The value controls the verbosity of the backend. diff --git a/upstream/mageia-cauldron/man5/sane-umax_pp.5 b/upstream/mageia-cauldron/man5/sane-umax_pp.5 index c49d4199..958ff362 100644 --- a/upstream/mageia-cauldron/man5/sane-umax_pp.5 +++ b/upstream/mageia-cauldron/man5/sane-umax_pp.5 @@ -55,15 +55,15 @@ if you have a kernel with ppdev support. .PP Note that if you don't use the ppdev character device, the backend needs to run as root. To allow user access to the scanner -run the backend through the network interface (See +run the backend through the network interface (see .BR saned (8) and .BR sane\-net (5)). A more relaxed solution (security wise) is to add suid bit to the frontend -(See +(see .BR chmod (1)). -The backend drop root privileges as soon as it can, right after gaining direct -access to IO ports, which lessen risks when being root. +The backend drops root privileges as soon as it can, right after gaining direct +access to I/O ports, which lessen risks of being root. .SH "DEVICE NAMES" This backend expects device names of the form: @@ -73,7 +73,7 @@ This backend expects device names of the form: .RE .PP Where -\fBvalue\fR is : +\fBvalue\fR is: .RS .TP @@ -102,8 +102,8 @@ have to use .TP 0x378 does direct hardware access on the given -address. Usual values are 0x378, 0x278, 0x3BC -In this case, you have to run the scanner as +address. Usual values are 0x378, 0x278, 0x3BC. +In this case, you have to run the backend as root (*BSD and Linux), or with 'IOPL=yes' on OS/2 .PP @@ -166,8 +166,7 @@ user provided values. .PP Options -.B red\-offset -, +.BR red\-offset , .B green\-offset and .B blue\-offset diff --git a/upstream/mageia-cauldron/man5/sane-usb.5 b/upstream/mageia-cauldron/man5/sane-usb.5 index ca2eecb7..89850671 100644 --- a/upstream/mageia-cauldron/man5/sane-usb.5 +++ b/upstream/mageia-cauldron/man5/sane-usb.5 @@ -54,7 +54,9 @@ scanner under Linux) or disable the driver when compiling a new kernel. For Linux, your kernel needs support for the USB filesystem (usbfs). For kernels older than 2.4.19, replace "usbfs" with "usbdevfs" because the name has changed. This filesystem must be mounted. That's done automatically at boot -time, if /etc/fstab contains a line like this: +time, if +.I /etc/fstab +contains a line like this: .PP .RS none /proc/bus/usb usbfs defaults 0 0 @@ -97,7 +99,9 @@ For the .BR BSDs , the device files used by libusb are named .IR /dev/ugen* . -Use chmod to apply appropriate permissions. +Use +.BR chmod (1) +to apply appropriate permissions. .SH "SANE ISSUES" .PP @@ -174,6 +178,15 @@ setting the environment variable to 1. This may work around issues which happen with particular kernel versions. Example: .I export SANE_USB_WORKAROUND=1. +.TP +.B SANE_XEROX_USB_HALT_WORKAROUND +If your old (pre-2010) Xerox / Samsung / HP scanner is detected +only once and subsequent usage requires replugging the cable, try +setting the environment variable +.B SANE_XEROX_USB_HALT_WORKAROUND +to 1. This may work around issues which happen with particular USB +controllers. Example: +.I export SANE_XEROX_USB_HALT_WORKAROUND=1. .SH "SEE ALSO" .BR sane (7), diff --git a/upstream/mageia-cauldron/man5/scr_dump.5 b/upstream/mageia-cauldron/man5/scr_dump.5 index 505fca52..8f4775aa 100644 --- a/upstream/mageia-cauldron/man5/scr_dump.5 +++ b/upstream/mageia-cauldron/man5/scr_dump.5 @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2021,2023 Thomas E. Dickey * +.\" Copyright 2018-2023,2024 Thomas E. Dickey * .\" Copyright 2017 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: scr_dump.5,v 1.42 2023/12/30 22:06:36 tom Exp $ -.TH scr_dump 5 2023-12-30 "ncurses 6.4" "File formats" +.\" $Id: scr_dump.5,v 1.46 2024/03/23 20:42:29 tom Exp $ +.TH scr_dump 5 2024-03-23 "ncurses 6.4" "File formats" .ie \n(.g \{\ .ds `` \(lq .ds '' \(rq @@ -236,12 +236,12 @@ As noted above, Solaris .I curses has no magic number corresponding to SVr4 -.I curses. +.IR curses . This is odd, since Solaris was the first operating system to meet the SVr4 guidelines. Solaris furthermore supplies two versions of -.I curses. +.IR curses . .bP The default .I curses @@ -253,7 +253,7 @@ library (which we term .I \%xcurses), available in -.I /usr/xpg4, +.IR /usr/xpg4 , uses a textual format with no magic number. .IP According to its copyright notice, diff --git a/upstream/mageia-cauldron/man5/systemd.exec.5 b/upstream/mageia-cauldron/man5/systemd.exec.5 index 32439ce0..469948df 100644 --- a/upstream/mageia-cauldron/man5/systemd.exec.5 +++ b/upstream/mageia-cauldron/man5/systemd.exec.5 @@ -1532,6 +1532,12 @@ Also note that some sandboxing functionality is generally not available in user \fIProtectSystem=\fR) are not available, as the underlying kernel functionality is only accessible to privileged processes\&. However, most namespacing settings, that will not work on their own in user services, will work when used in conjunction with \fIPrivateUsers=\fR\fBtrue\fR\&. .PP +Note that the various options that turn directories read\-only (such as +\fIProtectSystem=\fR, +\fIReadOnlyPaths=\fR, \&...) do not affect the ability for programs to connect to and communicate with +\fBAF_UNIX\fR +sockets in these directores\&. These options cannot be used to lock down access to IPC services hence\&. +.PP \fIProtectSystem=\fR .RS 4 Takes a boolean argument or the special values @@ -1556,7 +1562,10 @@ and \fIProtectKernelTunables=\fR, \fIProtectControlGroups=\fR)\&. This setting ensures that any modification of the vendor\-supplied operating system (and optionally its configuration, and local mounts) is prohibited for the service\&. It is recommended to enable this setting for all long\-running services, unless they are involved with system updates or need to modify the operating system in other ways\&. If this option is used, \fIReadWritePaths=\fR -may be used to exclude specific directories from being made read\-only\&. This setting is implied if +may be used to exclude specific directories from being made read\-only\&. Similar, +\fIStateDirectory=\fR, +\fILogsDirectory=\fR, \&... and related directory settings (see below) also exclude the specific directories from the effect of +\fIProtectSystem=\fR\&. This setting is implied if \fIDynamicUser=\fR is set\&. This setting cannot ensure protection in all cases\&. In general it has the same limitations as \fIReadOnlyPaths=\fR, see below\&. Defaults to off\&. @@ -3678,6 +3687,8 @@ separated by whitespace\&. See for details on the journal field concept\&. Even though the underlying journal implementation permits binary field values, this setting accepts only valid UTF\-8 values\&. To include space characters in a journal field value, enclose the assignment in double quotes (")\&. The usual specifiers are expanded in all assignments (see below)\&. Note that this setting is not only useful for attaching additional metadata to log records of a unit, but given that all fields and values are indexed may also be used to implement cross\-unit log record matching\&. Assign an empty string to reset the list\&. .sp +Note that this functionality is currently only available in system services, not in per\-user services\&. +.sp Added in version 236\&. .RE .PP @@ -3735,6 +3746,8 @@ is defined, meaning log messages coming from \fBsystemd\fR(1) about the unit are not taken into account\&. Filtered log messages won\*(Aqt be forwarded to traditional syslog daemons, the kernel log buffer (kmsg), the systemd console, or sent as wall messages to all logged\-in users\&. .sp +Note that this functionality is currently only available in system services, not in per\-user services\&. +.sp Added in version 253\&. .RE .PP diff --git a/upstream/mageia-cauldron/man5/systemd.network.5 b/upstream/mageia-cauldron/man5/systemd.network.5 index 934e7503..3a1b53f8 100644 --- a/upstream/mageia-cauldron/man5/systemd.network.5 +++ b/upstream/mageia-cauldron/man5/systemd.network.5 @@ -688,9 +688,7 @@ Added in version 215\&. .PP \fILinkLocalAddressing=\fR .RS 4 -Enables link\-local address autoconfiguration\&. Accepts -\fByes\fR, -\fBno\fR, +Enables link\-local address autoconfiguration\&. Accepts a boolean, \fBipv4\fR, and \fBipv6\fR\&. An IPv6 link\-local address is configured when \fByes\fR @@ -1067,7 +1065,7 @@ Note\&. Any positive boolean values such as "yes" or "true" -are now deprecated\&. Please use one of the values in the above\&. +are now deprecated\&. Please use one of the values above\&. .sp Added in version 219\&. .RE @@ -3415,7 +3413,7 @@ ServerAddress=192\&.168\&.0\&.1/24 .RE .\} .sp -are equivalent to the following\&. +are equivalent to the following: .sp .if n \{\ .RS 4 @@ -3718,7 +3716,7 @@ Added in version 235\&. .PP \fIRetransmitSec=\fR .RS 4 -Takes a timespan\&. Configures the retransmit time, used by clients to retransmit Neighbor Solicitation messages on address resolution and the Neighbor Unreachability Detection algorithm\&. An integer the default unit of seconds, in the range 0\&...4294967295 msec\&. Defaults to 0\&. +Takes a timespan\&. Configures the retransmit time, used by clients to retransmit Neighbor Solicitation messages on address resolution and the Neighbor Unreachability Detection algorithm\&. An integer, the default unit is seconds, in the range 0\&...4294967295 msec\&. Defaults to 0\&. .sp Added in version 255\&. .RE @@ -3818,7 +3816,7 @@ Added in version 235\&. .PP \fIHomeAgent=\fR .RS 4 -Takes a boolean\&. Specifies that IPv6 router advertisements which indicates to hosts that the router acts as a Home Agent and includes a Home Agent Option\&. Defaults to false\&. See +Takes a boolean\&. Specifies that IPv6 router advertisements which indicate to hosts that the router acts as a Home Agent and includes a Home Agent option\&. Defaults to false\&. See \m[blue]\fBRFC 6275\fR\m[]\&\s-2\u[10]\d\s+2 for further details\&. .sp @@ -3827,7 +3825,7 @@ Added in version 255\&. .PP \fIHomeAgentLifetimeSec=\fR .RS 4 -Takes a timespan\&. Specifies the lifetime of the Home Agent\&. An integer the default unit of seconds, in the range 1\&...65535\&. Defaults to the value set to +Takes a timespan\&. Specifies the lifetime of the Home Agent\&. An integer, the default unit is seconds, in the range 1\&...65535\&. Defaults to the value set to \fIRouterLifetimeSec=\fR\&. .sp Added in version 255\&. diff --git a/upstream/mageia-cauldron/man5/systemd.pcrlock.5 b/upstream/mageia-cauldron/man5/systemd.pcrlock.5 index cadc0742..655b24f2 100644 --- a/upstream/mageia-cauldron/man5/systemd.pcrlock.5 +++ b/upstream/mageia-cauldron/man5/systemd.pcrlock.5 @@ -41,7 +41,7 @@ systemd.pcrlock, systemd.pcrlock.d \- PCR measurement prediction files files define expected TPM2 PCR measurements of components involved in the boot process\&. \fBsystemd-pcrlock\fR(1) uses such pcrlock files to analyze and predict TPM2 PCR measurements\&. The pcrlock files are JSON arrays that follow a subset of the -\m[blue]\fBTCG Common Event Log Format (CEL\-JSON)\fR\m[]\&\s-2\u[1]\d\s+2 +\m[blue]\fBTCG Canonical Event Log Format (CEL\-JSON)\fR\m[]\&\s-2\u[1]\d\s+2 specification\&. Specifically the "recnum", "content", and @@ -90,7 +90,7 @@ Added in version 255\&. 250\-firmware\-code\-early\&.pcrlock .RS 4 Firmware code measurements, as recorded to PCR 0 and 2, up to the separator measurement (see -400\-secureboot\-separator\&.pcrlock\&. +400\-secureboot\-separator\&.pcrlock below)\&. May be generated via \fBsystemd\-pcrlock lock\-firmware\-code\fR\&. .sp @@ -100,7 +100,7 @@ Added in version 255\&. 250\-firmware\-config\-early\&.pcrlock .RS 4 Firmware configuration measurements, as recorded to PCR 1 and 3, up to the separator measurement (see -400\-secureboot\-separator\&.pcrlock\&. +400\-secureboot\-separator\&.pcrlock below)\&. May be generated via \fBsystemd\-pcrlock lock\-firmware\-config\fR\&. .sp @@ -131,7 +131,7 @@ Added in version 255\&. 550\-firmware\-code\-late\&.pcrlock .RS 4 Firmware code measurements, as recorded to PCR 0 and 2, after the separator measurement (see -400\-secureboot\-separator\&.pcrlock\&. +400\-secureboot\-separator\&.pcrlock above)\&. May be generated via \fBsystemd\-pcrlock lock\-firmware\-code\fR\&. .sp @@ -141,7 +141,7 @@ Added in version 255\&. 550\-firmware\-config\-late\&.pcrlock .RS 4 Firmware configuration measurements, as recorded to PCR 1 and 3, after the separator measurement (see -400\-secureboot\-separator\&.pcrlock\&. +400\-secureboot\-separator\&.pcrlock above)\&. May be generated via \fBsystemd\-pcrlock lock\-firmware\-config\fR\&. .sp @@ -168,7 +168,7 @@ Added in version 255\&. .RS 4 The EFI action generated when \fBExitBootServices()\fR -is generated, i\&.e\&. the UEFI environment is left and the OS takes over\&. Covers the PCR 5 measurement\&. Statically defined\&. +is generated, i\&.e\&. when the UEFI environment is left and the OS takes over\&. Covers the PCR 5 measurement\&. Statically defined\&. .sp Added in version 255\&. .RE @@ -270,7 +270,7 @@ Added in version 255\&. \fBsystemd-pcrlock\fR(1) .SH "NOTES" .IP " 1." 4 -TCG Common Event Log Format (CEL-JSON) +TCG Canonical Event Log Format (CEL-JSON) .RS 4 \%https://trustedcomputinggroup.org/resource/canonical-event-log-format/ .RE diff --git a/upstream/mageia-cauldron/man5/systemd.resource-control.5 b/upstream/mageia-cauldron/man5/systemd.resource-control.5 index 3e1a9ae0..19e7171b 100644 --- a/upstream/mageia-cauldron/man5/systemd.resource-control.5 +++ b/upstream/mageia-cauldron/man5/systemd.resource-control.5 @@ -702,6 +702,8 @@ The system default for this setting may be controlled with in \fBsystemd-system.conf\fR(5)\&. .sp +Note that this functionality is currently only available for system services, not for per\-user services\&. +.sp Added in version 235\&. .RE .PP @@ -833,9 +835,9 @@ Added in version 235\&. .PP \fISocketBindAllow=\fR\fI\fIbind\-rule\fR\fR, \fISocketBindDeny=\fR\fI\fIbind\-rule\fR\fR .RS 4 -Allow or deny binding a socket address to a socket by matching it with the -\fIbind\-rule\fR -and applying a corresponding action if there is a match\&. +Configures restrictions on the ability of unit processes to invoke +\fBbind\fR(2) +on a socket\&. Both allow and deny rules may defined that restrict which addresses a socket may be bound to\&. .sp \fIbind\-rule\fR describes socket properties such as @@ -964,6 +966,11 @@ and \fBcgroup/bind6\fR cgroup\-bpf hooks\&. .sp +Note that these settings apply to any +\fBbind\fR(2) +system call invocation by the unit processes, regardless in which network namespace they are placed\&. Or in other words: changing the network namespace is not a suitable mechanism for escaping these restrictions on +\fBbind()\fR\&. +.sp Examples: .sp .if n \{\ @@ -1190,6 +1197,8 @@ table inet filter { .RE .\} .sp +This option is only available for system services and is not supported for services running in per\-user instances of the service manager\&. +.sp Added in version 255\&. .RE .SS "BPF Programs" diff --git a/upstream/mageia-cauldron/man5/systemd.service.5 b/upstream/mageia-cauldron/man5/systemd.service.5 index 19597a2e..8b68b9b5 100644 --- a/upstream/mageia-cauldron/man5/systemd.service.5 +++ b/upstream/mageia-cauldron/man5/systemd.service.5 @@ -1737,7 +1737,7 @@ T} T{ ":" T}:T{ -If the executable path is prefixed with ":", environment variable substitution (as described by the "Command Lines" section below) is not applied\&. +If the executable path is prefixed with ":", environment variable substitution (as described below this table) is not applied\&. T} T{ "+" @@ -2166,7 +2166,7 @@ for this\&. A typical service file for such a daemon would look like this: Description=Simple notifying service [Service] -Type=notify +Type=notify\-reload ExecStart=/usr/sbin/simple\-notifying\-service [Install] @@ -2182,6 +2182,14 @@ Note that the daemon has to support systemd\*(Aqs notification protocol, else sy Please see \fBsystemd.kill\fR(5) for details on how you can influence the way systemd terminates the service\&. +.PP +To avoid code duplication, it is preferable to use +\fBsd_notify\fR(3) +when possible, especially when other APIs provided by +\fBlibsystemd\fR(3) +are also used, but note that the notification protocol is very simple and guaranteed to be stable as per the +\m[blue]\fBInterface Portability and Stability Promise\fR\m[]\&\s-2\u[4]\d\s+2, so it can be reimplemented by services with no external dependencies\&. For a self\-contained example, see +\fBsd_notify\fR(3)\&. .SH "SEE ALSO" .PP \fBsystemd\fR(1), @@ -2209,3 +2217,8 @@ Control Group v2 .RS 4 \%https://docs.kernel.org/admin-guide/cgroup-v2.html .RE +.IP " 4." 4 +Interface Portability and Stability Promise +.RS 4 +\%https://systemd.io/PORTABILITY_AND_STABILITY/ +.RE diff --git a/upstream/mageia-cauldron/man5/systemd.socket.5 b/upstream/mageia-cauldron/man5/systemd.socket.5 index 1cd05d5c..f8d4a7cd 100644 --- a/upstream/mageia-cauldron/man5/systemd.socket.5 +++ b/upstream/mageia-cauldron/man5/systemd.socket.5 @@ -727,7 +727,7 @@ Added in version 247\&. .RS 4 Takes a string value\&. Controls the TCP congestion algorithm used by this socket\&. Should be one of "westwood", -"veno", +"reno", "cubic", "lp" or any other available algorithm supported by the IP stack\&. This setting applies only to stream sockets\&. diff --git a/upstream/mageia-cauldron/man5/term.5 b/upstream/mageia-cauldron/man5/term.5 index 92ed3fe8..2b96fb63 100644 --- a/upstream/mageia-cauldron/man5/term.5 +++ b/upstream/mageia-cauldron/man5/term.5 @@ -28,8 +28,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: term.5,v 1.73 2024/01/13 22:05:39 tom Exp $ -.TH term 5 2024-01-13 "ncurses 6.4" "File formats" +.\" $Id: term.5,v 1.75 2024/03/16 15:35:01 tom Exp $ +.TH term 5 2024-03-16 "ncurses 6.4" "File formats" .ie \n(.g \{\ .ds `` \(lq .ds '' \(rq diff --git a/upstream/mageia-cauldron/man5/terminfo.5 b/upstream/mageia-cauldron/man5/terminfo.5 index c57e8824..2c422817 100644 --- a/upstream/mageia-cauldron/man5/terminfo.5 +++ b/upstream/mageia-cauldron/man5/terminfo.5 @@ -82,7 +82,7 @@ have, by specifying how to perform screen operations, and by specifying padding requirements and initialization sequences. .PP This manual describes \fI\%ncurses\fP -version 6.4 (patch 20240217). +version 6.4 (patch 20240323). .SS "\fIterminfo\fP Entry Syntax" Entries in .I terminfo @@ -229,53 +229,72 @@ using terminal entry. .SS "Predefined Capabilities" .\" Head of terminfo man page ends here .ps -1 -The following is a complete table of the capabilities included in a -terminfo description block and available to terminfo-using code. -In each line of the table, +Tables of capabilities +.I \%ncurses +recognizes in a +.I \%term\%info +terminal type description and available to +.IR \%term\%info -using +code follow. .bP -The \fBvariable\fR is the name by which the programmer (at the terminfo level) -accesses the capability. +The capability name identifies the symbol by which the programmer +using the +.I \%term\%info +API accesses the capability. .bP -The \fBcapname\fR (\fICap-name\fP) -is the short name used in the text of the database, -and is used by a person updating the database. +The TI +.RI ( \%term\%info ) +code is the short name used by a person composing or updating a +terminal type entry. .IP -Whenever possible, capnames are chosen to be the same as or similar to -the ANSI X3.64-1979 standard (now superseded by ECMA-48, which uses -identical or very similar names). +Whenever possible, +these codes are the same as or similar to those of the ANSI X3.64-1979 +standard +(now superseded by ECMA-48, +which uses identical or very similar names). Semantics are also intended to match those of the specification. .IP -Capability names have no hard length limit, but an informal limit of 5 -characters has been adopted to keep them short and to allow the tabs in -the source file -.B Caps +.I \%term\%info +codes have no hard length limit, +but +.I \%ncurses +maintains an informal one of 5 characters to keep them short and to +allow the tabs in the source file +.I Caps to line up nicely. +(Some standard codes exceed this limit regardless.) .bP -The \fBtermcap\fP (\fITcap\fP) code is the old capability name -(some capabilities are new, and have names which termcap did not originate). +The TC +.RI ( \%term\%cap ) +code is that used by the corresponding API of +.I \%ncurses. +(Some capabilities are new, +and have names that BSD +.I \%term\%cap +did not originate.) .bP -Finally, the \fBdescription\fP field attempts to convey the semantics of the -capability. +The description field attempts to convey the capability's semantics. .PP -You may find some codes in the description field: +The description field employs a handful of notations. .TP -(P) -indicates that padding may be specified +.B (P) +indicates that padding may be specified. .TP -#[1-9] -in the description field indicates that the string is passed -through \fBtparm\fP(3X) with parameters as given (#\fIi\fP). -.IP -If no parameters are listed in the description, -passing the string through \fBtparm\fP(3X) may give unexpected results, -e.g., if it contains percent (%%) signs. -.TP -(P*) -indicates that padding may vary in proportion to the number of -lines affected +.B (P*) +indicates that padding may vary in proportion to the number of output +lines affected. .TP -(#\d\fIi\fP\u) -indicates the \fIi\fP\uth\d parameter. +.BI # i +indicates the +.IR i th +parameter of a string capability; +the programmer should pass the string to \fB\%tparm\fP(3X) with the +parameters listed. +.IP +If the description lists no parameters, +passing the string to \fB\%tparm\fP(3X) may produce unexpected +behavior, +for instance if the string contains percent signs. . .PP .TS @@ -852,6 +871,10 @@ key_down kcud1 kd T{ .ad l down-arrow key T} +.TE +.TS +center; +Lbw(25n)2 Lbw(8n)2 Lb2 Lx. key_eic krmir kM T{ .ad l sent by rmir or smir in insert mode @@ -1100,6 +1123,10 @@ reset_2string rs2 r2 T{ .ad l reset string T} +.TE +.TS +center; +Lbw(25n)2 Lbw(8n)2 Lb2 Lx. reset_3string rs3 r3 T{ .ad l reset string @@ -1348,6 +1375,10 @@ key_undo kund &8 T{ .ad l undo key T} +.TE +.TS +center; +Lbw(25n)2 Lbw(8n)2 Lb2 Lx. key_sbeg kBEG &9 T{ .ad l shifted begin key @@ -1596,6 +1627,10 @@ key_f42 kf42 FW T{ .ad l F42 function key T} +.TE +.TS +center; +Lbw(25n)2 Lbw(8n)2 Lb2 Lx. key_f43 kf43 FX T{ .ad l F43 function key @@ -1844,6 +1879,10 @@ enter_doublewide_mode swidm ZF T{ .ad l Enter double-wide mode T} +.TE +.TS +center; +Lbw(25n)2 Lbw(8n)2 Lb2 Lx. enter_draft_quality sdrfq ZG T{ .ad l Enter draft-quality mode @@ -2246,7 +2285,7 @@ T} .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: terminfo.tail,v 1.143 2024/01/13 22:05:39 tom Exp $ +.\" $Id: terminfo.tail,v 1.144 2024/03/02 14:36:39 tom Exp $ .ps +1 .SS "User-Defined Capabilities" . @@ -3914,6 +3953,8 @@ magenta COLOR_MAGENTA 5 max, 0, max cyan COLOR_CYAN 6 0, max, max white COLOR_WHITE 7 max, max, max .TE +.br +.if t .ne 6v .PP The argument values of \fBsetf\fP/\fBsetb\fP historically correspond to a different mapping, i.e., diff --git a/upstream/mageia-cauldron/man5/user_caps.5 b/upstream/mageia-cauldron/man5/user_caps.5 index ad809362..f891fea7 100644 --- a/upstream/mageia-cauldron/man5/user_caps.5 +++ b/upstream/mageia-cauldron/man5/user_caps.5 @@ -28,8 +28,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: user_caps.5,v 1.47 2024/01/13 22:05:39 tom Exp $ -.TH user_caps 5 2024-01-13 "ncurses 6.4" "File formats" +.\" $Id: user_caps.5,v 1.49 2024/03/16 15:35:01 tom Exp $ +.TH user_caps 5 2024-03-16 "ncurses 6.4" "File formats" .ie \n(.g \{\ .ds `` \(lq .ds '' \(rq |