Clarify and expand some hook documentation.
[git/jrn.git] / tar-tree.c
blobe478e13e283a9d9687d0b32e180558995f2b920d
1 /*
2 * Copyright (c) 2005 Rene Scharfe
3 */
4 #include <time.h>
5 #include "cache.h"
6 #include "diff.h"
7 #include "commit.h"
9 #define RECORDSIZE (512)
10 #define BLOCKSIZE (RECORDSIZE * 20)
12 #define TYPEFLAG_AUTO '\0'
13 #define TYPEFLAG_REG '0'
14 #define TYPEFLAG_LNK '2'
15 #define TYPEFLAG_DIR '5'
16 #define TYPEFLAG_GLOBAL_HEADER 'g'
17 #define TYPEFLAG_EXT_HEADER 'x'
19 #define EXT_HEADER_PATH 1
20 #define EXT_HEADER_LINKPATH 2
22 static const char tar_tree_usage[] = "git-tar-tree <key> [basedir]";
24 static char block[BLOCKSIZE];
25 static unsigned long offset;
27 static const char *basedir;
28 static time_t archive_time;
30 struct path_prefix {
31 struct path_prefix *prev;
32 const char *name;
35 /* tries hard to write, either succeeds or dies in the attempt */
36 static void reliable_write(void *buf, unsigned long size)
38 while (size > 0) {
39 long ret = xwrite(1, buf, size);
40 if (ret < 0) {
41 if (errno == EPIPE)
42 exit(0);
43 die("git-tar-tree: %s", strerror(errno));
44 } else if (!ret) {
45 die("git-tar-tree: disk full?");
47 size -= ret;
48 buf += ret;
52 /* writes out the whole block, but only if it is full */
53 static void write_if_needed(void)
55 if (offset == BLOCKSIZE) {
56 reliable_write(block, BLOCKSIZE);
57 offset = 0;
61 /* acquire the next record from the buffer; user must call write_if_needed() */
62 static char *get_record(void)
64 char *p = block + offset;
65 memset(p, 0, RECORDSIZE);
66 offset += RECORDSIZE;
67 return p;
71 * The end of tar archives is marked by 1024 nul bytes and after that
72 * follows the rest of the block (if any).
74 static void write_trailer(void)
76 get_record();
77 write_if_needed();
78 get_record();
79 write_if_needed();
80 while (offset) {
81 get_record();
82 write_if_needed();
87 * queues up writes, so that all our write(2) calls write exactly one
88 * full block; pads writes to RECORDSIZE
90 static void write_blocked(void *buf, unsigned long size)
92 unsigned long tail;
94 if (offset) {
95 unsigned long chunk = BLOCKSIZE - offset;
96 if (size < chunk)
97 chunk = size;
98 memcpy(block + offset, buf, chunk);
99 size -= chunk;
100 offset += chunk;
101 buf += chunk;
102 write_if_needed();
104 while (size >= BLOCKSIZE) {
105 reliable_write(buf, BLOCKSIZE);
106 size -= BLOCKSIZE;
107 buf += BLOCKSIZE;
109 if (size) {
110 memcpy(block + offset, buf, size);
111 buf += size;
112 offset += size;
114 tail = offset % RECORDSIZE;
115 if (tail) {
116 memset(block + offset, 0, RECORDSIZE - tail);
117 offset += RECORDSIZE - tail;
119 write_if_needed();
122 static void append_string(char **p, const char *s)
124 unsigned int len = strlen(s);
125 memcpy(*p, s, len);
126 *p += len;
129 static void append_char(char **p, char c)
131 **p = c;
132 *p += 1;
135 static void append_path_prefix(char **buffer, struct path_prefix *prefix)
137 if (!prefix)
138 return;
139 append_path_prefix(buffer, prefix->prev);
140 append_string(buffer, prefix->name);
141 append_char(buffer, '/');
144 static unsigned int path_prefix_len(struct path_prefix *prefix)
146 if (!prefix)
147 return 0;
148 return path_prefix_len(prefix->prev) + strlen(prefix->name) + 1;
151 static void append_path(char **p, int is_dir, const char *basepath,
152 struct path_prefix *prefix, const char *path)
154 if (basepath) {
155 append_string(p, basepath);
156 append_char(p, '/');
158 append_path_prefix(p, prefix);
159 append_string(p, path);
160 if (is_dir)
161 append_char(p, '/');
164 static unsigned int path_len(int is_dir, const char *basepath,
165 struct path_prefix *prefix, const char *path)
167 unsigned int len = 0;
168 if (basepath)
169 len += strlen(basepath) + 1;
170 len += path_prefix_len(prefix) + strlen(path);
171 if (is_dir)
172 len++;
173 return len;
176 static void append_extended_header_prefix(char **p, unsigned int size,
177 const char *keyword)
179 int len = sprintf(*p, "%u %s=", size, keyword);
180 *p += len;
183 static unsigned int extended_header_len(const char *keyword,
184 unsigned int valuelen)
186 /* "%u %s=%s\n" */
187 unsigned int len = 1 + 1 + strlen(keyword) + 1 + valuelen + 1;
188 if (len > 9)
189 len++;
190 if (len > 99)
191 len++;
192 return len;
195 static void append_extended_header(char **p, const char *keyword,
196 const char *value, unsigned int len)
198 unsigned int size = extended_header_len(keyword, len);
199 append_extended_header_prefix(p, size, keyword);
200 memcpy(*p, value, len);
201 *p += len;
202 append_char(p, '\n');
205 static void write_header(const unsigned char *, char, const char *, struct path_prefix *,
206 const char *, unsigned int, void *, unsigned long);
208 /* stores a pax extended header directly in the block buffer */
209 static void write_extended_header(const char *headerfilename, int is_dir,
210 unsigned int flags, const char *basepath,
211 struct path_prefix *prefix,
212 const char *path, unsigned int namelen,
213 void *content, unsigned int contentsize)
215 char *buffer, *p;
216 unsigned int pathlen, size, linkpathlen = 0;
218 size = pathlen = extended_header_len("path", namelen);
219 if (flags & EXT_HEADER_LINKPATH) {
220 linkpathlen = extended_header_len("linkpath", contentsize);
221 size += linkpathlen;
223 write_header(NULL, TYPEFLAG_EXT_HEADER, NULL, NULL, headerfilename,
224 0100600, NULL, size);
226 buffer = p = malloc(size);
227 if (!buffer)
228 die("git-tar-tree: %s", strerror(errno));
229 append_extended_header_prefix(&p, pathlen, "path");
230 append_path(&p, is_dir, basepath, prefix, path);
231 append_char(&p, '\n');
232 if (flags & EXT_HEADER_LINKPATH)
233 append_extended_header(&p, "linkpath", content, contentsize);
234 write_blocked(buffer, size);
235 free(buffer);
238 static void write_global_extended_header(const unsigned char *sha1)
240 char *p;
241 unsigned int size;
243 size = extended_header_len("comment", 40);
244 write_header(NULL, TYPEFLAG_GLOBAL_HEADER, NULL, NULL,
245 "pax_global_header", 0100600, NULL, size);
247 p = get_record();
248 append_extended_header(&p, "comment", sha1_to_hex(sha1), 40);
249 write_if_needed();
252 /* stores a ustar header directly in the block buffer */
253 static void write_header(const unsigned char *sha1, char typeflag, const char *basepath,
254 struct path_prefix *prefix, const char *path,
255 unsigned int mode, void *buffer, unsigned long size)
257 unsigned int namelen;
258 char *header = NULL;
259 unsigned int checksum = 0;
260 int i;
261 unsigned int ext_header = 0;
263 if (typeflag == TYPEFLAG_AUTO) {
264 if (S_ISDIR(mode))
265 typeflag = TYPEFLAG_DIR;
266 else if (S_ISLNK(mode))
267 typeflag = TYPEFLAG_LNK;
268 else
269 typeflag = TYPEFLAG_REG;
272 namelen = path_len(S_ISDIR(mode), basepath, prefix, path);
273 if (namelen > 100)
274 ext_header |= EXT_HEADER_PATH;
275 if (typeflag == TYPEFLAG_LNK && size > 100)
276 ext_header |= EXT_HEADER_LINKPATH;
278 /* the extended header must be written before the normal one */
279 if (ext_header) {
280 char headerfilename[51];
281 sprintf(headerfilename, "%s.paxheader", sha1_to_hex(sha1));
282 write_extended_header(headerfilename, S_ISDIR(mode),
283 ext_header, basepath, prefix, path,
284 namelen, buffer, size);
287 header = get_record();
289 if (ext_header) {
290 sprintf(header, "%s.data", sha1_to_hex(sha1));
291 } else {
292 char *p = header;
293 append_path(&p, S_ISDIR(mode), basepath, prefix, path);
296 if (typeflag == TYPEFLAG_LNK) {
297 if (ext_header & EXT_HEADER_LINKPATH) {
298 sprintf(&header[157], "see %s.paxheader",
299 sha1_to_hex(sha1));
300 } else {
301 if (buffer)
302 strncpy(&header[157], buffer, size);
306 if (S_ISDIR(mode))
307 mode |= 0777;
308 else if (S_ISREG(mode))
309 mode |= (mode & 0100) ? 0777 : 0666;
310 else if (S_ISLNK(mode))
311 mode |= 0777;
312 sprintf(&header[100], "%07o", mode & 07777);
314 /* XXX: should we provide more meaningful info here? */
315 sprintf(&header[108], "%07o", 0); /* uid */
316 sprintf(&header[116], "%07o", 0); /* gid */
317 strncpy(&header[265], "git", 31); /* uname */
318 strncpy(&header[297], "git", 31); /* gname */
320 if (S_ISDIR(mode) || S_ISLNK(mode))
321 size = 0;
322 sprintf(&header[124], "%011lo", size);
323 sprintf(&header[136], "%011lo", archive_time);
325 header[156] = typeflag;
327 memcpy(&header[257], "ustar", 6);
328 memcpy(&header[263], "00", 2);
330 sprintf(&header[329], "%07o", 0); /* devmajor */
331 sprintf(&header[337], "%07o", 0); /* devminor */
333 memset(&header[148], ' ', 8);
334 for (i = 0; i < RECORDSIZE; i++)
335 checksum += header[i];
336 sprintf(&header[148], "%07o", checksum & 0x1fffff);
338 write_if_needed();
341 static void traverse_tree(struct tree_desc *tree,
342 struct path_prefix *prefix)
344 struct path_prefix this_prefix;
345 this_prefix.prev = prefix;
347 while (tree->size) {
348 const char *name;
349 const unsigned char *sha1;
350 unsigned mode;
351 void *eltbuf;
352 char elttype[20];
353 unsigned long eltsize;
355 sha1 = tree_entry_extract(tree, &name, &mode);
356 update_tree_entry(tree);
358 eltbuf = read_sha1_file(sha1, elttype, &eltsize);
359 if (!eltbuf)
360 die("cannot read %s", sha1_to_hex(sha1));
361 write_header(sha1, TYPEFLAG_AUTO, basedir,
362 prefix, name, mode, eltbuf, eltsize);
363 if (S_ISDIR(mode)) {
364 struct tree_desc subtree;
365 subtree.buf = eltbuf;
366 subtree.size = eltsize;
367 this_prefix.name = name;
368 traverse_tree(&subtree, &this_prefix);
369 } else if (!S_ISLNK(mode)) {
370 write_blocked(eltbuf, eltsize);
372 free(eltbuf);
376 int main(int argc, char **argv)
378 unsigned char sha1[20];
379 struct commit *commit;
380 struct tree_desc tree;
382 setup_git_directory();
384 switch (argc) {
385 case 3:
386 basedir = argv[2];
387 /* FALLTHROUGH */
388 case 2:
389 if (get_sha1(argv[1], sha1) < 0)
390 usage(tar_tree_usage);
391 break;
392 default:
393 usage(tar_tree_usage);
396 commit = lookup_commit_reference_gently(sha1, 1);
397 if (commit) {
398 write_global_extended_header(commit->object.sha1);
399 archive_time = commit->date;
401 tree.buf = read_object_with_reference(sha1, "tree", &tree.size, NULL);
402 if (!tree.buf)
403 die("not a reference to a tag, commit or tree object: %s",
404 sha1_to_hex(sha1));
405 if (!archive_time)
406 archive_time = time(NULL);
407 if (basedir)
408 write_header((unsigned char *)"0", TYPEFLAG_DIR, NULL, NULL,
409 basedir, 040777, NULL, 0);
410 traverse_tree(&tree, NULL);
411 write_trailer();
412 return 0;