.TH TICKIT_TERM_SET_OUTPUT_FD 3
.SH NAME
tickit_term_set_output_fd, tickit_term_get_output_fd \- manage terminal output
.SH SYNOPSIS
.EX
.B #include <tickit.h>
.sp
.BI "void tickit_term_set_output_fd(TickitTerm *" tt ", int " fd );
.BI "int tickit_term_get_output_fd(TickitTerm *" tt );
.EE
.sp
Link with \fI\-ltickit\fP.
.SH DESCRIPTION
\fBtickit_term_set_output_fd\fP() associates an output file descriptor with the terminal instance. If no output function has been set by \fBtickit_term_set_output_func\fP(3) then this file descriptor will be used to send bytes to the user's terminal. This file descriptor will also be used by \fBtickit_term_refresh_size\fP(3) to query the size of the terminal by issuing the \fBTIOCGWINSZ\fP \fBioctl\fP(2). The value -1 may be set to indicate an absence of a file descriptor.
.PP
\fBtickit_term_get_output_fd\fP() returns the currently associated output file descriptor, or -1 if none has been set.
.PP
After both an input and output method have been defined, it is recommended to call \fBtickit_term_await_started\fP(3) to wait for the terminal to be set up.
.SH "RETURN VALUE"
\fBtickit_term_set_output_fd\fP() returns no value. \fBtickit_term_get_output_fd\fP() returns a file descriptor or -1.
.SH "SEE ALSO"
.BR tickit_term_new (3),
.BR tickit_term_set_output_func (3),
.BR tickit_term_await_started (3),
.BR tickit_term_print (3),
.BR tickit_term (7),
.BR tickit (7)