crypto/openssl-0.9.7d/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