| 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 |
ayin |
1.5 |
I<< B<It is of paramount importance that you at least read the following |
| 14 |
root |
1.4 |
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> >>. |