openpty: Provide replacement on AIX, HP-UX, IRIX, Solaris.
[gnulib.git] / lib / pty.in.h
1 /* Substitute for and wrapper around <pty.h>.
2    Copyright (C) 2010 Free Software Foundation, Inc.
3
4    This program is free software; you can redistribute it and/or modify
5    it under the terms of the GNU General Public License as published by
6    the Free Software Foundation; either version 2, or (at your option)
7    any later version.
8
9    This program is distributed in the hope that it will be useful,
10    but WITHOUT ANY WARRANTY; without even the implied warranty of
11    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
12    GNU General Public License for more details.
13
14    You should have received a copy of the GNU General Public License
15    along with this program; if not, write to the Free Software Foundation,
16    Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.  */
17
18 #ifndef _GL_PTY_H
19
20 #if __GNUC__ >= 3
21 @PRAGMA_SYSTEM_HEADER@
22 #endif
23
24 /* The include_next requires a split double-inclusion guard.  */
25 #if @HAVE_PTY_H@
26 # @INCLUDE_NEXT@ @NEXT_PTY_H@
27 #endif
28
29 #ifndef _GL_PTY_H
30 #define _GL_PTY_H
31
32 /* Some platforms declare this in a different header than glibc.  */
33 #if @HAVE_UTIL_H@
34 # include <util.h>
35 #endif
36 #if @HAVE_LIBUTIL_H@
37 # include <libutil.h>
38 #endif
39
40 /* Get 'struct termios' and 'struct winsize'.  */
41 #include <termios.h>
42
43 /* The definitions of _GL_FUNCDECL_RPL etc. are copied here.  */
44
45 /* The definition of _GL_WARN_ON_USE is copied here.  */
46
47
48 /* Declare overridden functions.  */
49
50 #if @GNULIB_FORKPTY@
51 # if @REPLACE_FORKPTY@
52 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
53 #   undef forkpty
54 #   define forkpty rpl_forkpty
55 #  endif
56 _GL_FUNCDECL_RPL (forkpty, int,
57                   (int *, char *, struct termios const *,
58                    struct winsize const *));
59 _GL_CXXALIAS_RPL (forkpty, int,
60                   (int *, char *, struct termios const *,
61                    struct winsize const *));
62 # else
63 _GL_CXXALIAS_SYS (forkpty, int,
64                   (int *, char *, struct termios const *,
65                    struct winsize const *));
66 # endif
67 _GL_CXXALIASWARN (forkpty);
68 #elif defined GNULIB_POSIXCHECK
69 # undef forkpty
70 # if HAVE_RAW_DECL_FORKPTY
71 _GL_WARN_ON_USE (forkpty, "forkpty is not declared consistently - "
72                  "use gnulib module forkpty for portability");
73 # endif
74 #endif
75
76 #if @GNULIB_OPENPTY@
77 /* Create pseudo tty master slave pair and set terminal attributes
78    according to TERMP and WINP.  Return handles for both ends in
79    *AMASTER and *ASLAVE, and return the name of the slave end in NAME.  */
80 # if @REPLACE_OPENPTY@
81 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
82 #   undef openpty
83 #   define openpty rpl_openpty
84 #  endif
85 _GL_FUNCDECL_RPL (openpty, int,
86                   (int *amaster, int *aslave, char *name,
87                    struct termios const *termp, struct winsize const *winp));
88 _GL_CXXALIAS_RPL (openpty, int,
89                   (int *amaster, int *aslave, char *name,
90                    struct termios const *termp, struct winsize const *winp));
91 # else
92 #  if !@HAVE_OPENPTY@
93 _GL_FUNCDECL_SYS (openpty, int,
94                   (int *amaster, int *aslave, char *name,
95                    struct termios const *termp, struct winsize const *winp));
96 #  endif
97 _GL_CXXALIAS_SYS (openpty, int,
98                   (int *amaster, int *aslave, char *name,
99                    struct termios const *termp, struct winsize const *winp));
100 # endif
101 _GL_CXXALIASWARN (openpty);
102 #elif defined GNULIB_POSIXCHECK
103 # undef openpty
104 # if HAVE_RAW_DECL_OPENPTY
105 _GL_WARN_ON_USE (openpty, "openpty is not declared consistently - "
106                  "use gnulib module openpty for portability");
107 # endif
108 #endif
109
110
111 #endif /* _GL_PTY_H */
112 #endif /* _GL_PTY_H */