Technical Reference: Base Operating System and Extensions , Volume 2

restartterm Subroutine

Purpose

Re-initializes the terminal structures after a restore.

Syntax

#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.

Parameters

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.

Example

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.