ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/libptytty/doc/libptytty.3.pod
Revision: 1.4
Committed: Sun Jan 22 03:49:41 2006 UTC (20 years, 7 months ago) by root
Branch: MAIN
Changes since 1.3: +23 -2 lines
Log Message:
*** empty log message ***

File Contents

# User Rev Content
1 root 1.1 =head1 NAME
2    
3 root 1.2 libptytty - OS independent and secure pty/tty and utmp/wtmp/lastlog handling
4 root 1.1
5     =head1 SYNOPSIS
6    
7 root 1.2 -lptytty
8 root 1.1
9     =head1 DESCRIPTION
10    
11 root 1.4 =head1 SECURITY CONSIDERATIONS
12 root 1.3
13 root 1.4 I<< B<It is of paramount importance that you at least read thw following
14     paragraph!> >>
15    
16     If you are a typical terminal-like program that just wants one or more
17     ptys, you should call the C<ptytty::init ()> method as the very first
18     thing in your program:
19    
20     int main (int argc, char *argv[])
21     {
22     // do nothing here
23     ptytty::init ();
24    
25     // initialise, parse arguments, etc.
26     }
27    
28     This checks wether the program runs setuid or setgid. If yes then it will
29     fork a helper process and drop privileges.
30    
31     Some programs need finer control over if and when this helper process is
32     started, and if and how to drop privileges.
33    
34     etc.. etc..
35 root 1.3
36 root 1.2 =head1 THE ptytty CLASS
37 root 1.1
38     =over 4
39    
40 root 1.2 =item new ptytty
41 root 1.1
42     ...
43    
44     =back
45    
46     =head1 BUGS
47    
48     You kiddin'?
49    
50     =head1 AUTHORS
51    
52     Emanuele Giaquinta L<< <e.giaquinta@glauco.it> >>, Marc Alexander Lehmann
53     L<< <rxvt-unicode@schmorp.de> >>.