[ Previous | Next | Table of Contents | Index | Library Home | Legal | Search ]

Technical Reference: Base Operating System and Extensions , Volume 2

restartterm Subroutine


Re-initializes the terminal structures after a restore.


Curses Library (libcurses.a)


#include <curses.h>
#include <term.h>

restartterm ( Term, FileNumber, ErrorCode)
char *Term;
int FileNumber;
int *ErrorCode;


The restartterm subroutine is similar to the setupterm subroutine except that it is called after restoring memory to a previous state. For example, you would call the restartterm subroutine after a call to scr_restore if the terminal type has changed. The restartterm subroutine assumes that the windows and the input and output options are the same as when memory was saved, but the terminal type and baud rate may be different.


Term Specifies the terminal name to obtain the terminal for. If 0 is passed for the parameter, the value of the $TERM environment variable is used.
FileNumber Specifies the output file's file descriptor (1 equals standard out).
ErrorCode Specifies a pointer to an integer to return the error code to. If 0, then the restartterm subroutine exits with an error message instead of returning.

Implementation Specifics

This subroutine is part of Base Operating System (BOS) Runtime.


To restart an aixterm after a previous memory save and exit on error with a message, enter:

restartterm("aixterm", 1, (int*)0);

Implementation Specifics

This routine is part of Base Operating System (BOS) Runtime

Prerequisite Information

Curses Overview for Programming and Understanding Terminals with Curses in AIX 5L Version 5.1 General Programming Concepts: Writing and Debugging Programs .

Related Information

The setupterm (setupterm Subroutine) subroutine.

[ Previous | Next | Table of Contents | Index | Library Home | Legal | Search ]