man-pages/man8/resizecons.8.html
2021-03-31 01:06:50 +01:00

133 lines
3.5 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of RESIZECONS</TITLE>
</HEAD><BODY>
<H1>RESIZECONS</H1>
Section: Console Support (8)<BR>Updated: 17 Jan 1995<BR><A HREF="#index">Index</A>
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>
resizecons - change kernel idea of the console size
<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>
<B>resizecons </B><I>COLSxROWS</I>
<BR>
<B>resizecons -lines </B><I>ROWS</I>
<A NAME="lbAD">&nbsp;</A>
<H2>DESCRIPTION</H2>
The
<I>resizecons</I>
command tries to change the videomode of the console.
There are several aspects to this: (a) the kernel must know about it,
(b) the hardware must know about it, (c) user programs must know
about it, (d) the console font may have to be adapted.
<P>
(a) The kernel is told about the change using the ioctl VT_RESIZE.
This causes the kernel to reallocate console screen memory for
all virtual consoles, and might fail if there is not enough memory.
(In that case, try to disallocate some virtual consoles first.)
If this ioctl succeeds, but a later step fails (e.g., because
you do not have root permissions), you may be left with a very messy
screen.
<P>
The most difficult part of this is (b), since it requires detailed
knowledge of the video card hardware, and the setting of numerous
registers. Only changing the number of rows is slightly easier, and
<I>resizecons</I>
will try to do that itself, when given the
<I>-lines</I>
option. (Probably, root permission will be required.)
The command
<I>resizecons COLSxROWS</I>
will execute
<I>restoretextmode -r COLSxROWS</I>
(and hence requires that you have svgalib installed). Here COLSxROWS
is a file that was created earlier by
<I>restoretextmode -w COLSxROWS.</I>
Again, either root permissions are required, or
<I>restoretextmode</I>
has to be suid root.
<P>
In order to deal with (c),
<I>resizecons</I>
does a `stty rows ROWS cols COLS' for each active console (in the
range tty0..tty15), and sends a SIGWINCH signal to
<I>selection</I>
if it finds the file /tmp/selection.pid.
<P>
Finally, (d) is dealt with by executing a
<I>setfont</I>
command. Most likely, the wrong font is loaded, and you may want to
do another
<I>setfont</I>
yourself afterwards.
<P>
<A NAME="lbAE">&nbsp;</A>
<H2>BUGS</H2>
<I>resizecons</I>
does not work on all hardware. For example, it cannot be used on
platforms other than x86 and x86_64. See the
<B><A HREF="/cgi-bin/man/man2html?1+fbset">fbset</A></B>(1)
program if you are looking for an alternative.
<P>
This command used to be called
<I>resize,</I>
but was renamed to avoid conflict with another command with the same name.
<P>
<A NAME="lbAF">&nbsp;</A>
<H2>SEE ALSO</H2>
<B><A HREF="/cgi-bin/man/man2html?8+setfont">setfont</A></B>(8),
<B><A HREF="/cgi-bin/man/man2html?1+stty">stty</A></B>(1),
<B><A HREF="/cgi-bin/man/man2html?1+selection">selection</A></B>(1),
<B><A HREF="/cgi-bin/man/man2html?8+restoretextmode">restoretextmode</A></B>(8),
<B><A HREF="/cgi-bin/man/man2html?8+disalloc">disalloc</A></B>(8),
<B><A HREF="/cgi-bin/man/man2html?1+fbset">fbset</A></B>(1)
<P>
<P>
<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT id="1"><A HREF="#lbAB">NAME</A><DD>
<DT id="2"><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT id="3"><A HREF="#lbAD">DESCRIPTION</A><DD>
<DT id="4"><A HREF="#lbAE">BUGS</A><DD>
<DT id="5"><A HREF="#lbAF">SEE ALSO</A><DD>
</DL>
<HR>
This document was created by
<A HREF="/cgi-bin/man/man2html">man2html</A>,
using the manual pages.<BR>
Time: 00:06:15 GMT, March 31, 2021
</BODY>
</HTML>