[PATCH 1/4] ioctl_console.2: ffix

[PATCH 1/4] ioctl_console.2: ffix

[наб]

[-- Attachment #1: Type: text/plain, Size: 2692 bytes --]

Separate TIOCLINUX from subcode: they're separate variables

Signed-off-by: Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz>
---
 man2/ioctl_console.2 | 22 +++++++++++-----------
 1 file changed, 11 insertions(+), 11 deletions(-)

diff --git a/man2/ioctl_console.2 b/man2/ioctl_console.2
index 28eaade83..932be4e10 100644
--- a/man2/ioctl_console.2
+++ b/man2/ioctl_console.2
@@ -664,7 +664,7 @@ referred to here as the
 .IR subcode .
 These are legal only for the superuser or the owner of the current terminal.
 .TP
-.B "TIOCLINUX, subcode=0"
+.BR TIOCLINUX ", " subcode=0
 Dump the screen.
 Disappeared in Linux 1.1.92.
 (With kernel 1.1.92 or later, read from
@@ -673,11 +673,11 @@ or
 .I /dev/vcsaN
 instead.)
 .TP
-.B "TIOCLINUX, subcode=1"
+.BR TIOCLINUX ", " subcode=1
 Get task information.
 Disappeared in Linux 1.1.92.
 .TP
-.B "TIOCLINUX, subcode=2"
+.BR TIOCLINUX ", " subcode=2
 Set selection.
 .I argp
 points to a
@@ -710,35 +710,35 @@ The indicated screen characters are highlighted and saved
 in the static array sel_buffer in
 .IR devices/char/console.c .
 .TP
-.B "TIOCLINUX, subcode=3"
+.BR TIOCLINUX ", " subcode=3
 Paste selection.
 The characters in the selection buffer are
 written to
 .IR fd .
 .TP
-.B "TIOCLINUX, subcode=4"
+.BR TIOCLINUX ", " subcode=4
 Unblank the screen.
 .TP
-.B "TIOCLINUX, subcode=5"
+.BR TIOCLINUX ", " subcode=5
 Sets contents of a 256-bit look up table defining characters in a "word",
 for word-by-word selection.
 (Since Linux 1.1.32.)
 .TP
-.B "TIOCLINUX, subcode=6"
+.BR TIOCLINUX ", " subcode=6
 .I argp
 points to a char which is set to the value of the kernel
 variable
 .IR shift_state .
 (Since Linux 1.1.32.)
 .TP
-.B "TIOCLINUX, subcode=7"
+.BR TIOCLINUX ", " subcode=7
 .I argp
 points to a char which is set to the value of the kernel
 variable
 .IR report_mouse .
 (Since Linux 1.1.33.)
 .TP
-.B "TIOCLINUX, subcode=8"
+.BR TIOCLINUX ", " subcode=8
 Dump screen width and height, cursor position, and all the
 character-attribute pairs.
 (Kernels 1.1.67 through 1.1.91 only.
@@ -746,7 +746,7 @@ With kernel 1.1.92 or later, read from
 .I /dev/vcsa*
 instead.)
 .TP
-.B "TIOCLINUX, subcode=9"
+.BR TIOCLINUX ", " subcode=9
 Restore screen width and height, cursor position, and all the
 character-attribute pairs.
 (Kernels 1.1.67 through 1.1.91 only.
@@ -754,7 +754,7 @@ With kernel 1.1.92 or later, write to
 .I /dev/vcsa*
 instead.)
 .TP
-.B "TIOCLINUX, subcode=10"
+.BR TIOCLINUX ", " subcode=10
 Handles the Power Saving
 feature of the new generation of monitors.
 VESA screen blanking mode is set to
-- 
2.30.2


[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]

[PATCH 2/4] ioctl_console.2: use symbolic subcodes

[наб]

[-- Attachment #1: Type: text/plain, Size: 2883 bytes --]

Signed-off-by: Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz>
---
 man2/ioctl_console.2 | 26 +++++++++++++++-----------
 1 file changed, 15 insertions(+), 11 deletions(-)

diff --git a/man2/ioctl_console.2 b/man2/ioctl_console.2
index 932be4e10..4de0673af 100644
--- a/man2/ioctl_console.2
+++ b/man2/ioctl_console.2
@@ -663,8 +663,12 @@ pointed to by
 referred to here as the
 .IR subcode .
 These are legal only for the superuser or the owner of the current terminal.
+Symbolic
+.IR subcode s
+are available since
+Linux 2.5.71.
 .TP
-.BR TIOCLINUX ", " subcode=0
+.BR TIOCLINUX ", " subcode = 0
 Dump the screen.
 Disappeared in Linux 1.1.92.
 (With kernel 1.1.92 or later, read from
@@ -673,11 +677,11 @@ or
 .I /dev/vcsaN
 instead.)
 .TP
-.BR TIOCLINUX ", " subcode=1
+.BR TIOCLINUX ", " subcode = 1
 Get task information.
 Disappeared in Linux 1.1.92.
 .TP
-.BR TIOCLINUX ", " subcode=2
+.BR TIOCLINUX ", " subcode = TIOCL_SETSEL
 Set selection.
 .I argp
 points to a
@@ -710,35 +714,35 @@ The indicated screen characters are highlighted and saved
 in the static array sel_buffer in
 .IR devices/char/console.c .
 .TP
-.BR TIOCLINUX ", " subcode=3
+.BR TIOCLINUX ", " subcode = TIOCL_PASTESEL
 Paste selection.
 The characters in the selection buffer are
 written to
 .IR fd .
 .TP
-.BR TIOCLINUX ", " subcode=4
+.BR TIOCLINUX ", " subcode = TIOCL_UNBLANKSCREEN
 Unblank the screen.
 .TP
-.BR TIOCLINUX ", " subcode=5
+.BR TIOCLINUX ", " subcode = TIOCL_SELLOADLUT
 Sets contents of a 256-bit look up table defining characters in a "word",
 for word-by-word selection.
 (Since Linux 1.1.32.)
 .TP
-.BR TIOCLINUX ", " subcode=6
+.BR TIOCLINUX ", " subcode = TIOCL_GETSHIFTSTATE
 .I argp
 points to a char which is set to the value of the kernel
 variable
 .IR shift_state .
 (Since Linux 1.1.32.)
 .TP
-.BR TIOCLINUX ", " subcode=7
+.BR TIOCLINUX ", " subcode = TIOCL_GETMOUSEREPORTING
 .I argp
 points to a char which is set to the value of the kernel
 variable
 .IR report_mouse .
 (Since Linux 1.1.33.)
 .TP
-.BR TIOCLINUX ", " subcode=8
+.BR TIOCLINUX ", " subcode = 8
 Dump screen width and height, cursor position, and all the
 character-attribute pairs.
 (Kernels 1.1.67 through 1.1.91 only.
@@ -746,7 +750,7 @@ With kernel 1.1.92 or later, read from
 .I /dev/vcsa*
 instead.)
 .TP
-.BR TIOCLINUX ", " subcode=9
+.BR TIOCLINUX ", " subcode = 9
 Restore screen width and height, cursor position, and all the
 character-attribute pairs.
 (Kernels 1.1.67 through 1.1.91 only.
@@ -754,7 +758,7 @@ With kernel 1.1.92 or later, write to
 .I /dev/vcsa*
 instead.)
 .TP
-.BR TIOCLINUX ", " subcode=10
+.BR TIOCLINUX ", " subcode = TIOCL_SETVESABLANK
 Handles the Power Saving
 feature of the new generation of monitors.
 VESA screen blanking mode is set to
-- 
2.30.2


[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]

[PATCH 3/4] ioctl_console.2: devices/char/console.c and sel_buffer don't exist anymore

[наб]

[-- Attachment #1: Type: text/plain, Size: 709 bytes --]

And haven't for over a decade.

Signed-off-by: Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz>
---
 man2/ioctl_console.2 | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/man2/ioctl_console.2 b/man2/ioctl_console.2
index 4de0673af..6532f1069 100644
--- a/man2/ioctl_console.2
+++ b/man2/ioctl_console.2
@@ -711,8 +711,7 @@ is 0 for character-by-character selection,
 1 for word-by-word selection,
 or 2 for line-by-line selection.
 The indicated screen characters are highlighted and saved
-in the static array sel_buffer in
-.IR devices/char/console.c .
+in a kernel buffer.
 .TP
 .BR TIOCLINUX ", " subcode = TIOCL_PASTESEL
 Paste selection.
-- 
2.30.2


[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]

[PATCH 4/4] ioctl_console.2: document all extant TIOCLINUX subcodes as of 6.0 (2.6.17)

[наб]

[-- Attachment #1: Type: text/plain, Size: 2035 bytes --]

Signed-off-by: Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz>
---
The formatting for
  *(((int32_t *)&subcode) + 1)
probably wants to be slightly different ‒ I defer to your well-formed
opinions on the topic

 man2/ioctl_console.2 | 43 ++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 42 insertions(+), 1 deletion(-)

diff --git a/man2/ioctl_console.2 b/man2/ioctl_console.2
index 6532f1069..8317e13a0 100644
--- a/man2/ioctl_console.2
+++ b/man2/ioctl_console.2
@@ -785,8 +785,49 @@ blank_timer times out, then you choose this option.
 Powering down frequently will damage the monitor.)
 (Since Linux 1.1.76.)
 .RE
+.TP
+.BR TIOCLINUX ", " subcode = TIOCL_SETKMSGREDIRECT
+Change target of kernel messages ("console"):
+by default, and if this is set to
+.BR 0 ,
+messages are written to the currently active VT.
+The VT to write to is a single byte following
+.BR subcode .
+(Since Linux 2.5.36.)
+.TP
+.BR TIOCLINUX ", " subcode = TIOCL_GETFGCONSOLE
+Returns the number of VT currently in foreground.
+(Since Linux 2.5.36.)
+.TP
+.BR TIOCLINUX ", " subcode = TIOCL_SCROLLCONSOLE
+Scroll the foreground VT by the specified amount of
+.I lines
+down,
+or half the screen if
+.BR 0 .
+.I lines
+is *(((int32_t *)&subcode) + 1).
+(Since Linux 2.5.67.)
+.TP
+.BR TIOCLINUX ", " subcode = TIOCL_BLANKSCREEN
+Blank the foreground VT, ignoring "pokes" (typing):
+can only be unblanked explicitly (by switching VTs, to text mode, &c.).
+(Since Linux 2.5.71.)
+.TP
+.BR TIOCLINUX ", " subcode = TIOCL_BLANKEDSCREEN
+Returns the nomber of VT currently blanked,
+.B 0
+if none.
+(Since Linux 2.5.71.)
+.TP
+.BR TIOCLINUX ", " subcode = 16
+Never used.
+.TP
+.BR TIOCLINUX ", " subcode = TIOCL_GETKMSGREDIRECT
+Returns target of kernel messages.
+(Since Linux 2.6.17.)
 .SH RETURN VALUE
-On success, 0 is returned.
+On success, 0 is returned (except where indicated).
 On failure, \-1 is returned, and
 .I errno
 is set to indicate the error.
-- 
2.30.2

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]

Re: [PATCH 2/4] ioctl_console.2: use symbolic subcodes

[Jakub Wilk]

I was playing with TIOCLINUX just a few days, and found the docs 
unsatisfactory. So this patchset very welcome. :)

* наб <nabijaczleweli@nabijaczleweli.xyz>, 2022-09-01 15:36:
>+Symbolic
>+.IR subcode s
>+are available since
>+Linux 2.5.71.

Indeed:
https://git.kernel.org/pub/scm/linux/kernel/git/history/history.git/commit/?id=6cd8b04781e03b2669c764331181a2d3a8511fe5

It would be helpful to mention the constants are defined in <linux/tiocl.h>.

-- 
Jakub Wilk

Re: [PATCH 4/4] ioctl_console.2: document all extant TIOCLINUX subcodes as of 6.0 (2.6.17)

[Jakub Wilk]

* наб <nabijaczleweli@nabijaczleweli.xyz>, 2022-09-01 15:37:
>+can only be unblanked explicitly (by switching VTs, to text mode, &c.).

s/&c/etc/ — this is the spelling used elsewhere.

>+Returns the nomber of VT currently blanked,

s/nomber/number/

-- 
Jakub Wilk

Re: [PATCH 1/4] ioctl_console.2: ffix

[Alejandro Colomar]

[-- Attachment #1.1: Type: text/plain, Size: 3153 bytes --]

Hi!

On 9/1/22 15:35, наб wrote:
> Separate TIOCLINUX from subcode: they're separate variables
> 
> Signed-off-by: Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz>

Patch 1/4 applied.  Since there's feedback about a few others including 
2/4, I'll wait for the others.

Cheers,

Alex

> ---
>   man2/ioctl_console.2 | 22 +++++++++++-----------
>   1 file changed, 11 insertions(+), 11 deletions(-)
> 
> diff --git a/man2/ioctl_console.2 b/man2/ioctl_console.2
> index 28eaade83..932be4e10 100644
> --- a/man2/ioctl_console.2
> +++ b/man2/ioctl_console.2
> @@ -664,7 +664,7 @@ referred to here as the
>   .IR subcode .
>   These are legal only for the superuser or the owner of the current terminal.
>   .TP
> -.B "TIOCLINUX, subcode=0"
> +.BR TIOCLINUX ", " subcode=0
>   Dump the screen.
>   Disappeared in Linux 1.1.92.
>   (With kernel 1.1.92 or later, read from
> @@ -673,11 +673,11 @@ or
>   .I /dev/vcsaN
>   instead.)
>   .TP
> -.B "TIOCLINUX, subcode=1"
> +.BR TIOCLINUX ", " subcode=1
>   Get task information.
>   Disappeared in Linux 1.1.92.
>   .TP
> -.B "TIOCLINUX, subcode=2"
> +.BR TIOCLINUX ", " subcode=2
>   Set selection.
>   .I argp
>   points to a
> @@ -710,35 +710,35 @@ The indicated screen characters are highlighted and saved
>   in the static array sel_buffer in
>   .IR devices/char/console.c .
>   .TP
> -.B "TIOCLINUX, subcode=3"
> +.BR TIOCLINUX ", " subcode=3
>   Paste selection.
>   The characters in the selection buffer are
>   written to
>   .IR fd .
>   .TP
> -.B "TIOCLINUX, subcode=4"
> +.BR TIOCLINUX ", " subcode=4
>   Unblank the screen.
>   .TP
> -.B "TIOCLINUX, subcode=5"
> +.BR TIOCLINUX ", " subcode=5
>   Sets contents of a 256-bit look up table defining characters in a "word",
>   for word-by-word selection.
>   (Since Linux 1.1.32.)
>   .TP
> -.B "TIOCLINUX, subcode=6"
> +.BR TIOCLINUX ", " subcode=6
>   .I argp
>   points to a char which is set to the value of the kernel
>   variable
>   .IR shift_state .
>   (Since Linux 1.1.32.)
>   .TP
> -.B "TIOCLINUX, subcode=7"
> +.BR TIOCLINUX ", " subcode=7
>   .I argp
>   points to a char which is set to the value of the kernel
>   variable
>   .IR report_mouse .
>   (Since Linux 1.1.33.)
>   .TP
> -.B "TIOCLINUX, subcode=8"
> +.BR TIOCLINUX ", " subcode=8
>   Dump screen width and height, cursor position, and all the
>   character-attribute pairs.
>   (Kernels 1.1.67 through 1.1.91 only.
> @@ -746,7 +746,7 @@ With kernel 1.1.92 or later, read from
>   .I /dev/vcsa*
>   instead.)
>   .TP
> -.B "TIOCLINUX, subcode=9"
> +.BR TIOCLINUX ", " subcode=9
>   Restore screen width and height, cursor position, and all the
>   character-attribute pairs.
>   (Kernels 1.1.67 through 1.1.91 only.
> @@ -754,7 +754,7 @@ With kernel 1.1.92 or later, write to
>   .I /dev/vcsa*
>   instead.)
>   .TP
> -.B "TIOCLINUX, subcode=10"
> +.BR TIOCLINUX ", " subcode=10
>   Handles the Power Saving
>   feature of the new generation of monitors.
>   VESA screen blanking mode is set to

-- 
Alejandro Colomar
<http://www.alejandro-colomar.es/>

[-- Attachment #2: OpenPGP digital signature --]
[-- Type: application/pgp-signature, Size: 833 bytes --]

[PATCH v2 2/4] ioctl_console.2: use symbolic subcodes

[наб]

[-- Attachment #1: Type: text/plain, Size: 2944 bytes --]

Signed-off-by: Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz>
---
v2: uapi header noted

 man2/ioctl_console.2 | 30 ++++++++++++++++++------------
 1 file changed, 18 insertions(+), 12 deletions(-)

diff --git a/man2/ioctl_console.2 b/man2/ioctl_console.2
index 932be4e10..338c5e6c8 100644
--- a/man2/ioctl_console.2
+++ b/man2/ioctl_console.2
@@ -663,8 +663,14 @@ pointed to by
 referred to here as the
 .IR subcode .
 These are legal only for the superuser or the owner of the current terminal.
-.TP
-.BR TIOCLINUX ", " subcode=0
+Symbolic
+.IR subcode s
+are available in
+.I <linux/tiocl.h>
+since
+Linux 2.5.71.
+.TP
+.BR TIOCLINUX ", " subcode = 0
 Dump the screen.
 Disappeared in Linux 1.1.92.
 (With kernel 1.1.92 or later, read from
@@ -673,11 +679,11 @@ or
 .I /dev/vcsaN
 instead.)
 .TP
-.BR TIOCLINUX ", " subcode=1
+.BR TIOCLINUX ", " subcode = 1
 Get task information.
 Disappeared in Linux 1.1.92.
 .TP
-.BR TIOCLINUX ", " subcode=2
+.BR TIOCLINUX ", " subcode = TIOCL_SETSEL
 Set selection.
 .I argp
 points to a
@@ -710,35 +716,35 @@ The indicated screen characters are highlighted and saved
 in the static array sel_buffer in
 .IR devices/char/console.c .
 .TP
-.BR TIOCLINUX ", " subcode=3
+.BR TIOCLINUX ", " subcode = TIOCL_PASTESEL
 Paste selection.
 The characters in the selection buffer are
 written to
 .IR fd .
 .TP
-.BR TIOCLINUX ", " subcode=4
+.BR TIOCLINUX ", " subcode = TIOCL_UNBLANKSCREEN
 Unblank the screen.
 .TP
-.BR TIOCLINUX ", " subcode=5
+.BR TIOCLINUX ", " subcode = TIOCL_SELLOADLUT
 Sets contents of a 256-bit look up table defining characters in a "word",
 for word-by-word selection.
 (Since Linux 1.1.32.)
 .TP
-.BR TIOCLINUX ", " subcode=6
+.BR TIOCLINUX ", " subcode = TIOCL_GETSHIFTSTATE
 .I argp
 points to a char which is set to the value of the kernel
 variable
 .IR shift_state .
 (Since Linux 1.1.32.)
 .TP
-.BR TIOCLINUX ", " subcode=7
+.BR TIOCLINUX ", " subcode = TIOCL_GETMOUSEREPORTING
 .I argp
 points to a char which is set to the value of the kernel
 variable
 .IR report_mouse .
 (Since Linux 1.1.33.)
 .TP
-.BR TIOCLINUX ", " subcode=8
+.BR TIOCLINUX ", " subcode = 8
 Dump screen width and height, cursor position, and all the
 character-attribute pairs.
 (Kernels 1.1.67 through 1.1.91 only.
@@ -746,7 +752,7 @@ With kernel 1.1.92 or later, read from
 .I /dev/vcsa*
 instead.)
 .TP
-.BR TIOCLINUX ", " subcode=9
+.BR TIOCLINUX ", " subcode = 9
 Restore screen width and height, cursor position, and all the
 character-attribute pairs.
 (Kernels 1.1.67 through 1.1.91 only.
@@ -754,7 +760,7 @@ With kernel 1.1.92 or later, write to
 .I /dev/vcsa*
 instead.)
 .TP
-.BR TIOCLINUX ", " subcode=10
+.BR TIOCLINUX ", " subcode = TIOCL_SETVESABLANK
 Handles the Power Saving
 feature of the new generation of monitors.
 VESA screen blanking mode is set to
-- 
2.30.2


[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]

[PATCH v2 3/4] ioctl_console.2: devices/char/console.c and sel_buffer don't exist anymore

[наб]

[-- Attachment #1: Type: text/plain, Size: 709 bytes --]

And haven't for over a decade.

Signed-off-by: Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz>
---
 man2/ioctl_console.2 | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/man2/ioctl_console.2 b/man2/ioctl_console.2
index 338c5e6c8..0c25edf67 100644
--- a/man2/ioctl_console.2
+++ b/man2/ioctl_console.2
@@ -713,8 +713,7 @@ is 0 for character-by-character selection,
 1 for word-by-word selection,
 or 2 for line-by-line selection.
 The indicated screen characters are highlighted and saved
-in the static array sel_buffer in
-.IR devices/char/console.c .
+in a kernel buffer.
 .TP
 .BR TIOCLINUX ", " subcode = TIOCL_PASTESEL
 Paste selection.
-- 
2.30.2


[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]

[PATCH v2 4/4] ioctl_console.2: document all extant TIOCLINUX subcodes as of 6.0 (2.6.17)

[наб]

[-- Attachment #1: Type: text/plain, Size: 1921 bytes --]

Signed-off-by: Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz>
---
v2: with corrections from Jakub

 man2/ioctl_console.2 | 43 ++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 42 insertions(+), 1 deletion(-)

diff --git a/man2/ioctl_console.2 b/man2/ioctl_console.2
index 0c25edf67..145e98081 100644
--- a/man2/ioctl_console.2
+++ b/man2/ioctl_console.2
@@ -787,8 +787,49 @@ blank_timer times out, then you choose this option.
 Powering down frequently will damage the monitor.)
 (Since Linux 1.1.76.)
 .RE
+.TP
+.BR TIOCLINUX ", " subcode = TIOCL_SETKMSGREDIRECT
+Change target of kernel messages ("console"):
+by default, and if this is set to
+.BR 0 ,
+messages are written to the currently active VT.
+The VT to write to is a single byte following
+.BR subcode .
+(Since Linux 2.5.36.)
+.TP
+.BR TIOCLINUX ", " subcode = TIOCL_GETFGCONSOLE
+Returns the number of VT currently in foreground.
+(Since Linux 2.5.36.)
+.TP
+.BR TIOCLINUX ", " subcode = TIOCL_SCROLLCONSOLE
+Scroll the foreground VT by the specified amount of
+.I lines
+down,
+or half the screen if
+.BR 0 .
+.I lines
+is *(((int32_t *)&subcode) + 1).
+(Since Linux 2.5.67.)
+.TP
+.BR TIOCLINUX ", " subcode = TIOCL_BLANKSCREEN
+Blank the foreground VT, ignoring "pokes" (typing):
+can only be unblanked explicitly (by switching VTs, to text mode, etc.).
+(Since Linux 2.5.71.)
+.TP
+.BR TIOCLINUX ", " subcode = TIOCL_BLANKEDSCREEN
+Returns the number of VT currently blanked,
+.B 0
+if none.
+(Since Linux 2.5.71.)
+.TP
+.BR TIOCLINUX ", " subcode = 16
+Never used.
+.TP
+.BR TIOCLINUX ", " subcode = TIOCL_GETKMSGREDIRECT
+Returns target of kernel messages.
+(Since Linux 2.6.17.)
 .SH RETURN VALUE
-On success, 0 is returned.
+On success, 0 is returned (except where indicated).
 On failure, \-1 is returned, and
 .I errno
 is set to indicate the error.
-- 
2.30.2

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]

Re: [PATCH v2 4/4] ioctl_console.2: document all extant TIOCLINUX subcodes as of 6.0 (2.6.17)

[Alejandro Colomar]

[-- Attachment #1.1: Type: text/plain, Size: 2222 bytes --]

Hi!

On 9/2/22 15:07, наб wrote:
> Signed-off-by: Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz>

Patch set applied.  And added Cc: Jakub ... to the log.

Cheers,

Alex

> ---
> v2: with corrections from Jakub
> 
>   man2/ioctl_console.2 | 43 ++++++++++++++++++++++++++++++++++++++++++-
>   1 file changed, 42 insertions(+), 1 deletion(-)
> 
> diff --git a/man2/ioctl_console.2 b/man2/ioctl_console.2
> index 0c25edf67..145e98081 100644
> --- a/man2/ioctl_console.2
> +++ b/man2/ioctl_console.2
> @@ -787,8 +787,49 @@ blank_timer times out, then you choose this option.
>   Powering down frequently will damage the monitor.)
>   (Since Linux 1.1.76.)
>   .RE
> +.TP
> +.BR TIOCLINUX ", " subcode = TIOCL_SETKMSGREDIRECT
> +Change target of kernel messages ("console"):
> +by default, and if this is set to
> +.BR 0 ,
> +messages are written to the currently active VT.
> +The VT to write to is a single byte following
> +.BR subcode .
> +(Since Linux 2.5.36.)
> +.TP
> +.BR TIOCLINUX ", " subcode = TIOCL_GETFGCONSOLE
> +Returns the number of VT currently in foreground.
> +(Since Linux 2.5.36.)
> +.TP
> +.BR TIOCLINUX ", " subcode = TIOCL_SCROLLCONSOLE
> +Scroll the foreground VT by the specified amount of
> +.I lines
> +down,
> +or half the screen if
> +.BR 0 .
> +.I lines
> +is *(((int32_t *)&subcode) + 1).
> +(Since Linux 2.5.67.)
> +.TP
> +.BR TIOCLINUX ", " subcode = TIOCL_BLANKSCREEN
> +Blank the foreground VT, ignoring "pokes" (typing):
> +can only be unblanked explicitly (by switching VTs, to text mode, etc.).
> +(Since Linux 2.5.71.)
> +.TP
> +.BR TIOCLINUX ", " subcode = TIOCL_BLANKEDSCREEN
> +Returns the number of VT currently blanked,
> +.B 0
> +if none.
> +(Since Linux 2.5.71.)
> +.TP
> +.BR TIOCLINUX ", " subcode = 16
> +Never used.
> +.TP
> +.BR TIOCLINUX ", " subcode = TIOCL_GETKMSGREDIRECT
> +Returns target of kernel messages.
> +(Since Linux 2.6.17.)
>   .SH RETURN VALUE
> -On success, 0 is returned.
> +On success, 0 is returned (except where indicated).
>   On failure, \-1 is returned, and
>   .I errno
>   is set to indicate the error.

-- 
Alejandro Colomar
<http://www.alejandro-colomar.es/>

[-- Attachment #2: OpenPGP digital signature --]
[-- Type: application/pgp-signature, Size: 833 bytes --]