FreeBSD Manual Pages
Tclzipfs(3) Tcl Library Procedures Tclzipfs(3) ______________________________________________________________________________ NAME TclZipfs_AppHook, Tclzipfs_Mount, TclZipfs_MountBuffer, Tclzipfs_Un- mount - handle ZIP files as Tcl virtual filesystems SYNOPSIS int TclZipfs_AppHook(argcPtr, argvPtr) int Tclzipfs_Mount(interp, mountpoint, zipname, password) int TclZipfs_MountBuffer(interp, mountpoint, data, dataLen, copy) int Tclzipfs_Unmount(interp, mountpoint) ARGUMENTS int *argcPtr (in) Pointer to a variable holding the number of command line arguments from main(). char ***argvPtr (in) Pointer to an array of strings containing the command line argu- ments to main(). Tcl_Interp *interp (in) Interpreter in which the ZIP file system is mounted. The inter- preter's result is modified to hold the result or error message from the script. const char *zipname (in) Name of a ZIP file. Must not be NULL when either mounting or un- mounting a ZIP. const char *mountpoint (in) Name of a mount point, which must be a legal Tcl file or directory name. May be NULL to query current mount points. const char *password (in) An (optional) password. Use NULL if no password is wanted to read the file. unsigned char *data (in) A data buffer to mount. The data buffer must hold the contents of a ZIP archive, and must not be NULL. size_t dataLen (in) The number of bytes in the sup- plied data buffer argument, data. int copy (in) If non-zero, the ZIP archive in the data buffer will be internally copied before mounting, allowing the data buffer to be disposed once TclZipfs_MountBuffer returns. If zero, the caller guarantees that the buffer will be valid to read from for the duration of the mount. ______________________________________________________________________________ DESCRIPTION TclZipfs_AppHook is a utility function to perform standard application initialization procedures, taking into account available ZIP archives as follows: [1] If the current application has a mountable ZIP archive, that ar- chive is mounted under ZIPFS_VOLUME/app as a read-only Tcl vir- tual file system. ZIPFS_VOLUME is usually //zipfs: on all plat- forms, but zipfs: may also be used on Windows (due to differ- ences in the platform's filename parsing). [2] If a file named main.tcl is located in the root directory of that file system (i.e., at ZIPROOT/app/main.tcl after the ZIP archive is mounted as described above) it is treated as the startup script for the process. [3] If the file ZIPROOT/app/tcl_library/init.tcl is present, the tcl_library global variable in the initial Tcl interpreter is set to ZIPROOT/app/tcl_library. [4] If the directory tcl_library was not found in the main applica- tion mount, the system will then search for it as either a VFS attached to the application dynamic library, or as a zip archive named libtcl_major_minor_patchlevel.zip either in the present working directory or in the standard Tcl install location. (For example, the Tcl 8.7.2 release would be searched for in a file libtcl_8_7_2.zip.) That archive, if located, is also mounted read-only. On Windows, TclZipfs_AppHook has a slightly different signature, since it uses WCHAR in stead of char. As a result, it requires your applica- tion to be compiled with the UNICODE preprocessor symbol defined (e.g., via the -DUNICODE compiler flag). The result of TclZipfs_AppHook is a Tcl result code (e.g., TCL_OK when the function is successful). The function may modify the variables pointed to by argcPtr and argvPtr to remove arguments; the current im- plementation does not do so, but callers should not assume that this will be true in the future. Tclzipfs_Mount mounts the ZIP archive zipname on the mount point given in mountpoint using the optional ZIP password password. Errors during that process are reported in the interpreter interp. If mountpoint is a NULL pointer, information on all currently mounted ZIP file systems is written into interp's result as a sequence of mount points and ZIP file names. The result of this call is a standard Tcl result code. Tclzipfs_MountBuffer mounts the ZIP archive in the buffer pointed to by data on the mount point given in mountpoint. The ZIP archive is assumed to be not password protected. Errors during that process are reported in the interpreter interp. The copy argument determines whether the buffer is internally copied before mounting or not. The result of this call is a standard Tcl result code. Tclzipfs_Unmount undoes the effect of Tclzipfs_Mount, i.e., it unmounts the mounted ZIP file system that was mounted from zipname (at mount- point). Errors are reported in the interpreter interp. The result of this call is a standard Tcl result code. TclZipfs_AppHook can not be used in stub-enabled extensions. SEE ALSO zipfs(n) KEYWORDS compress, filesystem, zip Tcl 8.7 Tclzipfs(3)
NAME | SYNOPSIS | ARGUMENTS | DESCRIPTION | SEE ALSO | KEYWORDS
Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=TclZipfs_AppHook.tcl87&sektion=3&manpath=FreeBSD+12.2-RELEASE+and+Ports>