xref: /freebsd/crypto/openssl/doc/man3/SSL_get_fd.pod (revision e0c4386e7e71d93b0edc0c8fa156263fc4a8b0b6)
1=pod
2
3=head1 NAME
4
5SSL_get_fd, SSL_get_rfd, SSL_get_wfd - get file descriptor linked to an SSL object
6
7=head1 SYNOPSIS
8
9 #include <openssl/ssl.h>
10
11 int SSL_get_fd(const SSL *ssl);
12 int SSL_get_rfd(const SSL *ssl);
13 int SSL_get_wfd(const SSL *ssl);
14
15=head1 DESCRIPTION
16
17SSL_get_fd() returns the file descriptor which is linked to B<ssl>.
18SSL_get_rfd() and SSL_get_wfd() return the file descriptors for the
19read or the write channel, which can be different. If the read and the
20write channel are different, SSL_get_fd() will return the file descriptor
21of the read channel.
22
23=head1 RETURN VALUES
24
25The following return values can occur:
26
27=over 4
28
29=item -1
30
31The operation failed, because the underlying BIO is not of the correct type
32(suitable for file descriptors).
33
34=item E<gt>=0
35
36The file descriptor linked to B<ssl>.
37
38=back
39
40=head1 SEE ALSO
41
42L<SSL_set_fd(3)>, L<ssl(7)> , L<bio(7)>
43
44=head1 COPYRIGHT
45
46Copyright 2000-2016 The OpenSSL Project Authors. All Rights Reserved.
47
48Licensed under the Apache License 2.0 (the "License").  You may not use
49this file except in compliance with the License.  You can obtain a copy
50in the file LICENSE in the source distribution or at
51L<https://www.openssl.org/source/license.html>.
52
53=cut
54