1*0c3ae37fSLionel Sambuc.\" $NetBSD: curses_termcap.3,v 1.6 2012/04/21 12:27:28 roy Exp $ 251ffecc1SBen Gras.\" 351ffecc1SBen Gras.\" Copyright (c) 2002 451ffecc1SBen Gras.\" Brett Lymn (blymn@NetBSD.org, brett_lymn@yahoo.com.au) 551ffecc1SBen Gras.\" 651ffecc1SBen Gras.\" This code is donated to the NetBSD Foundation by the Author. 751ffecc1SBen Gras.\" 851ffecc1SBen Gras.\" Redistribution and use in source and binary forms, with or without 951ffecc1SBen Gras.\" modification, are permitted provided that the following conditions 1051ffecc1SBen Gras.\" are met: 1151ffecc1SBen Gras.\" 1. Redistributions of source code must retain the above copyright 1251ffecc1SBen Gras.\" notice, this list of conditions and the following disclaimer. 1351ffecc1SBen Gras.\" 2. Redistributions in binary form must reproduce the above copyright 1451ffecc1SBen Gras.\" notice, this list of conditions and the following disclaimer in the 1551ffecc1SBen Gras.\" documentation and/or other materials provided with the distribution. 1651ffecc1SBen Gras.\" 3. The name of the Author may not be used to endorse or promote 1751ffecc1SBen Gras.\" products derived from this software without specific prior written 1851ffecc1SBen Gras.\" permission. 1951ffecc1SBen Gras.\" 2051ffecc1SBen Gras.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND 2151ffecc1SBen Gras.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 2251ffecc1SBen Gras.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 2351ffecc1SBen Gras.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE 2451ffecc1SBen Gras.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 2551ffecc1SBen Gras.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 2651ffecc1SBen Gras.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 2751ffecc1SBen Gras.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 2851ffecc1SBen Gras.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 2951ffecc1SBen Gras.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 3051ffecc1SBen Gras.\" SUCH DAMAGE. 3151ffecc1SBen Gras.\" 3251ffecc1SBen Gras.\" 33*0c3ae37fSLionel Sambuc.Dd October 4, 2011 3451ffecc1SBen Gras.Dt CURSES_TERMCAP 3 3551ffecc1SBen Gras.Os 3651ffecc1SBen Gras.Sh NAME 3751ffecc1SBen Gras.Nm curses_termcap , 38*0c3ae37fSLionel Sambuc.Nm fullname 3951ffecc1SBen Gras.Nd curses termcap querying routines 4051ffecc1SBen Gras.Sh LIBRARY 4151ffecc1SBen Gras.Lb libcurses 4251ffecc1SBen Gras.Sh SYNOPSIS 4351ffecc1SBen Gras.In curses.h 4451ffecc1SBen Gras.Ft char * 4551ffecc1SBen Gras.Fn fullname "char *termbuf" "char *name" 4651ffecc1SBen Gras.Sh DESCRIPTION 4751ffecc1SBen GrasThe 4851ffecc1SBen Gras.Fn fullname 4951ffecc1SBen Grasfunction takes the termcap entry in 5051ffecc1SBen Gras.Fa termbuf 5151ffecc1SBen Grasand copies the full name of the terminal from the entry into the 5251ffecc1SBen Grastarget variable 5351ffecc1SBen Gras.Fa name . 5451ffecc1SBen GrasThe full name of the terminal is assumed to be the last alias in the 5551ffecc1SBen Grastermcap entry name. 5651ffecc1SBen GrasIt is assumed that the 5751ffecc1SBen Gras.Fa name 5851ffecc1SBen Grasvariable has sufficient storage to hold the full name of the terminal. 5951ffecc1SBen Gras.Sh RETURN VALUES 6051ffecc1SBen GrasFunctions returning pointers will return 6151ffecc1SBen Gras.Dv NULL 6251ffecc1SBen Grasif an error is detected. 6351ffecc1SBen GrasThe functions that return an int will return one of the following 6451ffecc1SBen Grasvalues: 6551ffecc1SBen Gras.Pp 6651ffecc1SBen Gras.Bl -tag -width ERR -compact 6751ffecc1SBen Gras.It Er OK 6851ffecc1SBen GrasThe function completed successfully. 6951ffecc1SBen Gras.It Er ERR 7051ffecc1SBen GrasAn error occurred in the function. 7151ffecc1SBen Gras.El 7251ffecc1SBen Gras.Sh SEE ALSO 73*0c3ae37fSLionel Sambuc.Xr terminfo 5 7451ffecc1SBen Gras.Sh STANDARDS 7551ffecc1SBen GrasThe 7651ffecc1SBen Gras.Lb libcurses 7751ffecc1SBen Graslibrary complies with the X/Open Curses specification, part of the 7851ffecc1SBen GrasSingle Unix Specification. 7951ffecc1SBen Gras.Sh HISTORY 8051ffecc1SBen GrasThe Curses package appeared in 8151ffecc1SBen Gras.Bx 4.0 . 82