New manual page for a hardly known but important item :-)
[openssl.git] / doc / ssl / SSL_get_fd.pod
1 =pod
2
3 =head1 NAME
4
5 SSL_get_fd - get file descriptor linked to an SSL object
6
7 =head1 SYNOPSIS
8
9  #include <openssl/ssl.h>
10
11  int SSL_get_fd(SSL *ssl);
12  int SSL_get_rfd(SSL *ssl);
13  int SSL_get_wfd(SSL *ssl);
14
15 =head1 DESCRIPTION
16
17 SSL_get_fd() returns the file descriptor which is linked to B<ssl>.
18 SSL_get_rfd() and SSL_get_wfd() return the file descriptors for the
19 read or the write channel, which can be different. If the read and the
20 write channel are different, SSL_get_fd() will return the file descriptor
21 of the read channel.
22
23 =head1 RETURN VALUES
24
25 The following return values can occur:
26
27 =over 4
28
29 =item -1
30
31 The operation failed, because the underlying BIO is not of the correct type
32 (suitable for file descriptors).
33
34 =item E<gt>=0
35
36 The file descriptor linked to B<ssl>.
37
38 =back
39
40 =head1 SEE ALSO
41
42 L<SSL_set_fd(3)|SSL_set_fd(3)>, L<ssl(3)|ssl(3)> , L<bio(3)|bio(3)>
43
44 =cut