.\" Automatically generated by Pandoc 3.10.2
.\"
.TH "bup\-meta" "1" "2026\-09\-01" "Bup 0.34+"
.SH "نام (NAME)"
bup\-meta \- ایجاد یا استخراج یک بایگانی فراداده
.SH "خلاصه دستور (SYNOPSIS)"
.TP
bup meta \-\-create
[\-R] [\-v] [\-q] [\-\-no\-symlinks] [\-\-no\-paths] [\-f
\f[I]file\f[R]] <\f[I]paths\f[R]\&...>
.TP
bup meta \-\-list
[\-v] [\-q] [\-f \f[I]file\f[R]]
.TP
bup meta \-\-extract
[\-v] [\-q] [\-\-numeric\-ids] [\-\-no\-symlinks] [\-f \f[I]file\f[R]]
.TP
bup meta \-\-start\-extract
[\-v] [\-q] [\-\-numeric\-ids] [\-\-no\-symlinks] [\-f \f[I]file\f[R]]
.TP
bup meta \-\-finish\-extract
[\-v] [\-q] [\-\-numeric\-ids] [\-f \f[I]file\f[R]]
.TP
bup meta \-\-edit
[\-\-set\-uid \f[I]uid\f[R] | \-\-set\-gid \f[I]gid\f[R] | \-\-set\-user
\f[I]user\f[R] | \-\-set\-group \f[I]group\f[R] | \&...]
<\f[I]paths\f[R]\&...>
.SH "توضیحات (DESCRIPTION)"
دستور \f[CR]bup meta\f[R] بایگانی‌های فراداده (metadata) را ایجاد، استخراج و دستکاری می‌کند.
یک بایگانی فراداده حاوی اطلاعات فراداده (برچسب‌های زمانی، مالکیت، مجوزهای دسترسی و غیره) برای مجموعه‌ای از مسیرهای سیستم‌فایل است.
.PP
برای شرح نحوه بازیابی فراداده‌های مالکیت، به \f[CR]bup\-restore\f[R](1) مراجعه کنید.
.SH "گزینه‌ها (OPTIONS)"
.TP
\-c, \-\-create
ایجاد بایگانی فراداده برای \f[I]path\f[R]های مشخص‌شده.
نوشتن بایگانی در خروجی استاندارد مگر اینکه \f[CR]\-\-file\f[R] مشخص شده باشد.
.TP
\-t, \-\-list
نمایش اطلاعات درباره فراداده‌های موجود در یک بایگانی.
خواندن بایگانی از ورودی استاندارد مگر اینکه \f[CR]\-\-file\f[R] مشخص شده باشد.
.TP
\-x, \-\-extract
استخراج یک بایگانی فراداده.
از نظر مفهومی، ابتدا \f[CR]\-\-start\-extract\f[R] و سپس \f[CR]\-\-finish\-extract\f[R] را اجرا می‌کند.
خواندن بایگانی از ورودی استاندارد مگر اینکه \f[CR]\-\-file\f[R] مشخص شده باشد.
.TP
\-\-start\-extract
ساختن یک درخت سیستم‌فایل منطبق با مسیرهای ذخیره‌شده در بایگانی فراداده.
این دستور به تنهایی، بازیابی کامل فراداده‌ها را انجام نمی‌دهد.
برای بازیابی کامل، پس از این دستور باید \f[CR]\-\-finish\-extract\f[R] فراخوانی شود.
پس از پایان این دستور، همه فایل‌های معمولی شرح داده‌شده توسط فراداده وجود خواهند داشت و خالی خواهند بود.
بازیابی داده‌ها در آن فایل‌ها و سپس فراخوانی \f[CR]\-\-finish\-extract\f[R] باید درخت اصلی را بازیابی کند.
بایگانی از ورودی استاندارد خوانده خواهد شد مگر اینکه \f[CR]\-\-file\f[R] مشخص شده باشد.
.TP
\-\-finish\-extract
اتمام اعمال فراداده‌های ذخیره‌شده در بایگانی به سیستم‌فایل.
معمولاً این دستور باید پس از فراخوانی \f[CR]\-\-start\-extract\f[R] اجرا شود.
بایگانی از ورودی استاندارد خوانده خواهد شد مگر اینکه \f[CR]\-\-file\f[R] مشخص شده باشد.
.TP
\-\-edit
ویرایش بایگانی‌های فراداده.
نتیجه در خروجی استاندارد نوشته خواهد شد مگر اینکه \f[CR]\-\-file\f[R] مشخص شده باشد.
.TP
\-f, \-\-file=\f[I]filename\f[R]
خواندن بایگانی فراداده از \f[I]filename\f[R] یا نوشتن آن در \f[I]filename\f[R] بر حسب مورد.
اگر \f[I]filename\f[R] برابر \(lq\-\(rq باشد، از ورودی استاندارد می‌خواند یا در خروجی استاندارد می‌نویسد.
.TP
\-R, \-\-recurse
پیمایش بازگشتی زیرشاخه‌ها هنگام استفاده از \f[CR]\-\-create\f[R].
.TP
\-\-xdev, \-\-one\-file\-system
از مرزهای سیستم‌فایل عبور نکن \(en اگرچه همانند tar و rsync، خود نقاط پیوست (mount points) مدیریت خواهند شد.
.TP
\-\-numeric\-ids
اعمال شناسه‌های عددی (کاربر، گروه و غیره) به جای نام‌ها هنگام استفاده از \f[CR]\-\-extract\f[R] یا \f[CR]\-\-finish\-extract\f[R].
.TP
\-\-symlinks
ثبت اهداف پیوندهای نمادین هنگام ایجاد بایگانی، یا بازیابی پیوندهای نمادین هنگام استخراج یک بایگانی (در زمان \f[CR]\-\-extract\f[R] یا \f[CR]\-\-start\-extract\f[R]).
این گزینه به صورت پیش‌فرض فعال است.
برای غیرفعال کردن آن \f[CR]\-\-no\-symlinks\f[R] را مشخص کنید.
.TP
\-\-paths
ثبت نام مسیرها هنگام ایجاد بایگانی.
این گزینه به طور پیش‌فرض فعال است.
برای غیرفعال کردن آن \f[CR]\-\-no\-paths\f[R] را مشخص کنید.
.TP
\-\-set\-uid=\f[I]uid\f[R]
تنظیم شناسه کاربر (uid) فراداده به عدد صحیح \f[I]uid\f[R] در حین \f[CR]\-\-edit\f[R].
.TP
\-\-set\-gid=\f[I]gid\f[R]
تنظیم شناسه گروه (gid) فراداده به عدد صحیح \f[I]gid\f[R] در حین \f[CR]\-\-edit\f[R].
.TP
\-\-set\-user=\f[I]user\f[R]
تنظیم کاربر فراداده به \f[I]user\f[R] در حین \f[CR]\-\-edit\f[R].
.TP
\-\-unset\-user
حذف کاربر فراداده در حین \f[CR]\-\-edit\f[R].
.TP
\-\-set\-group=\f[I]group\f[R]
تنظیم گروه فراداده به \f[I]group\f[R] در حین \f[CR]\-\-edit\f[R].
.TP
\-\-unset\-group
حذف گروه فراداده در حین \f[CR]\-\-edit\f[R].
.TP
\-v, \-\-verbose
پرگویی بیشتر (می‌تواند بیش از یک بار استفاده شود).
.TP
\-q, \-\-quiet
بی‌صدا بودن و عدم نمایش پیام‌های غیرضروری.
.SH "مثال‌ها (EXAMPLES)"
.IP
.EX
# Create a metadata archive for /etc.
$ bup meta \-cRf etc.meta /etc
bup: removing leading \(dq/\(dq from \(dq/etc\(dq

# 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 \(rs
    src.meta > dest.meta
.EE
.SH "اشکالات (BUGS)"
پیوندهای سخت (Hard links) هنوز پشتیبانی نمی‌شوند.
.SH "مجموعه BUP"
بخشی از مجموعه \f[CR]bup\f[R](1).
.SH "نویسندگان (AUTHORS)"
Rob Browning \c
.MT rlb@defaultvalue.org
.ME \c.