resizeterm man page on DigitalUNIX

Man page or keyword search:  
man Server   12896 pages
apropos Keyword Search (all sections)
Output format
DigitalUNIX logo
[printable version]

resizeterm(3X)							resizeterm(3X)

       resizeterm - change the curses terminal size

       #include <ncurses.h>

       int resizeterm(int lines, int columns);

       This is an extension to the curses library.  It provides callers with a
       hook into the ncurses data to resize windows, primarily for use by pro‐
       grams  running  in  an  X  Window terminal (e.g., xterm).  The function
       resizeterm resizes the standard and current windows  to	the  specified
       dimensions,  and	 adjusts  other	 bookkeeping  data used by the ncurses
       library that record the window dimensions.

       When resizing the windows, the function blank-fills the areas that  are
       extended.  The  calling	application  should  fill  in these areas with
       appropriate data.

       The function attempts to resize all windows.  However, due to the call‐
       ing  convention	of  pads,  it  is not possible to resize these without
       additional interaction with the application.

       The function returns the integer ERR upon failure and  OK  on  success.
       It will fail if either of the dimensions less than or equal to zero, or
       if an error occurs while (re)allocating memory for the windows.

       While this function is intended to be used to support a signal  handler
       (i.e.,  for  SIGWINCH),	care should be taken to avoid invoking it in a
       context where malloc or realloc may have	 been  interrupted,  since  it
       uses those functions.

       If  ncurses  is	configured  to	supply	its  own SIGWINCH handler, the
       resizeterm function ungetch's a KEY_RESIZE which will be	 read  on  the
       next  call  to  getch.	This  is used to alert an application that the
       screen size has changed, and that it should  repaint  special  features
       such as pads that cannot be done automatically.


       Thomas  Dickey  (from  an  equivalent  function written in 1988 for BSD


List of man pages available for DigitalUNIX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
Vote for polarhome
Free Shell Accounts :: the biggest list on the net