sbin/hammer: Add "[y/n]" before getyn()
[dragonfly.git] / sbin / hammer / cmd_snapshot.c
blob3c7d3e75ade6ce70088d1645913ad590cdebe8ca
1 /*
2 * Copyright (c) 2008 The DragonFly Project. All rights reserved.
4 * This code is derived from software contributed to The DragonFly Project
5 * by Matthew Dillon <dillon@backplane.com>
7 * Redistribution and use in source and binary forms, with or without
8 * modification, are permitted provided that the following conditions
9 * are met:
11 * 1. Redistributions of source code must retain the above copyright
12 * notice, this list of conditions and the following disclaimer.
13 * 2. Redistributions in binary form must reproduce the above copyright
14 * notice, this list of conditions and the following disclaimer in
15 * the documentation and/or other materials provided with the
16 * distribution.
17 * 3. Neither the name of The DragonFly Project nor the names of its
18 * contributors may be used to endorse or promote products derived
19 * from this software without specific, prior written permission.
21 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
22 * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
23 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
24 * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
25 * COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
26 * INCIDENTAL, SPECIAL, EXEMPLARY OR CONSEQUENTIAL DAMAGES (INCLUDING,
27 * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
28 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
29 * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
30 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
31 * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
32 * SUCH DAMAGE.
34 * $DragonFly: src/sbin/hammer/cmd_snapshot.c,v 1.7 2008/07/10 18:47:22 mneumann Exp $
37 #include "hammer.h"
39 #define DEFAULT_SNAPSHOT_NAME "snap-%Y%m%d-%H%M"
41 static void snapshot_usage(int exit_code);
42 static void snapshot_add(int fd, const char *fsym, const char *tsym,
43 const char *label, hammer_tid_t tid);
44 static void snapshot_ls(const char *path);
45 static void snapshot_del(int fsfd, hammer_tid_t tid);
46 static char *dirpart(const char *path);
49 * hammer snap <path> [<note>]
51 * Path may be a directory, softlink, or non-existent (a softlink will be
52 * created).
54 void
55 hammer_cmd_snap(char **av, int ac, int tostdout, int fsbase)
57 struct hammer_ioc_synctid synctid;
58 struct hammer_ioc_version version;
59 char *dirpath;
60 char *fsym = NULL;
61 char *tsym = NULL;
62 struct stat st;
63 char note[64];
64 int fsfd;
66 if (ac == 0 || ac > 2) {
67 snapshot_usage(1);
68 /* not reached */
71 if (ac == 2)
72 snprintf(note, sizeof(note), "%s", av[1]);
73 else
74 note[0] = 0;
77 * Figure out the softlink path and directory path
79 if (stat(av[0], &st) < 0) {
80 dirpath = dirpart(av[0]);
81 tsym = strdup(av[0]);
82 } else if (S_ISDIR(st.st_mode)) {
83 time_t t = time(NULL);
84 struct tm *tp;
85 char extbuf[64];
87 tp = localtime(&t);
88 strftime(extbuf, sizeof(extbuf), DEFAULT_SNAPSHOT_NAME, tp);
90 dirpath = strdup(av[0]);
91 asprintf(&tsym, "%s/%s", dirpath, extbuf);
92 } else {
93 err(2, "hammer snap: File %s exists and is not a directory",
94 av[0]);
95 /* not reached */
99 * Get a handle on some directory in the filesystem for the
100 * ioctl (so it is stored in the correct PFS).
102 fsfd = open(dirpath, O_RDONLY);
103 if (fsfd < 0) {
104 err(2, "hammer snap: Cannot open directory %s", dirpath);
105 /* not reached */
109 * Must be at least version 3 to use this command.
111 bzero(&version, sizeof(version));
113 if (ioctl(fsfd, HAMMERIOC_GET_VERSION, &version) < 0) {
114 err(2, "Unable to create snapshot");
115 /* not reached */
116 } else if (version.cur_version < 3) {
117 errx(2, "Unable to create snapshot: This directive requires "
118 "you to upgrade\n"
119 "the filesystem to version 3. "
120 "Use 'hammer snapshot' for legacy operation.");
121 /* not reached */
125 * Synctid to get a transaction id for the snapshot.
127 bzero(&synctid, sizeof(synctid));
128 synctid.op = HAMMER_SYNCTID_SYNC2;
129 if (ioctl(fsfd, HAMMERIOC_SYNCTID, &synctid) < 0) {
130 err(2, "hammer snap: Synctid %s failed",
131 dirpath);
133 if (tostdout) {
134 if (strcmp(dirpath, ".") == 0 || strcmp(dirpath, "..") == 0) {
135 printf("%s/@@0x%016jx\n",
136 dirpath, (uintmax_t)synctid.tid);
137 } else {
138 printf("%s@@0x%016jx\n",
139 dirpath, (uintmax_t)synctid.tid);
141 fsym = NULL;
142 tsym = NULL;
146 * Contents of the symlink being created.
148 if (fsbase) {
149 struct statfs buf;
151 if (statfs(dirpath, &buf) < 0) {
152 err(2, "hammer snap: Cannot determine mount for %s",
153 dirpath);
155 asprintf(&fsym, "%s/@@0x%016jx",
156 buf.f_mntonname, (uintmax_t)synctid.tid);
157 } else if (strcmp(dirpath, ".") == 0 || strcmp(dirpath, "..") == 0) {
158 asprintf(&fsym, "%s/@@0x%016jx",
159 dirpath, (uintmax_t)synctid.tid);
160 } else {
161 asprintf(&fsym, "%s@@0x%016jx",
162 dirpath, (uintmax_t)synctid.tid);
166 * Create the snapshot.
168 snapshot_add(fsfd, fsym, tsym, note, synctid.tid);
169 free(dirpath);
170 free(fsym);
171 free(tsym);
175 * hammer snapls [<path> ...]
177 * If no arguments are specified snapshots for the PFS containing the
178 * current directory are listed.
180 void
181 hammer_cmd_snapls(char **av, int ac)
183 int i;
185 for (i = 0; i < ac; ++i)
186 snapshot_ls(av[i]);
187 if (ac == 0)
188 snapshot_ls(".");
192 * hammer snaprm <path> ...
193 * hammer snaprm <transid> ...
194 * hammer snaprm <filesystem> <transid> ...
196 void
197 hammer_cmd_snaprm(char **av, int ac)
199 struct stat st;
200 char linkbuf[1024];
201 intmax_t tid;
202 int fsfd = -1;
203 int i;
204 int delete;
205 enum snaprm_mode { none_m, path_m, tid_m } mode = none_m;
206 char *dirpath;
207 char *ptr, *ptr2;
209 if (ac == 0) {
210 snapshot_usage(1);
211 /* not reached */
214 for (i = 0; i < ac; ++i) {
215 if (lstat(av[i], &st) < 0) {
216 tid = strtoull(av[i], &ptr, 16);
217 if (*ptr) {
218 err(2, "hammer snaprm: not a file or tid: %s",
219 av[i]);
220 /* not reached */
222 if (mode == path_m) {
223 snapshot_usage(1);
224 /* not reached */
226 mode = tid_m;
227 if (fsfd < 0)
228 fsfd = open(".", O_RDONLY);
229 snapshot_del(fsfd, tid);
230 } else if (S_ISDIR(st.st_mode)) {
231 if (i != 0 || ac < 2) {
232 snapshot_usage(1);
233 /* not reached */
235 if (fsfd >= 0)
236 close(fsfd);
237 fsfd = open(av[i], O_RDONLY);
238 if (fsfd < 0) {
239 err(2, "hammer snaprm: cannot open dir %s",
240 av[i]);
241 /* not reached */
243 mode = tid_m;
244 } else if (S_ISLNK(st.st_mode)) {
245 dirpath = dirpart(av[i]);
246 bzero(linkbuf, sizeof(linkbuf));
247 if (readlink(av[i], linkbuf, sizeof(linkbuf) - 1) < 0) {
248 err(2, "hammer snaprm: cannot read softlink: "
249 "%s", av[i]);
250 /* not reached */
252 if (linkbuf[0] == '/') {
253 free(dirpath);
254 dirpath = dirpart(linkbuf);
255 } else {
256 asprintf(&ptr, "%s/%s", dirpath, linkbuf);
257 free(dirpath);
258 dirpath = dirpart(ptr);
259 free(ptr);
262 if (fsfd >= 0)
263 close(fsfd);
264 fsfd = open(dirpath, O_RDONLY);
265 if (fsfd < 0) {
266 err(2, "hammer snaprm: cannot open dir %s",
267 dirpath);
268 /* not reached */
271 delete = 1;
272 if (i == 0 && ac > 1) {
273 mode = path_m;
274 if (lstat(av[1], &st) < 0) {
275 tid = strtoull(av[1], &ptr, 16);
276 if (*ptr == '\0') {
277 delete = 0;
278 mode = tid_m;
281 } else {
282 if (mode == tid_m) {
283 snapshot_usage(1);
284 /* not reached */
286 mode = path_m;
288 if (delete && (ptr = strrchr(linkbuf, '@')) &&
289 ptr > linkbuf && ptr[-1] == '@' && ptr[1]) {
290 tid = strtoull(ptr + 1, &ptr2, 16);
291 if (*ptr2 == '\0') {
292 snapshot_del(fsfd, tid);
293 remove(av[i]);
296 free(dirpath);
297 } else {
298 err(2, "hammer snaprm: not directory or snapshot "
299 "softlink: %s", av[i]);
300 /* not reached */
303 if (fsfd >= 0)
304 close(fsfd);
308 * snapshot <softlink-dir>
309 * snapshot <filesystem> <softlink-dir> [<note>]
311 void
312 hammer_cmd_snapshot(char **av, int ac)
314 const char *filesystem;
315 const char *softlink_dir;
316 char *softlink_fmt;
317 struct statfs buf;
318 struct stat st;
319 struct hammer_ioc_synctid synctid;
320 char *from;
321 char *to;
322 char *note = NULL;
324 if (ac == 1) {
325 filesystem = NULL;
326 softlink_dir = av[0];
327 } else if (ac == 2) {
328 filesystem = av[0];
329 softlink_dir = av[1];
330 } else if (ac == 3) {
331 filesystem = av[0];
332 softlink_dir = av[1];
333 note = av[2];
334 } else {
335 snapshot_usage(1);
336 /* not reached */
339 if (stat(softlink_dir, &st) == 0) {
340 if (!S_ISDIR(st.st_mode))
341 err(2, "File %s already exists", softlink_dir);
343 if (filesystem == NULL) {
344 if (statfs(softlink_dir, &buf) != 0) {
345 err(2, "Unable to determine filesystem of %s",
346 softlink_dir);
348 filesystem = buf.f_mntonname;
351 softlink_fmt = malloc(strlen(softlink_dir) + 1 + 1 +
352 sizeof(DEFAULT_SNAPSHOT_NAME));
353 if (softlink_fmt == NULL)
354 err(2, "Failed to allocate string");
356 strcpy(softlink_fmt, softlink_dir);
357 if (softlink_fmt[strlen(softlink_fmt)-1] != '/')
358 strcat(softlink_fmt, "/");
359 strcat(softlink_fmt, DEFAULT_SNAPSHOT_NAME);
360 } else {
361 softlink_fmt = strdup(softlink_dir);
363 if (filesystem == NULL) {
365 * strip-off last '/path' segment to get the softlink
366 * directory, which we need to determine the filesystem
367 * we are on.
369 char *pos = strrchr(softlink_fmt, '/');
370 if (pos != NULL)
371 *pos = '\0';
373 if (stat(softlink_fmt, &st) != 0 ||
374 !S_ISDIR(st.st_mode)) {
375 err(2, "Unable to determine softlink dir %s",
376 softlink_fmt);
378 if (statfs(softlink_fmt, &buf) != 0) {
379 err(2, "Unable to determine filesystem of %s",
380 softlink_fmt);
382 filesystem = buf.f_mntonname;
384 /* restore '/' */
385 if (pos != NULL)
386 *pos = '/';
391 * Synctid
393 bzero(&synctid, sizeof(synctid));
394 synctid.op = HAMMER_SYNCTID_SYNC2;
396 int fd = open(filesystem, O_RDONLY);
397 if (fd < 0)
398 err(2, "Unable to open %s", filesystem);
399 if (ioctl(fd, HAMMERIOC_SYNCTID, &synctid) < 0)
400 err(2, "Synctid %s failed", filesystem);
402 asprintf(&from, "%s/@@0x%016jx", filesystem, (uintmax_t)synctid.tid);
403 if (from == NULL)
404 err(2, "Couldn't generate string");
406 int sz = strlen(softlink_fmt) + 50;
407 to = malloc(sz);
408 if (to == NULL)
409 err(2, "Failed to allocate string");
411 time_t t = time(NULL);
412 if (strftime(to, sz, softlink_fmt, localtime(&t)) == 0)
413 err(2, "String buffer too small");
415 asprintf(&from, "%s/@@0x%016jx", filesystem, (uintmax_t)synctid.tid);
417 snapshot_add(fd, from, to, note, synctid.tid);
419 close(fd);
420 printf("%s\n", to);
422 free(softlink_fmt);
423 free(from);
424 free(to);
427 static
428 void
429 snapshot_add(int fd, const char *fsym, const char *tsym, const char *label,
430 hammer_tid_t tid)
432 struct hammer_ioc_version version;
433 struct hammer_ioc_snapshot snapshot;
435 bzero(&version, sizeof(version));
436 bzero(&snapshot, sizeof(snapshot));
439 * For HAMMER filesystem v3+ the snapshot is recorded in meta-data.
441 if (ioctl(fd, HAMMERIOC_GET_VERSION, &version) == 0 &&
442 version.cur_version >= 3) {
443 snapshot.index = 0;
444 snapshot.count = 1;
445 snapshot.snaps[0].tid = tid;
446 snapshot.snaps[0].ts = time(NULL) * 1000000ULL;
447 if (label) {
448 snprintf(snapshot.snaps[0].label,
449 sizeof(snapshot.snaps[0].label),
450 "%s",
451 label);
453 if (ioctl(fd, HAMMERIOC_ADD_SNAPSHOT, &snapshot) < 0) {
454 err(2, "Unable to create snapshot");
455 } else if (snapshot.head.error &&
456 snapshot.head.error != EEXIST) {
457 errx(2, "Unable to create snapshot: %s",
458 strerror(snapshot.head.error));
463 * Create a symlink for the snapshot. If a file exists with the same
464 * name the new symlink will replace it.
466 if (fsym && tsym) {
467 remove(tsym);
468 if (symlink(fsym, tsym) < 0) {
469 err(2, "Unable to create symlink %s", tsym);
474 static
475 void
476 snapshot_ls(const char *path)
478 struct hammer_ioc_info info;
479 struct hammer_ioc_snapshot snapshot;
480 struct hammer_ioc_pseudofs_rw pfs;
481 struct hammer_pseudofs_data pfs_od;
482 hammer_snapshot_data_t snap;
483 struct tm *tp;
484 time_t t;
485 uint32_t i;
486 int fd;
487 char snapts[64];
489 fd = open(path, O_RDONLY);
490 if (fd < 0) {
491 err(2, "hammer snapls: cannot open %s", path);
492 /* not reached */
495 clrpfs(&pfs, &pfs_od, -1);
496 if (ioctl(fd, HAMMERIOC_GET_PSEUDOFS, &pfs) < 0) {
497 err(2, "hammer snapls: cannot retrieve PFS info on %s", path);
498 /* not reached */
501 bzero(&info, sizeof(info));
502 if ((ioctl(fd, HAMMERIOC_GET_INFO, &info)) < 0) {
503 err(2, "hammer snapls: cannot retrieve HAMMER info");
504 /* not reached */
507 printf("Snapshots on %s\tPFS#%d\n", path, pfs.pfs_id);
508 printf("Transaction ID\t\tTimestamp\t\tNote\n");
510 bzero(&snapshot, sizeof(snapshot));
511 do {
512 if (ioctl(fd, HAMMERIOC_GET_SNAPSHOT, &snapshot) < 0) {
513 err(2, "hammer snapls: %s: not HAMMER fs or "
514 "version < 3", path);
515 /* not reached */
517 for (i = 0; i < snapshot.count; ++i) {
518 snap = &snapshot.snaps[i];
520 t = snap->ts / 1000000ULL;
521 tp = localtime(&t);
522 strftime(snapts, sizeof(snapts),
523 "%Y-%m-%d %H:%M:%S %Z", tp);
524 printf("0x%016jx\t%s\t%s\n",
525 (uintmax_t)snap->tid, snapts,
526 strlen(snap->label) ? snap->label : "-");
528 } while (snapshot.head.error == 0 && snapshot.count);
531 static
532 void
533 snapshot_del(int fsfd, hammer_tid_t tid)
535 struct hammer_ioc_snapshot snapshot;
536 struct hammer_ioc_version version;
538 bzero(&version, sizeof(version));
540 if (ioctl(fsfd, HAMMERIOC_GET_VERSION, &version) < 0) {
541 err(2, "hammer snaprm 0x%016jx", (uintmax_t)tid);
543 if (version.cur_version < 3) {
544 errx(2, "hammer snaprm 0x%016jx: You must upgrade to version "
545 " 3 to use this directive", (uintmax_t)tid);
548 bzero(&snapshot, sizeof(snapshot));
549 snapshot.count = 1;
550 snapshot.snaps[0].tid = tid;
553 * Do not abort if we are unable to remove the meta-data.
555 if (ioctl(fsfd, HAMMERIOC_DEL_SNAPSHOT, &snapshot) < 0) {
556 err(2, "hammer snaprm 0x%016jx",
557 (uintmax_t)tid);
558 } else if (snapshot.head.error == ENOENT) {
559 fprintf(stderr, "Warning: hammer snaprm 0x%016jx: "
560 "meta-data not found\n",
561 (uintmax_t)tid);
562 } else if (snapshot.head.error) {
563 fprintf(stderr, "Warning: hammer snaprm 0x%016jx: %s\n",
564 (uintmax_t)tid, strerror(snapshot.head.error));
568 static
569 void
570 snapshot_usage(int exit_code)
572 fprintf(stderr,
573 "hammer snap <path> [<note>]\t\tcreate snapshot & link, points to\n"
574 "\t\t\t\t\tbase of PFS mount\n"
575 "hammer snaplo <path> [<note>]\t\tcreate snapshot & link, points to\n"
576 "\t\t\t\t\ttarget dir\n"
577 "hammer snapq <dir> [<note>]\t\tcreate snapshot, output path to stdout\n"
578 "hammer snaprm <path> ...\t\tdelete snapshots; filesystem is CWD\n"
579 "hammer snaprm <transid> ...\t\tdelete snapshots\n"
580 "hammer snaprm <filesystem> <transid> ...\tdelete snapshots\n"
581 "hammer snapls [<path> ...]\t\tlist available snapshots\n"
582 "\n"
583 "NOTE: Snapshots are created in filesystem meta-data, any directory\n"
584 " in a HAMMER filesystem or PFS may be specified. If the path\n"
585 " specified does not exist this function will also create a\n"
586 " softlink.\n"
587 "\n"
588 " When deleting snapshots transaction ids may be directly specified\n"
589 " or file paths to snapshot softlinks may be specified. If a\n"
590 " softlink is specified the softlink will also be deleted.\n"
591 "\n"
592 "NOTE: The old 'hammer snapshot [<filesystem>] <snapshot-dir>' form\n"
593 " is still accepted but is a deprecated form. This form will\n"
594 " work for older hammer versions. The new forms only work for\n"
595 " HAMMER version 3 or later filesystems. HAMMER can be upgraded\n"
596 " to version 3 in-place.\n"
598 exit(exit_code);
601 static
602 char *
603 dirpart(const char *path)
605 const char *ptr;
606 char *res;
608 ptr = strrchr(path, '/');
609 if (ptr) {
610 while (ptr > path && ptr[-1] == '/')
611 --ptr;
612 if (ptr == path)
613 ptr = NULL;
615 if (ptr == NULL) {
616 path = ".";
617 ptr = path + 1;
619 res = malloc(ptr - path + 1);
620 bcopy(path, res, ptr - path);
621 res[ptr - path] = 0;
622 return(res);