/* $Id: tar.h 34179 2010-11-18 15:49:17Z vboxsync $ */ /** @file * IPRT - TAR Virtual Filesystem. */ /* * Copyright (C) 2010 Oracle Corporation * * This file is part of VirtualBox Open Source Edition (OSE), as * available from http://www.virtualbox.org. This file is free software; * you can redistribute it and/or modify it under the terms of the GNU * General Public License (GPL) as published by the Free Software * Foundation, in version 2 as it comes in the "COPYING" file of the * VirtualBox OSE distribution. VirtualBox OSE is distributed in the * hope that it will be useful, but WITHOUT ANY WARRANTY of any kind. * * The contents of this file may alternatively be used under the terms * of the Common Development and Distribution License Version 1.0 * (CDDL) only, as it comes in the "COPYING.CDDL" file of the * VirtualBox OSE distribution, in which case the provisions of the * CDDL are applicable instead of those of the GPL. * * You may elect to license modified versions of this file under the * terms and conditions of either the GPL or the CDDL or both. */ #ifndef __common_zip_tar_h #define __common_zip_tar_h #include /** @name RTZIPTARHDRPOSIX::typeflag * @{ */ #define RTZIPTAR_TF_OLDNORMAL '\0' /**< Normal disk file, Unix compatible */ #define RTZIPTAR_TF_NORMAL '0' /**< Normal disk file */ #define RTZIPTAR_TF_LINK '1' /**< Link to previously dumped file */ #define RTZIPTAR_TF_SYMLINK '2' /**< Symbolic link */ #define RTZIPTAR_TF_CHR '3' /**< Character special file */ #define RTZIPTAR_TF_BLK '4' /**< Block special file */ #define RTZIPTAR_TF_DIR '5' /**< Directory */ #define RTZIPTAR_TF_FIFO '6' /**< FIFO special file */ #define RTZIPTAR_TF_CONTIG '7' /**< Contiguous file */ #define RTZIPTAR_TF_X_HDR 'x' /**< Extended header. */ #define RTZIPTAR_TF_X_GLOBAL 'g' /**< Global extended header. */ #define RTZIPTAR_TF_SOLARIS_XHDR 'X' #define RTZIPTAR_TF_GNU_DUMPDIR 'D' #define RTZIPTAR_TF_GNU_LONGLINK 'K' /**< GNU long link header. */ #define RTZIPTAR_TF_GNU_LONGNAME 'L' /**< GNU long name header. */ #define RTZIPTAR_TF_GNU_MULTIVOL 'M' #define RTZIPTAR_TF_GNU_SPARSE 'S' #define RTZIPTAR_TF_GNU_VOLDHR 'V' /** @} */ /** * The ancient tar header. * * The posix and gnu headers are compatible with the members up to and including * link name, from there on they differ. */ typedef struct RTZIPTARHDRANCIENT { char name[100]; char mode[8]; char uid[8]; char gid[8]; char size[12]; char mtime[12]; char chksum[8]; char typeflag; char linkname[100]; /**< Was called linkflag. */ char unused[8+64+16+155+12]; } RTZIPTARHDRANCIENT; AssertCompileSize(RTZIPTARHDRANCIENT, 512); AssertCompileMemberOffset(RTZIPTARHDRANCIENT, name, 0); AssertCompileMemberOffset(RTZIPTARHDRANCIENT, mode, 100); AssertCompileMemberOffset(RTZIPTARHDRANCIENT, uid, 108); AssertCompileMemberOffset(RTZIPTARHDRANCIENT, gid, 116); AssertCompileMemberOffset(RTZIPTARHDRANCIENT, size, 124); AssertCompileMemberOffset(RTZIPTARHDRANCIENT, mtime, 136); AssertCompileMemberOffset(RTZIPTARHDRANCIENT, chksum, 148); AssertCompileMemberOffset(RTZIPTARHDRANCIENT, typeflag, 156); AssertCompileMemberOffset(RTZIPTARHDRANCIENT, linkname, 157); AssertCompileMemberOffset(RTZIPTARHDRANCIENT, unused, 257); /** The uniform standard tape archive format magic value. */ #define RTZIPTAR_USTAR_MAGIC "ustar" /** The ustar version string. * @remarks The terminator character is not part of the field. */ #define RTZIPTAR_USTAR_VERSION "00" /** * The posix header (according to SuS). */ typedef struct RTZIPTARHDRPOSIX { char name[100]; char mode[8]; char uid[8]; char gid[8]; char size[12]; char mtime[12]; char chksum[8]; char typeflag; char linkname[100]; char magic[6]; char version[2]; char uname[32]; char gname[32]; char devmajor[8]; char devminor[8]; char prefix[155]; char unused[12]; } RTZIPTARHDRPOSIX; AssertCompileSize(RTZIPTARHDRPOSIX, 512); AssertCompileMemberOffset(RTZIPTARHDRPOSIX, name, 0); AssertCompileMemberOffset(RTZIPTARHDRPOSIX, mode, 100); AssertCompileMemberOffset(RTZIPTARHDRPOSIX, uid, 108); AssertCompileMemberOffset(RTZIPTARHDRPOSIX, gid, 116); AssertCompileMemberOffset(RTZIPTARHDRPOSIX, size, 124); AssertCompileMemberOffset(RTZIPTARHDRPOSIX, mtime, 136); AssertCompileMemberOffset(RTZIPTARHDRPOSIX, chksum, 148); AssertCompileMemberOffset(RTZIPTARHDRPOSIX, typeflag, 156); AssertCompileMemberOffset(RTZIPTARHDRPOSIX, linkname, 157); AssertCompileMemberOffset(RTZIPTARHDRPOSIX, magic, 257); AssertCompileMemberOffset(RTZIPTARHDRPOSIX, version, 263); AssertCompileMemberOffset(RTZIPTARHDRPOSIX, uname, 265); AssertCompileMemberOffset(RTZIPTARHDRPOSIX, gname, 297); AssertCompileMemberOffset(RTZIPTARHDRPOSIX, devmajor, 329); AssertCompileMemberOffset(RTZIPTARHDRPOSIX, devminor, 337); AssertCompileMemberOffset(RTZIPTARHDRPOSIX, prefix, 345); /** * The GNU header. */ typedef struct RTZIPTARHDRGNU { char name[100]; char mode[8]; char uid[8]; char gid[8]; char size[12]; char mtime[12]; char chksum[8]; char typeflag; char linkname[100]; char magic[8]; char uname[32]; char gname[32]; char devmajor[8]; char devminor[8]; char atime[12]; char ctime[12]; char offset[12]; char longnames[4]; char unused[1]; struct { char offset[12]; char numbytes[12]; } sparse[4]; char isextended; char realsize[12]; char unused2[17]; } RTZIPTARHDRGNU; AssertCompileSize(RTZIPTARHDRGNU, 512); AssertCompileMemberOffset(RTZIPTARHDRGNU, name, 0); AssertCompileMemberOffset(RTZIPTARHDRGNU, mode, 100); AssertCompileMemberOffset(RTZIPTARHDRGNU, uid, 108); AssertCompileMemberOffset(RTZIPTARHDRGNU, gid, 116); AssertCompileMemberOffset(RTZIPTARHDRGNU, size, 124); AssertCompileMemberOffset(RTZIPTARHDRGNU, mtime, 136); AssertCompileMemberOffset(RTZIPTARHDRGNU, chksum, 148); AssertCompileMemberOffset(RTZIPTARHDRGNU, typeflag, 156); AssertCompileMemberOffset(RTZIPTARHDRGNU, linkname, 157); AssertCompileMemberOffset(RTZIPTARHDRGNU, magic, 257); AssertCompileMemberOffset(RTZIPTARHDRGNU, uname, 265); AssertCompileMemberOffset(RTZIPTARHDRGNU, gname, 297); AssertCompileMemberOffset(RTZIPTARHDRGNU, devmajor, 329); AssertCompileMemberOffset(RTZIPTARHDRGNU, devminor, 337); AssertCompileMemberOffset(RTZIPTARHDRGNU, atime, 345); AssertCompileMemberOffset(RTZIPTARHDRGNU, ctime, 357); AssertCompileMemberOffset(RTZIPTARHDRGNU, offset, 369); AssertCompileMemberOffset(RTZIPTARHDRGNU, longnames, 381); AssertCompileMemberOffset(RTZIPTARHDRGNU, unused, 385); AssertCompileMemberOffset(RTZIPTARHDRGNU, sparse, 386); AssertCompileMemberOffset(RTZIPTARHDRGNU, isextended,482); AssertCompileMemberOffset(RTZIPTARHDRGNU, realsize, 483); AssertCompileMemberOffset(RTZIPTARHDRGNU, unused2, 495); /** * The bits common to posix and GNU. */ typedef struct RTZIPTARHDRCOMMON { char name[100]; char mode[8]; char uid[8]; char gid[8]; char size[12]; char mtime[12]; char chksum[8]; char typeflag; char linkname[100]; char magic[6]; char version[2]; char uname[32]; char gname[32]; char devmajor[8]; char devminor[8]; char not_common[155+12]; } RTZIPTARHDRCOMMON; /** * Tar header union. */ typedef union RTZIPTARHDR { /** Byte view. */ char ab[512]; /** The standard header. */ RTZIPTARHDRANCIENT Ancient; /** The standard header. */ RTZIPTARHDRPOSIX Posix; /** The GNU header. */ RTZIPTARHDRGNU Gnu; /** The bits common to both GNU and the standard header. */ RTZIPTARHDRCOMMON Common; } RTZIPTARHDR; AssertCompileSize(RTZIPTARHDR, 512); /** Pointer to a tar file header. */ typedef RTZIPTARHDR *PRTZIPTARHDR; /** Pointer to a const tar file header. */ typedef RTZIPTARHDR const *PCRTZIPTARHDR; /** * Tar header type. */ typedef enum RTZIPTARTYPE { /** Invalid type value. */ RTZIPTARTYPE_INVALID = 0, /** Posix header. */ RTZIPTARTYPE_POSIX, /** The old GNU header, has layout conflicting with posix. */ RTZIPTARTYPE_GNU, /** Ancient tar header which does not use anything beyond the magic. */ RTZIPTARTYPE_ANCIENT, /** End of the valid type values (this is not valid). */ RTZIPTARTYPE_END, /** The usual type blow up. */ RTZIPTARTYPE_32BIT_HACK = 0x7fffffff } RTZIPTARTYPE; typedef RTZIPTARTYPE *PRTZIPTARTYPE; #endif