BIO_free man page on MirBSD

Man page or keyword search:  
man Server   6113 pages
apropos Keyword Search (all sections)
Output format
MirBSD logo
[printable version]



BIO_NEW(3)		     OpenSSL		       BIO_NEW(3)

NAME
     BIO_new, BIO_set, BIO_free, BIO_vfree, BIO_free_all - BIO
     allocation and freeing functions

SYNOPSIS
      #include <openssl/bio.h>

      BIO *  BIO_new(BIO_METHOD *type);
      int    BIO_set(BIO *a,BIO_METHOD *type);
      int    BIO_free(BIO *a);
      void   BIO_vfree(BIO *a);
      void   BIO_free_all(BIO *a);

DESCRIPTION
     The BIO_new() function returns a new BIO using method type.

     BIO_set() sets the method of an already existing BIO.

     BIO_free() frees up a single BIO, BIO_vfree() also frees up
     a single BIO but it does not return a value. Calling
     BIO_free() may also have some effect on the underlying I/O
     structure, for example it may close the file being referred
     to under certain circumstances. For more details see the
     individual BIO_METHOD descriptions.

     BIO_free_all() frees up an entire BIO chain, it does not
     halt if an error occurs freeing up an individual BIO in the
     chain.

RETURN VALUES
     BIO_new() returns a newly created BIO or NULL if the call
     fails.

     BIO_set(), BIO_free() return 1 for success and 0 for
     failure.

     BIO_free_all() and BIO_vfree() do not return values.

NOTES
     Some BIOs (such as memory BIOs) can be used immediately
     after calling BIO_new(). Others (such as file BIOs) need
     some additional initialization, and frequently a utility
     function exists to create and initialize such BIOs.

     If BIO_free() is called on a BIO chain it will only free one
     BIO resulting in a memory leak.

     Calling BIO_free_all() a single BIO has the same effect as
     calling BIO_free() on it other than the discarded return
     value.

MirOS BSD #10-current	   2005-02-05				1

BIO_NEW(3)		     OpenSSL		       BIO_NEW(3)

     Normally the type argument is supplied by a function which
     returns a pointer to a BIO_METHOD. There is a naming conven-
     tion for such functions: a source/sink BIO is normally
     called BIO_s_*() and a filter BIO BIO_f_*();

EXAMPLE
     Create a memory BIO:

      BIO *mem = BIO_new(BIO_s_mem());

SEE ALSO
     TBA

MirOS BSD #10-current	   2005-02-05				2

[top]

List of man pages available for MirBSD

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net