Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
ZZIP_OPEN(3)		     zziplib Function List		  ZZIP_OPEN(3)

NAME
       zzip_open, zzip_open_ext_io, zzip_open_shared_io	- ...

SYNOPSIS
       #include	<zzip/lib.h>

       ZZIP_FILE * zzip_open((zzip_char_t * filename, int o_flags));

       ZZIP_FILE *
				    zzip_open_ext_io((zzip_char_t * filename, int o_flags, int o_modes,	zzip_strings_t * ext, zzip_plugin_io_t io));

       ZZIP_FILE *
				       zzip_open_shared_io((ZZIP_FILE *	stream,	zzip_char_t * filename,	int o_flags, int o_modes, zzip_strings_t * ext,	zzip_plugin_io_t io));

DESCRIPTION
       The zzip_open_ext_io function uses explicit ext and io instead of the
       internal	defaults, setting them to zero is equivalent to	zzip_open

       note that the two flag types have been split into an o_flags (for
       fcntl-like openflags) and o_modes where the latter shall	carry the
       zzip_flags and possibly accessmodes for unix filesystems. Since this
       version of zziplib can not write	zipfiles, it is	not yet	used for
       anything	else than zzip-specific	modeflags.

       The zzip_open_ext_io function returns a new zzip-handle (use zzip_close
       to return it). On error the zzip_open_ext_io function will return null
       setting errno(3).

       If any ext_io handlers were used	then the referenced structure should
       be static as the	allocated ZZIP_FILE does not copy them.

       The zzip_open_shared_io function	takes an extra stream argument - if a
       handle has been then ext/io can be left null and	the new	stream handle
       will pick up the	ext/io.	This should be used only in specific
       environment however since zzip_file_real	does not store any
       ext-sequence.

       The benefit for the zzip_open_shared_io function	comes in when the old
       file handle was openened	from a file within a zip archive. When the new
       file is in the same zip archive then the	internal zzip_dir structures
       will be shared. It is even quicker, as no check needs to	be done
       anymore trying to guess the zip archive place in	the filesystem,	here
       we just check whether the zip archive's filepath	is a prefix part of
       the filename to be opened.

       Note that the zzip_open_shared_io function is also used by zzip_freopen
       that will unshare the old handle, thereby possibly closing the handle.

       The zzip_open_shared_io function	returns	a new zzip-handle (use
       zzip_close to return it). On error the zzip_open_shared_io function
       will return null	setting	errno(3).

AUTHOR
       o   Guido Draheim <guidod@gmx.de> Tomi Ollila <Tomi.Ollila@iki.fi>

COPYRIGHT
       Copyright (c) 1999,2000,2001,2002,2003 Guido Draheim All	rights
       reserved, use under the restrictions of the Lesser GNU General Public
       License or alternatively	the restrictions of the	Mozilla	Public License
       1.1

zziplib				    0.13.62			  ZZIP_OPEN(3)

NAME | SYNOPSIS | DESCRIPTION | AUTHOR | COPYRIGHT

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=zzip_open&sektion=3&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help