Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   22533 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

ZIP_FILE_GET_EXTERNAL_ATTRILibrary)FunctionZIP_FILE_GET_EXTERNAL_ATTRIBUTES(3)

NAME
       zip_file_get_external_attributes - get external attributes for file in
       zip

LIBRARY
       libzip (-lzip)

SYNOPSIS
       #include <zip.h>

       const char *
       zip_file_get_external_attributes(struct zip *archive, zip_uint64_t
       index, zip_flags_t flags, zip_uint8_t *opsys, zip_uint32_t
       *attributes);

DESCRIPTION
       The zip_file_get_external_attributes() function returns the operating
       system and external attributes for the file at position index in the
       zip archive.  The external attributes usually contain the operating
       system-specific file permissions.  If flags is set to ZIP_FL_UNCHANGED,
       the original unchanged values are returned.  If opsys or attributes are
       NULL, they are not filled in.

       The following operating systems are defined by the zip specification:
	     ZIP_OPSYS_ACORN_RISC
	     ZIP_OPSYS_ALTERNATE_MVS
	     ZIP_OPSYS_AMIGA
	     ZIP_OPSYS_ATARI_ST
	     ZIP_OPSYS_BEOS
	     ZIP_OPSYS_CPM
	     ZIP_OPSYS_DOS
	     ZIP_OPSYS_MACINTOSH
	     ZIP_OPSYS_MVS
	     ZIP_OPSYS_OPENVMS
	     ZIP_OPSYS_OS_2
	     ZIP_OPSYS_OS_400
	     ZIP_OPSYS_OS_X
	     ZIP_OPSYS_TANDEM
	     ZIP_OPSYS_UNIX
	     ZIP_OPSYS_VFAT
	     ZIP_OPSYS_VM_CMS
	     ZIP_OPSYS_VSE
	     ZIP_OPSYS_WINDOWS_NTFS (uncommon, use ZIP_OPSYS_DOS instead)
	     ZIP_OPSYS_Z_SYSTEM

       The defines above follow the PKWARE Inc. Appnote; please note that the
       InfoZIP Appnote has a slightly different mapping.

RETURN VALUES
       Upon successful completion, 0 is returned.  In case of an error, -1 is
       returned and the error code in archive is set to indicate the error.

ERRORS
       zip_file_get_external_attributes() fails if:

       [ZIP_ER_INVAL]	  index is not a valid file index in archive.

SEE ALSO
       libzip(3), zip_file_set_external_attributes(3)

EXAMPLES
       The following code can be used to expand attributes if the operating
       system is ZIP_OPSYS_DOS.

       #include <sys/stat.h>

       #define FA_RDONLY       0x01	       // FILE_ATTRIBUTE_READONLY
       #define FA_DIREC	       0x10	       // FILE_ATTRIBUTE_DIRECTORY

       static mode_t
       _zip_dos_attr2mode(zip_uint32_t attr)
       {
	  mode_t m = S_IRUSR | S_IRGRP | S_IROTH;
	  if (0 == (attr & FA_RDONLY))
	     m |= S_IWUSR | S_IWGRP | S_IWOTH;

	  if (attr & FA_DIREC)
	     m = (S_IFDIR | (m & ~S_IFMT)) | S_IXUSR | S_IXGRP | S_IXOTH;

	  return m;
       }

AUTHORS
       Dieter Baron <dillo@nih.at> and Thomas Klausner <tk@giga.or.at>

NiH			      September 19,ZIP_FILE_GET_EXTERNAL_ATTRIBUTES(3)

Vote for polarhome