Commit da542e1b authored by Richard Levitte's avatar Richard Levitte
Browse files

Move text that isn't really descriptions of the functions in the page 

to the NOTES section, and add references to the functions mentioned
(and perhaps a few more).
parent 93fe6e13

doc/crypto/BIO_s_fd.pod

+14 −15
Original line number Diff line number Diff line
@@ -20,15 +20,6 @@ BIO_s_fd, BIO_set_fd, BIO_get_fd, BIO_new_fd - file descriptor BIO 
BIO_s_fd() returns the file descriptor BIO method. This is a wrapper

round the platforms file descriptor routines such as read() and write().



BIO_read() and BIO_write() read or write the underlying descriptor.

BIO_puts() is supported but BIO_gets() is not.



If the close flag is set then then close() is called on the underlying

file descriptor when the BIO is freed.



BIO_reset() attempts to change the file pointer to the start of file

using lseek(fd, 0, 0).



BIO_set_fd() sets the file descriptor of BIO B<b> to B<fd> and the close

flag to B<c>.
@@ -40,6 +31,15 @@ BIO_new_fd() returns a file descriptor BIO using B<fd> and B<close_flag>. 


=head1 NOTES



If the close flag is set then then close() is called on the underlying

file descriptor when the BIO is freed.



BIO_reset() attempts to change the file pointer to the start of file

using lseek(fd, 0, 0).



BIO_read() and BIO_write() read or write the underlying descriptor.

BIO_puts() is supported but BIO_gets() is not.



The behaviour of BIO_read() and BIO_write() depends on the behavior of the

platforms read() and write() calls on the descriptor. If the underlying 

file descriptor is in a non blocking mode then the BIO will behave in the
@@ -53,11 +53,6 @@ instead. 


BIO_s_fd() returns the file descriptor BIO method.



BIO_reset() returns zero for success and -1 if an error occurred.

BIO_seek() and BIO_tell() return the current file position or -1

is an error occurred. These values reflect the underlying lseek()

behaviour.



BIO_set_fd() always returns 1.



BIO_get_fd() returns the file descriptor or -1 if the BIO has not
@@ -77,4 +72,8 @@ This is a file descriptor BIO version of "Hello World": 


=head1 SEE ALSO



L<BIO_seek(3)|BIO_seek(3)>, L<BIO_tell(3)|BIO_tell(3)>, TBA
 
L<BIO_seek(3)|BIO_seek(3)>, L<BIO_tell(3)|BIO_tell(3)>,

L<BIO_reset(3)|BIO_reset(3)>, L<BIO_read(3)|BIO_read(3)>,

L<BIO_write(3)|BIO_write(3)>, L<BIO_puts(3)|BIO_puts(3)>,

L<BIO_gets(3)|BIO_gets(3)>, L<BIO_printf(3)|BIO_printf(3)>,

L<BIO_set_close(3)|BIO_set_close(3)>, L<BIO_get_close(3)|BIO_get_close(3)>

doc/crypto/BIO_s_file.pod

+20 −15
Original line number Diff line number Diff line
@@ -28,20 +28,6 @@ BIO_s_file() returns the BIO file method. As its name implies it 
is a wrapper round the stdio FILE structure and it is a

source/sink BIO.



Calls to BIO_read() and BIO_write() read and write data to the

underlying stream. BIO_gets() and BIO_puts() are supported on file BIOs.



BIO_flush() on a file BIO calls the fflush() function on the wrapped

stream.



BIO_reset() on a file BIO calls fseek() to reset the position indicator

to the start of the file.



BIO_eof() calls feof().



Setting the BIO_CLOSE flag calls fclose() on the stream when the BIO

is freed.



BIO_new_file() creates a new file BIO with mode B<mode> the meaning

of B<mode> is the same as the stdio function fopen(). The BIO_CLOSE

flag is set on the returned BIO.
@@ -62,6 +48,20 @@ reading, writing, append or read write respectively. 


=head1 NOTES



Calls to BIO_read() and BIO_write() read and write data to the

underlying stream. BIO_gets() and BIO_puts() are supported on file BIOs.



BIO_flush() on a file BIO calls the fflush() function on the wrapped

stream.



BIO_reset() on a file BIO calls fseek() to reset the position indicator

to the start of the file.



BIO_eof() calls feof().



Setting the BIO_CLOSE flag calls fclose() on the stream when the BIO

is freed.



When wrapping stdout, stdin or stderr the underlying stream should not

normally be closed so the BIO_NOCLOSE flag should be set.
@@ -116,4 +116,9 @@ BIO_rw_filename() return 1 for success or 0 for failure. 


=head1 SEE ALSO



L<BIO_seek(3)|BIO_seek(3)>, L<BIO_tell(3)|BIO_tell(3)>, TBA
 
L<BIO_seek(3)|BIO_seek(3)>, L<BIO_tell(3)|BIO_tell(3)>,

L<BIO_reset(3)|BIO_reset(3)>, L<BIO_flush(3)|BIO_flush(3)>,

L<BIO_read(3)|BIO_read(3)>,

L<BIO_write(3)|BIO_write(3)>, L<BIO_puts(3)|BIO_puts(3)>,

L<BIO_gets(3)|BIO_gets(3)>, L<BIO_printf(3)|BIO_printf(3)>,

L<BIO_set_close(3)|BIO_set_close(3)>, L<BIO_get_close(3)|BIO_get_close(3)>