mirror/openssl
2
0
Fork 0
mirror of https://github.com/openssl/openssl.git synced 2024-12-27 06:21:43 +08:00
Code Issues Packages Projects Releases Wiki Activity
2da163cb73
openssl/doc/man3/BIO_s_fd.pod

99 lines
2.7 KiB
Plaintext
Raw Normal View History

BIO_s_fd() manual page.
2000-09-14 01:27:42 +08:00
=pod
=head1 NAME
BIO_seed() and BIO_tell() were documented in two other documents, which is redundant. They are now in their own document. Also, in the name section, all the functions described shoud be enumerated. This will also make it much simpler to generate softlinks name like each function to man-pages containing the info.
2000-09-15 04:24:56 +08:00
BIO_s_fd, BIO_set_fd, BIO_get_fd, BIO_new_fd - file descriptor BIO
BIO_s_fd() manual page.
2000-09-14 01:27:42 +08:00
=head1 SYNOPSIS
#include <openssl/bio.h>
Replace all #define's in pod pages. Function-like macros are replaced with prototypes and a note that they are implemented as macros. Constants are just referenced in-line in the text. Tweak BIO_TYPE_... documentation. Also fix RT4592. Reviewed-by: Matt Caswell <matt@openssl.org>
2016-07-09 00:55:45 +08:00
const BIO_METHOD *BIO_s_fd(void);
BIO_s_fd() manual page.
2000-09-14 01:27:42 +08:00
Replace all #define's in pod pages. Function-like macros are replaced with prototypes and a note that they are implemented as macros. Constants are just referenced in-line in the text. Tweak BIO_TYPE_... documentation. Also fix RT4592. Reviewed-by: Matt Caswell <matt@openssl.org>
2016-07-09 00:55:45 +08:00
int BIO_set_fd(BIO *b, int fd, int c);
int BIO_get_fd(BIO *b, int *c);
BIO_s_fd() manual page.
2000-09-14 01:27:42 +08:00
BIO *BIO_new_fd(int fd, int close_flag);
=head1 DESCRIPTION
Initial connect BIO docs.
2000-09-14 20:44:34 +08:00
BIO_s_fd() returns the file descriptor BIO method. This is a wrapper
BIO_s_fd() manual page.
2000-09-14 01:27:42 +08:00
round the platforms file descriptor routines such as read() and write().
Document the new BIO functions introduced as part of the size_t work Reviewed-by: Richard Levitte <levitte@openssl.org>
2016-10-20 16:56:18 +08:00
BIO_read_ex() and BIO_write_ex() read or write the underlying descriptor.
Restore the descriptions to conform with the rest of the documentation. We'll work on better documents after the release of 0.9.6.
2000-09-18 03:20:17 +08:00
BIO_puts() is supported but BIO_gets() is not.
Correct another batch of typos Reviewed-by: Kurt Roeckx <kurt@openssl.org> Reviewed-by: Rich Salz <rsalz@openssl.org>
2016-03-20 23:51:06 +08:00
If the close flag is set then close() is called on the underlying
Restore the descriptions to conform with the rest of the documentation. We'll work on better documents after the release of 0.9.6.
2000-09-18 03:20:17 +08:00
file descriptor when the BIO is freed.
BIO_reset() attempts to change the file pointer to the start of file
Replace all #define's in pod pages. Function-like macros are replaced with prototypes and a note that they are implemented as macros. Constants are just referenced in-line in the text. Tweak BIO_TYPE_... documentation. Also fix RT4592. Reviewed-by: Matt Caswell <matt@openssl.org>
2016-07-09 00:55:45 +08:00
such as by using B<lseek(fd, 0, 0)>.
Restore the descriptions to conform with the rest of the documentation. We'll work on better documents after the release of 0.9.6.
2000-09-18 03:20:17 +08:00
BIO_seek() sets the file pointer to position B<ofs> from start of file
Replace all #define's in pod pages. Function-like macros are replaced with prototypes and a note that they are implemented as macros. Constants are just referenced in-line in the text. Tweak BIO_TYPE_... documentation. Also fix RT4592. Reviewed-by: Matt Caswell <matt@openssl.org>
2016-07-09 00:55:45 +08:00
such as by using B<lseek(fd, ofs, 0)>.
Restore the descriptions to conform with the rest of the documentation. We'll work on better documents after the release of 0.9.6.
2000-09-18 03:20:17 +08:00
Replace all #define's in pod pages. Function-like macros are replaced with prototypes and a note that they are implemented as macros. Constants are just referenced in-line in the text. Tweak BIO_TYPE_... documentation. Also fix RT4592. Reviewed-by: Matt Caswell <matt@openssl.org>
2016-07-09 00:55:45 +08:00
BIO_tell() returns the current file position such as by calling
B<lseek(fd, 0, 1)>.
Restore the descriptions to conform with the rest of the documentation. We'll work on better documents after the release of 0.9.6.
2000-09-18 03:20:17 +08:00
BIO_s_fd() manual page.
2000-09-14 01:27:42 +08:00
BIO_set_fd() sets the file descriptor of BIO B<b> to B<fd> and the close
flag to B<c>.
BIO_s_connect.pod: Improve doc of BIO_set_conn_hostname() etc. Reviewed-by: Paul Dale <pauli@openssl.org> (Merged from https://github.com/openssl/openssl/pull/14967)
2021-04-21 18:47:35 +08:00
BIO_get_fd() places the file descriptor of BIO B<b> in B<c> if it is not NULL.
It also returns the file descriptor.
BIO_s_fd() manual page.
2000-09-14 01:27:42 +08:00
ispell and some other nit-picking
2000-09-16 23:39:28 +08:00
BIO_new_fd() returns a file descriptor BIO using B<fd> and B<close_flag>.
BIO_s_fd() manual page.
2000-09-14 01:27:42 +08:00
=head1 NOTES
Document the new BIO functions introduced as part of the size_t work Reviewed-by: Richard Levitte <levitte@openssl.org>
2016-10-20 16:56:18 +08:00
The behaviour of BIO_read_ex() and BIO_write_ex() depends on the behavior of the
Fix nits in pod files. Add doc-nit-check to help find future issues. Make podchecker be almost clean. Remove trailing whitespace. Tab expansion Reviewed-by: Richard Levitte <levitte@openssl.org>
2016-05-20 20:11:46 +08:00
platforms read() and write() calls on the descriptor. If the underlying
BIO_s_fd() manual page.
2000-09-14 01:27:42 +08:00
file descriptor is in a non blocking mode then the BIO will behave in the
Document the new BIO functions introduced as part of the size_t work Reviewed-by: Richard Levitte <levitte@openssl.org>
2016-10-20 16:56:18 +08:00
manner described in the L<BIO_read_ex(3)> and L<BIO_should_retry(3)>
BIO_s_fd() manual page.
2000-09-14 01:27:42 +08:00
manual pages.
File descriptor BIOs should not be used for socket I/O. Use socket BIOs
instead.
Replace all #define's in pod pages. Function-like macros are replaced with prototypes and a note that they are implemented as macros. Constants are just referenced in-line in the text. Tweak BIO_TYPE_... documentation. Also fix RT4592. Reviewed-by: Matt Caswell <matt@openssl.org>
2016-07-09 00:55:45 +08:00
BIO_set_fd() and BIO_get_fd() are implemented as macros.
BIO_s_fd() manual page.
2000-09-14 01:27:42 +08:00
=head1 RETURN VALUES
BIO_s_fd() returns the file descriptor BIO method.
Fix documentation errors, mainly caused by return values of BIO_ctrl Reviewed-by: Shane Lontis <shane.lontis@oracle.com> Reviewed-by: Tomas Mraz <tomas@openssl.org> (Merged from https://github.com/openssl/openssl/pull/16767)
2021-10-07 11:40:49 +08:00
BIO_set_fd() returns 1 on success or <=0 for failure.
BIO_s_fd() manual page.
2000-09-14 01:27:42 +08:00
BIO_get_fd() returns the file descriptor or -1 if the BIO has not
Fix documentation errors, mainly caused by return values of BIO_ctrl Reviewed-by: Shane Lontis <shane.lontis@oracle.com> Reviewed-by: Tomas Mraz <tomas@openssl.org> (Merged from https://github.com/openssl/openssl/pull/16767)
2021-10-07 11:40:49 +08:00
been initialized. It also returns zero and negative values if other error occurs.
BIO_s_fd() manual page.
2000-09-14 01:27:42 +08:00
BIO_new_fd() returns the newly allocated BIO or NULL is an error
occurred.
Use EXAMPLES not EXAMPLE for section title And update find-doc-nits to complain if "=head1 EXAMPLE" is found. Reviewed-by: Richard Levitte <levitte@openssl.org> Reviewed-by: Matthias St. Pierre <Matthias.St.Pierre@ncp-e.com> (Merged from https://github.com/openssl/openssl/pull/9602)
2019-08-16 02:26:08 +08:00
=head1 EXAMPLES
BIO_s_fd() manual page.
2000-09-14 01:27:42 +08:00
This is a file descriptor BIO version of "Hello World":
BIO *out;
Fix some style issues... extra spacing and 80 cols Reviewed-by: Rich Salz <rsalz@openssl.org> Reviewed-by: Richard Levitte <levitte@openssl.org> (Merged from https://github.com/openssl/openssl/pull/1366)
2016-07-29 03:15:52 +08:00
BIO_s_fd() manual page.
2000-09-14 01:27:42 +08:00
out = BIO_new_fd(fileno(stdout), BIO_NOCLOSE);
BIO_printf(out, "Hello World\n");
BIO_free(out);
=head1 SEE ALSO
Fix L<> content in manpages L<foo|foo> is sub-optimal If the xref is the same as the title, which is what we do, then you only need L<foo>. This fixes all 1457 occurrences in 349 files. Approximately. (And pod used to need both.) Reviewed-by: Richard Levitte <levitte@openssl.org>
2015-08-18 03:21:33 +08:00
L<BIO_seek(3)>, L<BIO_tell(3)>,
Document the new BIO functions introduced as part of the size_t work Reviewed-by: Richard Levitte <levitte@openssl.org>
2016-10-20 16:56:18 +08:00
L<BIO_reset(3)>, L<BIO_read_ex(3)>,
L<BIO_write_ex(3)>, L<BIO_puts(3)>,
Fix L<> content in manpages L<foo|foo> is sub-optimal If the xref is the same as the title, which is what we do, then you only need L<foo>. This fixes all 1457 occurrences in 349 files. Approximately. (And pod used to need both.) Reviewed-by: Richard Levitte <levitte@openssl.org>
2015-08-18 03:21:33 +08:00
L<BIO_gets(3)>, L<BIO_printf(3)>,
L<BIO_set_close(3)>, L<BIO_get_close(3)>
Ensure =cut is last line in every file. Reviewed-by: Richard Levitte <levitte@openssl.org>
2016-05-18 22:16:40 +08:00
Add copyright to manpages Reviewed-by: Richard Levitte <levitte@openssl.org>
2016-05-18 23:44:05 +08:00
=head1 COPYRIGHT
Update copyright year Reviewed-by: Tomas Mraz <tomas@openssl.org> (Merged from https://github.com/openssl/openssl/pull/15181)
2021-05-06 20:03:23 +08:00
Copyright 2000-2021 The OpenSSL Project Authors. All Rights Reserved.
Add copyright to manpages Reviewed-by: Richard Levitte <levitte@openssl.org>
2016-05-18 23:44:05 +08:00
Following the license change, modify the boilerplates in doc/man3/ [skip ci] Reviewed-by: Matt Caswell <matt@openssl.org> (Merged from https://github.com/openssl/openssl/pull/7829)
2018-12-06 21:04:44 +08:00
Licensed under the Apache License 2.0 (the "License"). You may not use
Add copyright to manpages Reviewed-by: Richard Levitte <levitte@openssl.org>
2016-05-18 23:44:05 +08:00
this file except in compliance with the License. You can obtain a copy
in the file LICENSE in the source distribution or at
L<https://www.openssl.org/source/license.html>.
=cut
Reference in New Issue Copy Permalink