نام (NAME)

bup-meta - ایجاد یا استخراج یک بایگانی فراداده

خلاصه دستور (SYNOPSIS)

bup meta --create: [-R] [-v] [-q] [--no-symlinks] [--no-paths] [-f file] <paths...>
bup meta --list: [-v] [-q] [-f file]
bup meta --extract: [-v] [-q] [--numeric-ids] [--no-symlinks] [-f file]
bup meta --start-extract: [-v] [-q] [--numeric-ids] [--no-symlinks] [-f file]
bup meta --finish-extract: [-v] [-q] [--numeric-ids] [-f file]
bup meta --edit: [--set-uid uid | --set-gid gid | --set-user user | --set-group group | ...] <paths...>

توضیحات (DESCRIPTION)

دستور bup meta بایگانی‌های فراداده (metadata) را ایجاد، استخراج و دستکاری می‌کند. یک بایگانی فراداده حاوی اطلاعات فراداده (برچسب‌های زمانی، مالکیت، مجوزهای دسترسی و غیره) برای مجموعه‌ای از مسیرهای سیستم‌فایل است.

برای شرح نحوه بازیابی فراداده‌های مالکیت، به bup-restore(1) مراجعه کنید.

گزینه‌ها (OPTIONS)

-c, --create: ایجاد بایگانی فراداده برای pathهای مشخص‌شده. نوشتن بایگانی در خروجی استاندارد مگر اینکه --file مشخص شده باشد.
-t, --list: نمایش اطلاعات درباره فراداده‌های موجود در یک بایگانی. خواندن بایگانی از ورودی استاندارد مگر اینکه --file مشخص شده باشد.
-x, --extract: استخراج یک بایگانی فراداده. از نظر مفهومی، ابتدا --start-extract و سپس --finish-extract را اجرا می‌کند. خواندن بایگانی از ورودی استاندارد مگر اینکه --file مشخص شده باشد.
--start-extract: ساختن یک درخت سیستم‌فایل منطبق با مسیرهای ذخیره‌شده در بایگانی فراداده. این دستور به تنهایی، بازیابی کامل فراداده‌ها را انجام نمی‌دهد. برای بازیابی کامل، پس از این دستور باید --finish-extract فراخوانی شود. پس از پایان این دستور، همه فایل‌های معمولی شرح داده‌شده توسط فراداده وجود خواهند داشت و خالی خواهند بود. بازیابی داده‌ها در آن فایل‌ها و سپس فراخوانی --finish-extract باید درخت اصلی را بازیابی کند. بایگانی از ورودی استاندارد خوانده خواهد شد مگر اینکه --file مشخص شده باشد.
--finish-extract: اتمام اعمال فراداده‌های ذخیره‌شده در بایگانی به سیستم‌فایل. معمولاً این دستور باید پس از فراخوانی --start-extract اجرا شود. بایگانی از ورودی استاندارد خوانده خواهد شد مگر اینکه --file مشخص شده باشد.
--edit: ویرایش بایگانی‌های فراداده. نتیجه در خروجی استاندارد نوشته خواهد شد مگر اینکه --file مشخص شده باشد.
-f, --file=filename: خواندن بایگانی فراداده از filename یا نوشتن آن در filename بر حسب مورد. اگر filename برابر “-” باشد، از ورودی استاندارد می‌خواند یا در خروجی استاندارد می‌نویسد.
-R, --recurse: پیمایش بازگشتی زیرشاخه‌ها هنگام استفاده از --create.
--xdev, --one-file-system: از مرزهای سیستم‌فایل عبور نکن – اگرچه همانند tar و rsync، خود نقاط پیوست (mount points) مدیریت خواهند شد.
--numeric-ids: اعمال شناسه‌های عددی (کاربر، گروه و غیره) به جای نام‌ها هنگام استفاده از --extract یا --finish-extract.
--symlinks: ثبت اهداف پیوندهای نمادین هنگام ایجاد بایگانی، یا بازیابی پیوندهای نمادین هنگام استخراج یک بایگانی (در زمان --extract یا --start-extract). این گزینه به صورت پیش‌فرض فعال است. برای غیرفعال کردن آن --no-symlinks را مشخص کنید.
--paths: ثبت نام مسیرها هنگام ایجاد بایگانی. این گزینه به طور پیش‌فرض فعال است. برای غیرفعال کردن آن --no-paths را مشخص کنید.
--set-uid=uid: تنظیم شناسه کاربر (uid) فراداده به عدد صحیح uid در حین --edit.
--set-gid=gid: تنظیم شناسه گروه (gid) فراداده به عدد صحیح gid در حین --edit.
--set-user=user: تنظیم کاربر فراداده به user در حین --edit.
--unset-user: حذف کاربر فراداده در حین --edit.
--set-group=group: تنظیم گروه فراداده به group در حین --edit.
--unset-group: حذف گروه فراداده در حین --edit.
-v, --verbose: پرگویی بیشتر (می‌تواند بیش از یک بار استفاده شود).
-q, --quiet: بی‌صدا بودن و عدم نمایش پیام‌های غیرضروری.

مثال‌ها (EXAMPLES)

# Create a metadata archive for /etc.
$ bup meta -cRf etc.meta /etc
bup: removing leading "/" from "/etc"
# Extract the etc.meta archive (files will be empty).
$ mkdir tmp && cd tmp
$ bup meta -xf ../etc.meta
$ ls
etc
# Restore /etc completely.
$ mkdir tmp && cd tmp
$ bup meta --start-extract -f ../etc.meta
...fill in all regular file contents using some other tool...
$ bup meta --finish-extract -f ../etc.meta
# Change user/uid to root.
$ bup meta --edit --set-uid 0 --set-user root \
    src.meta > dest.meta

اشکالات (BUGS)

پیوندهای سخت (Hard links) هنوز پشتیبانی نمی‌شوند.

مجموعه BUP

بخشی از مجموعه bup(1).

نویسندگان (AUTHORS)

Rob Browning rlb@defaultvalue.org.