1 /* $NetBSD: tar.h,v 1.10 2013/01/24 17:43:44 christos Exp $ */ 2 3 /*- 4 * Copyright (c) 1992 Keith Muller. 5 * Copyright (c) 1992, 1993 6 * The Regents of the University of California. All rights reserved. 7 * 8 * This code is derived from software contributed to Berkeley by 9 * Keith Muller of the University of California, San Diego. 10 * 11 * Redistribution and use in source and binary forms, with or without 12 * modification, are permitted provided that the following conditions 13 * are met: 14 * 1. Redistributions of source code must retain the above copyright 15 * notice, this list of conditions and the following disclaimer. 16 * 2. Redistributions in binary form must reproduce the above copyright 17 * notice, this list of conditions and the following disclaimer in the 18 * documentation and/or other materials provided with the distribution. 19 * 3. Neither the name of the University nor the names of its contributors 20 * may be used to endorse or promote products derived from this software 21 * without specific prior written permission. 22 * 23 * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND 24 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 25 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 26 * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE 27 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 28 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 29 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 30 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 31 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 32 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 33 * SUCH DAMAGE. 34 * 35 * @(#)tar.h 8.2 (Berkeley) 4/18/94 36 */ 37 38 /* 39 * defines and data structures common to all tar formats 40 */ 41 #define CHK_LEN 8 /* length of checksum field */ 42 #define TNMSZ 100 /* size of name field */ 43 #ifdef _PAX_ 44 #define NULLCNT 2 /* number of null blocks in trailer */ 45 #define CHK_OFFSET 148 /* start of chksum field */ 46 #define BLNKSUM 256L /* sum of checksum field using ' ' */ 47 #endif /* _PAX_ */ 48 49 /* 50 * Values used in typeflag field in all tar formats 51 * (only REGTYPE, LNKTYPE and SYMTYPE are used in old bsd tar headers) 52 */ 53 #define REGTYPE '0' /* Regular File */ 54 #define AREGTYPE '\0' /* Regular File */ 55 #define LNKTYPE '1' /* Link */ 56 #define SYMTYPE '2' /* Symlink */ 57 #define CHRTYPE '3' /* Character Special File */ 58 #define BLKTYPE '4' /* Block Special File */ 59 #define DIRTYPE '5' /* Directory */ 60 #define FIFOTYPE '6' /* FIFO */ 61 #define CONTTYPE '7' /* high perf file */ 62 #define GLOBXTYPE 'g' /* global extended header */ 63 #define FILEXTYPE 'x' /* file extended header */ 64 65 /* 66 * GNU tar compatibility; 67 */ 68 #define LONGLINKTYPE 'K' /* Long Symlink */ 69 #define LONGNAMETYPE 'L' /* Long File */ 70 71 /* 72 * Mode field encoding of the different file types - values in octal 73 */ 74 #define TSUID 04000 /* Set UID on execution */ 75 #define TSGID 02000 /* Set GID on execution */ 76 #define TSVTX 01000 /* Reserved */ 77 #define TUREAD 00400 /* Read by owner */ 78 #define TUWRITE 00200 /* Write by owner */ 79 #define TUEXEC 00100 /* Execute/Search by owner */ 80 #define TGREAD 00040 /* Read by group */ 81 #define TGWRITE 00020 /* Write by group */ 82 #define TGEXEC 00010 /* Execute/Search by group */ 83 #define TOREAD 00004 /* Read by other */ 84 #define TOWRITE 00002 /* Write by other */ 85 #define TOEXEC 00001 /* Execute/Search by other */ 86 87 #ifdef _PAX_ 88 /* 89 * Pad with a bit mask, much faster than doing a mod but only works on powers 90 * of 2. Macro below is for block of 512 bytes. 91 */ 92 #define TAR_PAD(x) ((512 - ((x) & 511)) & 511) 93 #endif /* _PAX_ */ 94 95 /* 96 * structure of an old tar header as it appeared in BSD releases 97 */ 98 typedef struct { 99 char name[TNMSZ]; /* name of entry */ 100 char mode[8]; /* mode */ 101 char uid[8]; /* uid */ 102 char gid[8]; /* gid */ 103 char size[12]; /* size */ 104 char mtime[12]; /* modification time */ 105 char chksum[CHK_LEN]; /* checksum */ 106 char linkflag; /* norm, hard, or sym. */ 107 char linkname[TNMSZ]; /* linked to name */ 108 } HD_TAR; 109 110 #ifdef _PAX_ 111 /* 112 * -o options for BSD tar to not write directories to the archive 113 */ 114 #define TAR_NODIR "nodir" 115 #define TAR_OPTION "write_opt" 116 117 /* 118 * default device names 119 */ 120 extern char DEV_0[]; 121 extern char DEV_1[]; 122 extern char DEV_4[]; 123 extern char DEV_5[]; 124 extern char DEV_7[]; 125 extern char DEV_8[]; 126 #endif /* _PAX_ */ 127 128 /* 129 * Data Interchange Format - Extended tar header format - POSIX 1003.1-1990 130 */ 131 #define TPFSZ 155 132 #define TMAGIC "ustar" /* ustar and a null */ 133 #define TMAGLEN 6 134 #define TVERSION "00" /* 00 and no null */ 135 #define TVERSLEN 2 136 137 typedef struct { 138 char name[TNMSZ]; /* name of entry */ 139 char mode[8]; /* mode */ 140 char uid[8]; /* uid */ 141 char gid[8]; /* gid */ 142 char size[12]; /* size */ 143 char mtime[12]; /* modification time */ 144 char chksum[CHK_LEN]; /* checksum */ 145 char typeflag; /* type of file. */ 146 char linkname[TNMSZ]; /* linked to name */ 147 char magic[TMAGLEN]; /* magic cookie */ 148 char version[TVERSLEN]; /* version */ 149 char uname[32]; /* ascii owner name */ 150 char gname[32]; /* ascii group name */ 151 char devmajor[8]; /* major device number */ 152 char devminor[8]; /* minor device number */ 153 char prefix[TPFSZ]; /* linked to name */ 154 } HD_USTAR; 155