duplicity /home/me sftp://uid@other.host/some_dir

duplicity full /home/me sftp://uid@other.host/some_dir

duplicity --full-if-older-than 1M /home/me sftp://uid@other.host/some_dir

duplicity sftp://uid@other.host/some_dir /home/me

duplicity -t 3D --path-to-restore Mail/article sftp://uid@other.host/some_dir /home/me/restored_file

duplicity verify sftp://uid@other.host/some_dir /home/me

duplicity --exclude /mnt --exclude /tmp --exclude /proc / file:///usr/local/backup

duplicity --include /home --include /etc --exclude '**' / file:///usr/local/backup

BACKEND_PASSWORD=mypassword duplicity /local/dir ftp://user@other.host/some_dir.SH "عملیات‌ها (ACTIONS)" برنامه Duplicity از عملیات‌ها استفاده می‌کند، که می‌توانند به شکل کوتاه یا بلند مشخص شوند و با گزینه‌ها تنظیم دقیق گردند.
عملیات‌های 'backup' یا 'restore' می‌توانند به‌طور ضمنی از ترتیب قرارگیری مسیر محلی و url دوردست استنباط شوند. سایر عملیات‌ها باید به‌صورت صریح مشخص گردند. برای موارد نادری که مسیر محلی ممکن است نام یک عملیات معتبر duplicity باشد، می‌توانید یک '/' به انتهای نام مسیر محلی اضافه کنید تا دیگر با یک عملیات اشتباه گرفته نشود.

نکته: توضیحات زیر برخی از گزینه‌هایی را که می‌توان در ارتباط با آن عملیات استفاده کرد شرح می‌دهند، اما نه همهٔ آن‌ها را. برای توضیحات دقیق‌تر به بخش گزینه‌ها (OPTIONS) مراجعه کنید.

backup, bu <folder> <url>

انجام یک پشتیبان‌گیری. Duplicity اگر امضاهای قدیمی یافت شوند به‌طور خودکار یک پشتیبان‌گیری افزایشی انجام می‌دهد. در غیر این صورت یک زنجیرهٔ پشتیبان‌گیری جدید آغاز می‌شود.

full, fb <folder> <url>

انجام یک پشتیبان‌گیری کامل. حتی اگر امضاها برای یک پشتیبان‌گیری افزایشی در دسترس باشند، یک زنجیرهٔ پشتیبان‌گیری جدید آغاز می‌شود.

incremental, ib <folder> <url>

در صورت درخواست، یک پشتیبان‌گیری افزایشی انجام خواهد شد. اگر هیچ امضای قدیمی یافت نشود، Duplicity لغو خواهد شد.

verify, vb [--compare-data] [--time <time>] [--path-to-restore <rel_path>] <url> <local_path>

عملیات verify یکپارچگی آرشیوهای پشتیبان را در مکان دوردست با بارگیری هر فایل و بررسی این‌که هم بتواند آرشیو را بازیابی کند و هم فایل بازیابی‌شده با امضای آن فایل که در پشتیبان ذخیره شده مطابقت داشته باشد (یعنی فایل آرشیو‌شده را با مقدار هش آن در زمان آرشیو مقایسه می‌کند)، آزمایش می‌نماید. Verify در واقع بازیابی انجام نمی‌دهد و هیچ فایل محلی را بازنویسی نخواهد کرد. Duplicity در صورتی که هر فایلی با امضای ذخیره‌شده در آرشیو برای آن فایل مطابقت نداشته باشد، با یک سطح خطای غیرصفر خارج خواهد شد. در سطح پرگویی (verbosity) ۴ یا بالاتر، پیامی برای هر فایلی که با امضای ذخیره‌شده تفاوت دارد ثبت می‌کند. برای مقایسهٔ فایل‌ها، آن‌ها باید روی رایانهٔ محلی بارگیری شوند. Verify نسخهٔ پشتیبان‌گیری‌شدهٔ فایل را با نسخهٔ محلی فعلی فایل‌ها مقایسه نمی‌کند، مگر این‌که گزینهٔ --compare-data استفاده شود (پایین را ببینید).
گزینهٔ --path-to-restore عملیات verify را به آن فایل یا پوشه محدود می‌کند. گزینهٔ --time امکان انتخاب یک نسخهٔ پشتیبان برای اعتبارسنجی را فراهم می‌سازد. گزینهٔ --compare-data مقایسهٔ داده‌ها را فعال می‌کند (پایین را ببینید).

collection-status, st [--file-changed <relpath>] [--show-changes-in-set <index>] <url>

وضعیت مخزن پشتیبان را با چاپ زنجیره‌ها و مجموعه‌های پیداشده، و تعداد حجم‌ها در هر یک خلاصه می‌کند.
گزینهٔ --file-changed تغییرات فایل را (در جدیدترین زنجیرهٔ پشتیبان‌گیری) خلاصه می‌کند. گزینهٔ --show-changes-in-set تمام تغییرات فایل را در indexاُمین مجموعهٔ پشتیبان خلاصه می‌کند (که در آن index برابر 0 به معنای جدیدترین مجموعه، 1 به معنای مجموعه ماقبل آخر، و غیره است). گزینهٔ --jsonstat تغییرات را در قالب json چاپ می‌کند و در صورتی که پشتیبان‌ها با --jsonstat ایجاد شده باشند، آمار را از فایل‌های jsonstat نمایش می‌دهد. اگر <index> روی -1 تنظیم شود، آمار کل زنجیرهٔ پشتیبان چاپ می‌شود.

list-current-files, ls [--time <time>] <url>

فهرست فایل‌های موجود در تازه‌ترین پشتیبان یا پشتیبان در زمان مشخص‌شده را نمایش می‌دهد. این اطلاعات از فایل‌های امضا استخراج خواهد شد، نه از خود داده‌های آرشیو. بنابراین نیازی به بارگیری کل آرشیو نیست، اما از سوی دیگر اگر آرشیو حذف شده یا آسیب دیده باشد، این عملیات آن را تشخیص نخواهد داد.

restore, rb [--path-to-restore <relpath> | file selection options] [--time <time>] <url> <target_folder>

می‌توانید همه چیز را به‌طور کامل یا پوشه‌ها/فایل‌های انتخاب‌شده را از یک زمان مشخص بازیابی کنید. از مسیر نسبی همان‌طور که توسط list-current-files چاپ می‌شود استفاده کنید.
برای پالایش بازیابی مبتنی بر الگو، گزینه‌های انتخاب فایل مانند --include، --exclude، --include-regexp، و --exclude-regexp نیز مسیرها را نسبت به ریشهٔ آرشیو، همان‌طور که توسط list-current-files چاپ می‌شود، مطابقت می‌دهند. این گزینه‌های انتخاب فایل را نمی‌توان با --path-to-restore ترکیب کرد. معمولاً نیازی به مشخص کردن این عملیات نیست زیرا duplicity هنگامی که تشخیص دهد URL پیش از پوشهٔ محلی آمده است، به‌طور خودکار وارد حالت بازیابی می‌شود.

remove-older-than, ro <time> [--force] <url>

حذف تمام مجموعه‌های پشتیبان که از زمان داده‌شده قدیمی‌تر هستند. اگر مجموعه‌های پشتیبان جدیدتر از time به آن‌ها وابسته باشند، مجموعه‌های پشتیبان قدیمی حذف نخواهند شد. برای اطلاعات بیشتر بخش قالب‌های زمان (TIME FORMATS) را ببینید. توجه داشته باشید که این عملیات را نمی‌توان با backup یا عملیات‌های دیگر مانند cleanup ترکیب کرد. همچنین توجه داشته باشید که --force برای حذف فایل‌ها به جای صرفاً فهرست کردن آن‌ها مورد نیاز خواهد بود.

remove-all-but-n-full, ra <count> [--force] <url>

حذف تمام مجموعه‌های پشتیبانی که از countاُمین پشتیبان کاملِ آخر قدیمی‌تر هستند (به عبارت دیگر، نگه‌داشتن count پشتیبان کامل آخر و مجموعه‌های افزایشی مرتبط با آن‌ها). count باید بزرگ‌تر از صفر باشد. مقدار 1 به این معنی است که تنها تازه‌ترین زنجیرهٔ پشتیبان نگه‌داشته خواهد شد. توجه داشته باشید که --force برای حذف فایل‌ها به جای صرفاً فهرست کردن آن‌ها مورد نیاز خواهد بود.

remove-all-inc-of-but-n-full, ri <count> [--force] <url>

حذف مجموعه‌های افزایشی تمام مجموعه‌های پشتیبانی که از countاُمین پشتیبان کاملِ آخر قدیمی‌تر هستند (به عبارت دیگر، نگه‌داشتن تنها پشتیبان‌های کامل قدیمی و نه افزایشی‌های آن‌ها). count باید بزرگ‌تر از صفر باشد. مقدار 1 به این معنی است که تنها تازه‌ترین زنجیرهٔ پشتیبان دست‌نخورده باقی خواهد ماند. توجه داشته باشید که --force برای حذف فایل‌ها به جای صرفاً فهرست کردن آن‌ها مورد نیاز خواهد بود.

cleanup, cl [--force] <url>

حذف فایل‌های اضافه و زائد duplicity در backend مشخص‌شده. فایل‌های غیر duplicity یا فایل‌های موجود در مجموعه‌های دادهٔ کامل حذف نخواهند شد. این کار معمولاً تنها پس از آن لازم است که یک نشست duplicity با شکست مواجه شود یا پیش از موعد متوقف گردد. توجه داشته باشید که --force برای حذف فایل‌ها به جای صرفاً فهرست کردن آن‌ها مورد نیاز خواهد بود..SH "گزینه‌ها (OPTIONS)"

--allow-source-mismatch

در صورت تلاش برای استفاده از همان دایرکتوری آرشیو یا backend دوردست برای پشتیبان‌گیری از دایرکتوری‌های متفاوت، عملیات متوقف نمی‌شود. duplicity در صورت نیاز به این سوئیچ، به شما اطلاع خواهد داد.

--archive-dir path

دایرکتوری آرشیو.

--asynchronous-upload

(منسوخ‌شده) این گزینه به دلیل ناپایداری منسوخ شده است. `--concurrency` جایگزین جدید آن است.

--azure-blob-tier

سطح ذخیره‌سازی استاندارد (storage tier) مورد استفاده برای فایل‌های پشتیبان (Hot|Cool|Cold|Archive).

--azure-max-single-put-size

بزرگ‌ترین اندازه بارگذاری پشتیبانی‌شده را مشخص می‌کند که در آن کتابخانه Azure تنها یک فراخوانی put انجام می‌دهد. اگر اندازه محتوا مشخص و کمتر از این مقدار باشد، کتابخانه Azure تنها یک درخواست put را برای بارگذاری یک بلوک اجرا خواهد کرد. انتظار می‌رود این عدد بر حسب بایت باشد.

--azure-max-block-size

اندازه بلوک مورد استفاده توسط کتابخانه Azure را برای بارگذاری blobها در صورتی که به چندین بلوک تقسیم شده باشند، مشخص می‌کند. حداکثر اندازه بلوکی که این سرویس پشتیبانی می‌کند 104857600 (100MiB) و مقدار پیش‌فرض 4194304 (4MiB) است.

--azure-max-connections

حداکثر تعداد اتصالات را برای انتقال یک blob به Azure در صورتی که اندازه blob از 64MB فراتر رود، مشخص می‌کند. مقدار پیش‌فرض 2 است.

--b2-hide-files

باعث می‌شود duplicity به جای حذف فایل‌ها در B2، آن‌ها را پنهان کند. در ترکیب با قوانین چرخه حیات (lifecycle rules) در B2 مفید است.

--backend-retry-delay number

تعداد ثانیه‌هایی را مشخص می‌کند که duplicity پس از وقوع یک خطا، پیش از تلاش مجدد برای تکرار عملیات، منتظر می‌ماند.

--cf-backend backend

امکان انتخاب صریح backend برای cloudfiles را فراهم می‌کند. مقدار پیش‌فرض pyrax است. از طرف دیگر می‌توانید cloudfiles را انتخاب کنید.

--concurrency number

تعداد فرایندهای پس‌زمینه‌ای را مشخص می‌کند که باید برای اجرای هم‌زمان وظایف backend استفاده شوند. این کار عملیات محلی مانند رمزگذاری/رمزگشایی، ساخت حجم و غیره را از انتقال به/از backendها تفکیک می‌کند. نتیجه نهایی مورد نظر، پشتیبان‌گیری سریع‌تر است، زیرا پردازنده محلی (CPU) و پهنای باند شما می‌توانند به صورت پیوسته‌تری مورد استفاده قرار گیرند. استفاده از این گزینه مستلزم نیاز به فضای دیسک بیشتر در محل ذخیره‌سازی موقت است؛ به جای این که در هر زمان تنها نیاز به ذخیره یک حجم باشد، فضای ذخیره‌سازی کافی برای نگهداری 1+n حجم نیاز خواهد بود. بسته به backend و شبکه، عملیات موازی می‌توانند روند کار را تسریع کنند. یک نقطه شروع مناسب برای concurrency مقدار ۱ تا ۴ است. برای تنظیم دقیق، آمار duplicity را بررسی کنید. در بیشتر موارد این مقدار نباید از تعداد پردازنده‌های سیستم شما منهای یک فراتر رود.

--config-dir path

امکان انتخاب دایرکتوری پیکربندی duplicity را فراهم می‌سازد. مقدار پیش‌فرض ~/.config/duplicity است.

--copy-blocksize kilos

امکان انتخاب اندازه بلوک بر حسب کیلوبایت را جهت استفاده در رونوشت‌برداری فراهم می‌کند. افزایش این مقدار ممکن است کپی فایل‌های بزرگ را تسریع کند. پیش‌فرض 128 است.

--compare-data

مقایسه داده‌های فایل‌های عادی را در عملیات verify فعال می‌کند. این کار یک صحت‌سنجی (verify) را همان‌گونه که در بالا تشریح شد برای بررسی درستی آرشیوهای پشتیبان انجام می‌دهد، اما افزون بر آن فایل‌های بازیابی‌شده را با فایل‌های موجود در target_directory مقایسه می‌کند. duplicity هیچ فایلی را در target_directory جایگزین نخواهد کرد. چنانچه صحت فایل‌ها به درستی تأیید نشود یا هر فایلی از آرشیو با فایل معادل آن در target_directory تفاوت داشته باشد، duplicity با یک کد خطای غیر صفر خارج می‌شود. در سطح پرگویی (verbosity) ۴ یا بالاتر، پیامی برای هر فایلی که با معادل خود در target_directory مغایرت داشته باشد ثبت خواهد شد.

--copy-links

پیوندهای نمادین (symlinks) را حین پشتیبان‌گیری دنبال و بازگشایی می‌کند. فعال‌سازی این گزینه به جای خود پیوند نمادین، داده‌های فایل/پوشه مقصد پیوند را بازگشایی و پشتیبان‌گیری می‌کند که می‌تواند به طور بالقوه حجم نسخه پشتیبان را افزایش دهد.

--dry-run

محاسبه می‌کند که چه کارهایی انجام خواهد شد، اما هیچ عملیاتی روی backend انجام نمی‌دهد.

--encrypt-key key-id

هنگام پشتیبان‌گیری، به جای استفاده از رمزگذاری متقارن (سنتی)، با کلید عمومی ارائه‌شده رمزگذاری می‌کند. می‌تواند چندین بار مشخص شود. شناسه کلید (key-id) را می‌توان در هر یک از قالب‌های پشتیبانی‌شده توسط GnuPG وارد کرد؛ برای جزئیات به gpg(1)، بخش "HOW TO SPECIFY A USER ID" مراجعه کنید.

--encrypt-secret-keyring filename

این گزینه تنها همراه با --encrypt-key قابل استفاده است، و مسیر keyring محرمانه را برای کلید رمزگذاری به filename تغییر می‌دهد. این keyring هنگام ایجاد پشتیبان استفاده نمی‌شود. در صورت عدم تعیین، از keyring محرمانه پیش‌فرض که معمولاً در .gnupg/secring.gpg قرار دارد استفاده می‌شود.

--encrypt-sign-key key-id

پارامتر تسهیل‌کننده؛ یکسان با --encrypt-key key-id --sign-key key-id.

--exclude shell_pattern

فایل یا فایل‌های منطبق بر shell_pattern را مستثنی می‌کند. اگر یک دایرکتوری مطابقت یابد، فایل‌های زیر آن دایرکتوری نیز مطابقت داده می‌شوند. برای اطلاعات بیشتر بخش FILE SELECTION را ببینید..TP --exclude-device-files استثنا کردن تمام فایل‌های دستگاه (device files). این گزینه می‌تواند به دلایل امنیتی/مجوزها یا در صورتی که duplicity فایل‌های دستگاه را به‌درستی مدیریت نمی‌کند، مفید باشد.

--exclude-filelist filename

فایل‌های فهرست‌شده در filename را مستثنی می‌کند؛ به‌طوری که هر خط از فهرست فایل‌ها مطابق با همان قوانین --include و --exclude تفسیر می‌شود. برای اطلاعات بیشتر بخش FILE SELECTION را ببینید.

--exclude-if-present filename

استثنا کردن دایرکتوری‌ها در صورت وجود filename. به کاربر امکان می‌دهد پوشه‌هایی را که مایل به پشتیبان‌گیری از آن‌ها نیست، با افزودن یک فایل مشخص (مانند “.nobackup”) به‌جای نگهداری یک فهرست جامع exclude/include، مشخص کند.

--exclude-older-than time

استثنا کردن هر فایلی که تاریخ تغییر آن قدیمی‌تر از time مشخص‌شده باشد. از این گزینه می‌توان برای ایجاد یک پشتیبان جزئی که فقط شامل فایل‌های به‌تازگی تغییریافته است استفاده کرد. برای اطلاعات بیشتر بخش TIME FORMATS را ببینید.

--exclude-other-filesystems

استثنا کردن فایل‌های روی سیستم‌های فایلی (شناسایی‌شده با شماره دستگاه) غیر از سیستم فایلی که ریشهٔ دایرکتوری منبع روی آن قرار دارد.

--exclude-regexp regexp

استثنا کردن فایل‌های منطبق با regexp داده‌شده. برخلاف گزینهٔ --exclude این گزینه با فایل‌های درون دایرکتوری‌ای که با آن تطابق یافته، مطابقت داده نمی‌شود. برای اطلاعات بیشتر بخش FILE SELECTION را ببینید.

--file-prefix prefix

--file-prefix-manifest prefix

--file-prefix-archive prefix

--file-prefix-signature prefix

--file-prefix-jsonstat prefix

--file-prefix-statistics prefix

یک پیشوند به تمام فایل‌ها یا تنها به فایل‌های manifest، archive، signature، jsonstat یا statistics اضافه می‌کند. همان مجموعه پیشوندها باید هنگام پشتیبان‌گیری و بازیابی مشخص شوند.
اگر هر دو پیشوند عمومی و ویژهٔ نوع تنظیم شده باشند، پیشوند عمومی پیش از پیشوندهای ویژهٔ نوع قرار خواهد گرفت.

همچنین ببینید A NOTE ON FILENAME PREFIXES

--files-from filename

خواندن فهرستی از فایل‌ها برای پشتیبان‌گیری از filename به‌جای جستجو در کل دایرکتوری منبع پشتیبان. سایر عملیات مانند حالت عادی است، تنها روی زیرمجموعه مشخص‌شده از دایرکتوری منبع پشتیبان انجام می‌شود.

فایل‌ها باید خط‌به‌خط و به‌صورت نسبی نسبت به دایرکتوری منبع پشتیبان مشخص شوند. هرگونه مسیر مطلق خطایی ایجاد خواهد کرد. تمام نویسه‌های هر خط معنی‌دار هستند و به‌عنوان بخشی از مسیر در نظر گرفته می‌شوند، از جمله فاصله‌های خالی ابتدا و انتهای خط. خطوط با نویسهٔ خط جدید یا null جدا می‌شوند، بسته به اینکه آیا سوئیچ --null-separator داده شده باشد یا خیر.

نیازی به گنجاندن دایرکتوری والدِ فایل‌های فهرست‌شده نیست، گنجاندن آن‌ها به‌طور ضمنی انجام می‌شود. با این حال، محتوای هر دایرکتوری که به‌صراحت فهرست شده باشد، به‌طور ضمنی گنجانده نمی‌شود. هنگام استفاده از این گزینه، تمام فایل‌های مورد نیاز باید فهرست شوند.

--filter-globbing

--filter-ignorecase

--filter-literal

--filter-regexp

--filter-strictcase

تغییر نحوهٔ تفسیر الگوهای داده‌شده به آرگومان‌های گزینه‌های شرط انتخاب فایل --exclude و --include (و گونه‌های مختلف آن‌ها، از جمله فهرست‌های فایل). این گزینه‌ها می‌توانند چندین بار برای جابجایی بین تطبیق سراسری پوسته (shell globbing، پیش‌فرض)، رشته‌های تحت‌اللفظی (literal strings) و عبارات باقاعده (regular expressions)، با حساسیت به حروف بزرگ و کوچک (پیش‌فرض) یا بدون آن، به کار روند. تفسیر مشخص‌شده برای تمام شرایط انتخاب بعدی تا گزینهٔ بعدیِ --filter اعمال می‌شود.

برای اطلاعات بیشتر بخش FILE SELECTION را ببینید.

--force

ادامه دادن حتی در صورتی که ممکن است از دست رفتن داده‌ها رخ دهد. duplicity زمانی که این گزینه لازم باشد به کاربر اطلاع خواهد داد.

--ftp-passive

استفاده از اتصالات دادهٔ غیرفعال (PASV). حالت پیش‌فرض استفاده از غیرفعال است، اما در صورت شکست اتصال غیرفعال یا اتمام مهلت زمانی، به حالت عادی بازمی‌گردد.

--ftp-regular

استفاده از اتصالات دادهٔ عادی (PORT).

--full-if-older-than time

انجام یک پشتیبان‌گیری کامل در صورتی که پشتیبان‌گیری افزایشی درخواست شده باشد، اما آخرین پشتیبان‌گیری کامل در مجموعه قدیمی‌تر از time داده‌شده باشد. برای اطلاعات بیشتر بخش TIME FORMATS را ببینید.

--full-if-n-inc number

انجام یک پشتیبان‌گیری کامل در صورتی که پشتیبان‌گیری افزایشی درخواست شده باشد، اما آخرین زنجیرهٔ پشتیبان‌گیری در حال حاضر دارای number یا بیشتر نسخهٔ پشتیبان افزایشی باشد.

--gio

استفاده از بک‌اند GIO و تفسیر هر URL همانند GIO.

-h, --help, --usage

چاپ یک پیام راهنما و خروج.

--gpg-binary file_path

به شما امکان می‌دهد duplicity را مجبور کنید تا از file_path به‌عنوان باینری خط فرمان gpg استفاده کند. می‌تواند یک مسیر فایل مطلق یا نسبی یا نام یک فایل باشد. مقدار پیش‌فرض 'gpg' است. باینری از طریق متغیر محیطی PATH پیدا خواهد شد.

--gpg-options='options'

به شما امکان می‌دهد گزینه‌ها را به رمزنگاری gpg ارسال کنید. فهرست options باید به شکل '--opt1 --opt2=val2' باشد، که در آن رشته نقل‌قول شده و تنها فاصله‌های مجاز بین گزینه‌ها هستند.

نکته: مقدار این گزینه باید با '=' متصل شود، مانند:

--gpg-options='--gpg-option=value'

برای جزئیات بیشتر بخش ARGPARSE PROBLEM را ببینید..TP --hidden-encrypt-key key-id همانند --encrypt-key است، اما شناسه کلید کاربر را از فایل رمزگذاری‌شده پنهان می‌کند. این گزینه از فرمان --hidden-recipient در gpg برای مبهم‌سازی مالک پشتیبان استفاده می‌کند. هنگام بازیابی، gpg به‌طور خودکار تمام کلیدهای مخفی موجود را برای رمزگشایی پشتیبان امتحان خواهد کرد. برای جزئیات بیشتر gpg(1) را ببینید.

--ignore-errors

تلاش برای نادیده‌گرفتن خطاهای خاص در صورت وقوع. این گزینه تنها برای این منظور در نظر گرفته شده است که امکان بازیابی یک نسخه پشتیبان را در مواجهه با مشکلات خاصی که در غیر این صورت منجر به شکست پشتیبان‌گیری می‌شوند، فراهم کند. استفاده از این گزینه هرگز توصیه نمی‌شود، مگر اینکه در شرایطی باشید که سعی در بازیابی از پشتیبان دارید و عملیات به دلیل مشکلی که می‌خواهید duplicity آن را نادیده بگیرد با شکست مواجه می‌شود. حتی در این صورت نیز بسته به نوع مشکل، این گزینه ممکن است بی‌اثر باشد.

لطفاً توجه داشته باشید در حالی که خطاهای نادیده‌گرفته‌شده ثبت می‌شوند، هیچ خلاصه‌ای در پایان عملیات برای اعلام مواردی که احیاناً نادیده گرفته شده‌اند ارائه نخواهد شد. اگر از این گزینه برای بازیابی اضطراری داده‌ها استفاده می‌شود، توصیه می‌شود پشتیبان را به‌گونه‌ای اجرا کنید که بتوانید گزارش لاگ آن را بازبینی کنید (به دنبال خطوط حاوی رشته IGNORED_ERROR بگردید).

اگر مجبور شدید به دلایلی که برایتان نامشخص است یا مشخص است ولی در حیطه مسئولیت شما نیست از این گزینه استفاده کنید، لطفاً با نگه‌دارندگان duplicity تماس بگیرید. نیاز به استفاده از این گزینه در محیط‌های عملیاتی معمولاً یک باگ تلقی می‌شود.

--imap-full-address email_address

نشانی کامل ایمیل برای نام کاربری هنگام ورود به سرور imap. در صورت عدم ارائه، تنها بخش نام کاربری نشانی ایمیل استفاده می‌شود.

--imap-mailbox option

امکان مشخص‌کردن یک صندوق پستی (mailbox) متفاوت را فراهم می‌کند. پیش‌فرض "INBOX" است. زبان‌های دیگر ممکن است به صندوق پستی متفاوتی نسبت به مقدار پیش‌فرض نیاز داشته باشند.

--idr-fakeroot

سرویس idrived از مفهوم دایرکتوری "fakeroot" استفاده می‌کند که از طریق سوئیچ --idr-fakeroot=... تعریف می‌شود. این می‌تواند یک دایرکتوری موجود باشد، یا اینکه دایرکتوری در زمان اجرا بر روی ریشه سیستم فایل (میزبان) ایجاد شود. (هشدار: شما باید دسترسی نوشتن به ریشه را داشته باشید!). دایرکتوری‌های ایجادشده در زمان اجرا، هنگام خروج به‌طور خودکار حذف می‌شوند!
بنابراین در طرح بالا، می‌توانیم این‌گونه عمل کنیم:
duplicity --idr-fakeroot=nicepath idrived://DUPLICITY
فایل‌های ما در نهایت در این مسیر قرار می‌گیرند:
<MYBUCKET>/DUPLICITY/nicepath

--include shell_pattern

مشابه --exclude است، اما در عوض فایل‌های منطبق را شامل (include) می‌کند. برعکس --exclude، این گزینه دایرکتوری‌های والد فایل‌های منطبق را نیز مطابقت می‌دهد (اگرچه لزوماً محتوای آن‌ها را شامل نمی‌شود). برای اطلاعات بیشتر بخش FILE SELECTION را ببینید.

--include-filelist filename

مانند --exclude-filelist است، اما در عوض فایل‌های فهرست‌شده را شامل می‌کند. برای اطلاعات بیشتر بخش FILE SELECTION را ببینید.

--include-regexp regexp

شامل کردن فایل‌های منطبق با عبارت باقاعده regexp. تنها فایل‌هایی که صراحتاً توسط regexp تطبیق داده شوند توسط این گزینه لحاظ خواهند شد. برای اطلاعات بیشتر بخش FILE SELECTION را ببینید.

--jsonstat

ثبت داده‌های آماری مشابه آمارهای پیش‌فرضی که در انتهای یک عملیات پشتیبان‌گیری چاپ می‌شود؛ علاوه بر این، شامل برخی فراداده‌ها درباره زنجیره پشتیبان است، مانند اینکه چه زمانی پشتیبان کامل ایجاد شده و چه تعداد پشتیبان افزایشی پیش از آن گرفته شده است. قالب خروجی json است. این داده‌ها با سطح notice در stdout نوشته می‌شوند (مانند آمارهای کلاسیک) و آمارها به عنوان یک فایل مجزا در کنار manifest اما با پسوند "jsonstat" نگهداری می‌شوند. collection-status --show-changes-in-set <index> --jsonstat داده‌های جمع‌آوری‌شده در عملیات پشتیبان را اضافه کرده و قالب خروجی را به json تغییر می‌دهد. اگر <index> روی -1 تنظیم شود، آمار کل زنجیره پشتیبان چاپ می‌شود.

--log-fd number

نوشتن نسخه‌های با قالب‌بندی ویژه از پیام‌های خروجی در توصیف‌کننده فایل (file descriptor) مشخص‌شده. قالب استفاده‌شده به گونه‌ای طراحی شده است که به آسانی توسط سایر برنامه‌ها پردازش‌پذیر باشد.

--log-file filename

نوشتن نسخه‌های با قالب‌بندی ویژه از پیام‌های خروجی در فایل مشخص‌شده. قالب استفاده‌شده به گونه‌ای طراحی شده است که به آسانی توسط سایر برنامه‌ها پردازش‌پذیر باشد.

--log-timestamp

نوشتن لاگ به همراه برچسب زمان (timestamp) و سطح لاگ پیش از متن پیام، مشابه syslog.

--max-blocksize number

حداکثر اندازه بلوک‌های بررسی‌شده برای تغییرات در طول فرآیند diff را محدود می‌کند.

به‌طور پیش‌فرض، ریشه دوم صحیح طول فایل به عنوان اندازه بلوک librsync استفاده می‌شود. حداقل مقدار ۵۱۲ بایت است و حداکثری ندارد مگر اینکه --max-blocksize مشخص شود. اندازه بلوک به سمت بالا و به نزدیک‌ترین مرز ۵۱۲ بایتی گرد می‌شود.

اگر max_blocksize بزرگ‌تری تعیین کنید، فایل‌های difftar شما بزرگ‌تر و فایل‌های sigtar کوچک‌تر خواهند شد. اگر max_blocksize کوچک‌تری مشخص کنید، عکس این حالت رخ می‌دهد.

گزینه --max-blocksize باید مضربی از ۵۱۲ باشد.

حداکثر اندازه بلوک به‌طور پیش‌فرض تعیین‌نشده است.

--mf-purge

گزینه‌ای برای mediafire جهت پاک‌سازی قطعی فایل‌ها هنگام حذف، به جای انتقال آن‌ها به سطل زباله.

--mp-segment-size megs

اندازه قطعه (segment size) در پسانه Swift بر حسب مگابایت.

--name symbolicname

تنظیم نام نمادین پشتیبانی که عملیات روی آن در حال انجام است. هدف این است که برای هر نسخه پشتیبانِ از نظر منطقی مجزا، یک نام جداگانه استفاده شود. برای نمونه، ممکن است فردی از "home_daily_s3" برای پشتیبان‌گیری روزانه دایرکتوری خانگی به Amazon S3 استفاده کند. ساختار نام به عهده کاربر است، و تنها متمایز بودن نام‌ها اهمیت دارد. این نام نمادین در حال حاضر تنها بر باز شدن (expansion) --archive-dir اثر می‌گذارد، اما ممکن است در آینده برای ویژگی‌های بیشتری به کار رود. به کاربرانی که بیش از یک نسخه پشتیبان متمایز را اجرا می‌کنند توصیه می‌شود از این گزینه استفاده کنند.

در صورت عدم تعیین، مقدار پیش‌فرض یک درهم‌سازی (hash) از URL پسانه خواهد بود.

--no-check-remote

غیرفعال‌سازی اعتبارسنجی manifest راه دور. بررسی این مورد پیش‌فرض است. عدم بررسی به شما اجازه می‌دهد بدون کلید خصوصی پشتیبان‌گیری کنید، اما به این معنی خواهد بود که manifest راه دور ممکن است وجود داشته و مخدوش باشد، که این امر احتمال غیرقابل‌بازیابی بودن پشتیبان را به همراه دارد.

--no-compression

عدم استفاده از GZip برای فشرده‌سازی فایل‌ها در سیستم راه دور.

--no-encryption

عدم استفاده از GnuPG برای رمزگذاری فایل‌ها در سیستم راه دور.

--no-files-changed

به‌طور پیش‌فرض duplicity نام فایل‌ها و اقدامات تغییر (add، del، chg) را حین پشتیبان‌گیری در حافظه جمع‌آوری می‌کند. این کار می‌تواند حافظه بسیار زیادی مصرف کند، به‌ویژه در حضور میلیون‌ها فایل کوچک. این پرچم آن جمع‌آوری را غیرفعال می‌کند. این بدان معناست که گزینه --file-changed برای collection-status هیچ چیزی برنمی‌گرداند.

--no-print-statistics

به‌طور پیش‌فرض duplicity پس از یک پشتیبان‌گیری موفق، آماری را درباره نشست فعلی چاپ می‌کند. این سوئیچ آن رفتار را غیرفعال می‌سازد.

--no-restore-ownership

شناسه کاربری/گروهی (uid/gid) را از آرشیو نادیده می‌گیرد و مشخصات کاربر فعلی را حفظ می‌کند. استفاده از این گزینه برای بازیابی داده‌ها به سیستم فایل‌های متصل‌شده‌ای (mounted) که از مالکیت یونیکس پشتیبانی نمی‌کنند، یا زمانی که دسترسی‌های ریشه (root) در دسترس نیست، توصیه می‌شود..TP --null-separator استفاده از نویسه‌های تهی (\0) به جای خطوط جدید (\n) به‌عنوان جداکننده خط، که ممکن است هنگام کار با نام‌فایل‌های حاوی خط جدید مفید باشد. این گزینه بر قالب مورد انتظار فایل‌های مشخص‌شده با سوئیچ‌های --{include|exclude}-filelist و گزینه --{files-from} و همچنین قالب فایل آمار دایرکتوری تأثیر می‌گذارد.

--numeric-owner

هنگام بازیابی، همیشه از uid/gid عددی موجود در بایگانی استفاده می‌کند و نه نام‌های کاربر/گروه بایگانی‌شده که رفتار پیش‌فرض است. برای بازیابی از دیسک‌های زنده (Live CD) که ممکن است کاربرانی با نام‌های یکسان ولی uid/gid متفاوت داشته باشند، توصیه می‌شود.

--num-retries number

تعداد دفعات تلاش مجدد در صورت بروز خطا، پیش از انصراف.

--par2-options='options'

گزینه‌های عین به عین (verbatim) برای ارسال به par2.

نکته: مقدار این گزینه باید با '=' متصل شود، مانند:

--par2-options='-a -b'

برای جزئیات بیشتر به ARGPARSE PROBLEM مراجعه کنید.

--par2-redundancy percent

تنظیم سطح افزونگی برحسب percent (درصد) برای فایل‌های بازیابی Par2 (پیش‌فرض ۱۰٪).

--par2-volumes number

تعداد جلدهای Par2 برای ایجاد (پیش‌فرض ۱).

--path-to-restore path

این گزینه ممکن است در حالت بازیابی مشخص شود و باعث می‌شود به جای کل محتوای بایگانی پشتیبان، تنها path بازیابی شود. path باید به صورت نسبی نسبت به ریشه دایرکتوری پشتیبان‌گیری‌شده داده شود.

--progress

در صورت انتخاب، duplicity پیشرفت فعلی بارگذاری و زمان تخمینی بارگذاری را نمایش می‌دهد. برای برآورد تغییرات، ابتدا یک اجرای آزمایشی (dry-run) را قبل از پشتیبان‌گیری کامل یا افزایشی انجام داده و سپس عملیات واقعی را همراه با تخمین پیشرفت واقعی بارگذاری اجرا می‌کند.

--progress-rate number

نرخ به‌روزرسانی پیام‌های پیشرفت بارگذاری توسط duplicity را تعیین می‌کند (نیازمند گزینه --progress است). پیش‌فرض، چاپ وضعیت در هر ۳ ثانیه است.

--rename <original path> <new path>

با مسیر orig در پشتیبان به‌گونه‌ای رفتار می‌کند که گویی مسیر new است. می‌تواند چندین بار داده شود. یک مثال:

duplicity restore --rename Documents/metal Music/metal sftp://uid@other.host/some_dir /home/me

--rsync-options='options'

امکان ارسال گزینه‌ها به بک‌اند rsync را فراهم می‌کند. فهرست options باید به صورت "opt1=parm1 opt2=parm2" باشد که در آن رشته گزینه در نقل‌قول قرار گرفته و تنها فاصله مجاز، بین گزینه‌ها است. رشته گزینه پس از هر گزینه ایجادشده داخلی برای تعیین درگاه راه دور، عیناً به rsync فرستاده می‌شود. این یک مثال احتمالاً مفید است:

duplicity --rsync-options="--partial-dir=.rsync-partial" /home/me rsync://uid@other.host/some_dir

نکته: مقدار این گزینه باید با '=' متصل شود، مانند:

--rsync-options='--partial-dir=.rsync-partial'

برای جزئیات بیشتر به ARGPARSE PROBLEM مراجعه کنید.

--s3-endpoint-url url

نشانی URL نقطه پایانی (endpoint URL) فضای ذخیره‌سازی S3 را مشخص می‌کند.

--s3-multipart-chunk-size

اندازه قطعه (به مگابایت، پیش‌فرض 20MB) مورد استفاده برای بارگذاری‌های چندبخشی S3. این مقدار را برای بیشینه‌سازی بهره‌وری از پهنای باند تنظیم کنید. برای مثال، اندازه قطعه 10MB و مقدار volsize برابر با 100MB منجر به ۱۰ قطعه در هر بارگذاری جلد می‌شود.

نکته: این مقدار برای کارایی بهینه ترجیحاً باید مضرب صحیحی از --volsize شما باشد.

همچنین به A NOTE ON AMAZON S3 در زیر مراجعه کنید.

--s3-multipart-max-procs

حداکثر تعداد بارگذاری‌های هم‌روند هنگام انجام بارگذاری چندبخشی. پیش‌فرض ۴ است. می‌توانید این عدد را برای بیشینه‌سازی بهره‌وری از پهنای باند و پردازنده تنظیم کنید.

نکته: بارگذاری‌های هم‌روندِ بیش از اندازه ممکن است بازدهی نزولی داشته باشد.

همچنین به A NOTE ON AMAZON S3 در زیر مراجعه کنید.

--s3-region-name

منطقه (region) فضای ذخیره‌سازی S3 را مشخص می‌کند. معمولاً در صورتی که باکت در منطقه خاصی ساخته شده باشد، اجباری است.

--s3-unencrypted-connection

غیرفعال کردن SSL برای اتصالات به S3. این کار ممکن است سرعت را به میزان چشمگیری افزایش دهد، اما به بهای کاهش محرمانگی اطلاعات است.

با فعال بودن این گزینه، هر کسی میان رایانه شما و S3 می‌تواند ترافیک را پایش کند و قادر خواهد بود بفهمد: شما از Duplicity استفاده می‌کنید، نام باکت، شناسه AWS Access Key ID شما، تاریخ‌های پشتیبان‌های افزایشی و حجم داده‌ها در هر مرحله افزایشی.

این گزینه تنها بر اتصال تأثیر می‌گذارد، نه بر رمزنگاری GPG فایل‌های افزایشی پشتیبان. مگر اینکه آن هم غیرفعال شده باشد، یک ناظر قادر به دیدن نام یا محتوای فایل‌ها نخواهد بود.

همچنین به A NOTE ON AMAZON S3 در زیر مراجعه کنید.

--s3-use-deep-archive

ذخیره‌سازی جلدها با استفاده از Glacier Deep Archive S3 هنگام بارگذاری در Amazon S3. این کلاس ذخیره‌سازی هزینه نگهداری کمتری دارد اما هزینه هر درخواست آن بیشتر است و از زمان ارسال درخواست بازیابی، تأخیرهایی تا ۴۸ ساعت به همراه دارد. این هزینه ذخیره‌سازی بر پایه حداقل دوره نگهداری ۱۸۰ روزه محاسبه می‌شود. طبق گفته Amazon این فضا با ارائه پایایی ۹۹٫۹۹۹۹۹۹۹۹۹٪ برای بایگانی داده‌ها و پشتیبان‌گیری بلندمدت ایده‌آل است. برای بازیابی یک نسخه پشتیبان، باید تمام داده‌های ذخیره‌شده در AWS Glacier Deep Archive را به صورت دستی به Standard S3 بازگردانید و منتظر بمانید تا AWS عملیات انتقال را تکمیل کند.

نکته: ابزار Duplicity فایل‌های manifest.gpg و sigtar.gpg مربوط به پشتیبان‌های کامل و افزایشی را در فضای ذخیره‌سازی استاندارد AWS S3 نگهداری می‌کند تا بازیابی سریع را برای پشتیبان‌های افزایشی بعدی میسر سازد؛ بقیه داده‌ها در S3 Glacier Deep Archive ذخیره می‌شوند.

--s3-use-glacier

ذخیره‌سازی جلدها با استفاده از Glacier Flexible Storage هنگام بارگذاری در Amazon S3. این کلاس ذخیره‌سازی هزینه نگهداری کمتری دارد اما هزینه هر درخواست آن بیشتر است و از زمان ارسال درخواست بازیابی، تأخیرهایی تا ۱۲ ساعت به همراه دارد. این هزینه ذخیره‌سازی بر پایه حداقل دوره نگهداری ۹۰ روزه محاسبه می‌شود. طبق گفته Amazon این فضا با ارائه پایایی ۹۹٫۹۹۹۹۹۹۹۹۹٪ برای بایگانی داده‌ها و پشتیبان‌گیری بلندمدت ایده‌آل است. برای بازیابی یک نسخه پشتیبان، باید تمام داده‌های ذخیره‌شده در AWS Glacier را به صورت دستی به Standard S3 بازگردانید و منتظر بمانید تا AWS عملیات انتقال را تکمیل کند.

نکته: ابزار Duplicity فایل‌های manifest.gpg و sigtar.gpg مربوط به پشتیبان‌های کامل و افزایشی را در فضای ذخیره‌سازی استاندارد AWS S3 نگهداری می‌کند تا بازیابی سریع را برای پشتیبان‌های افزایشی بعدی میسر سازد؛ بقیه داده‌ها در S3 Glacier ذخیره می‌شوند.

--s3-use-glacier-ir

ذخیره‌سازی جلدها با استفاده از Glacier Instant Retrieval هنگام بارگذاری در Amazon S3. این کلاس ذخیره‌سازی مشابه Glacier Flexible Storage است اما امکان بازیابی آنی با سرعت‌های استاندارد را فراهم می‌کند.

نکته: ابزار Duplicity فایل‌های manifest.gpg و sigtar.gpg مربوط به پشتیبان‌های کامل و افزایشی را در فضای ذخیره‌سازی استاندارد AWS S3 نگهداری می‌کند تا بازیابی سریع را برای پشتیبان‌های افزایشی بعدی میسر سازد؛ بقیه داده‌ها در S3 Glacier ذخیره می‌شوند..TP --s3-use-ia ذخیره جلدها با استفاده از Standard - Infrequent Access هنگام بارگذاری در Amazon S3. این کلاس ذخیره‌سازی هزینه نگهداری کمتری دارد اما هزینه به ازای هر درخواست آن بیشتر است، و هزینه ذخیره‌سازی بر اساس حداقل دوره نگهداری ۳۰ روزه محاسبه می‌شود. طبق اعلام Amazon، این کلاس ذخیره‌سازی برای نگهداری طولانی‌مدت فایل‌ها، پشتیبان‌گیری‌ها و بازیابی پس از سانحه ایده‌آل است.

--s3-use-onezone-ia

ذخیره جلدها با استفاده از One Zone - Infrequent Access هنگام بارگذاری در Amazon S3. این ذخیره‌سازی مشابه Standard - Infrequent Access است، اما داده‌های شیء را تنها در یک Availability Zone ذخیره می‌کند.

--s3-use-rrs

ذخیره جلدها با استفاده از Reduced Redundancy Storage هنگام بارگذاری در Amazon S3. این کار هزینه ذخیره‌سازی را کاهش می‌دهد اما پایایی (durability) جلدهای ذخیره‌شده را به جای پایداری ۹۹٫۹۹۹۹۹۹۹۹۹٪ ارائه‌شده توسط Standard Storage در S3، به ۹۹٫۹۹٪ کاهش می‌دهد.

--s3-use-server-side-encryption

فعال‌سازی رمزگذاری سمت سرور.

--s3-use-server-side-kms-encryption

--s3-kms-key-id key_id

--s3-kms-grant grant

فعال‌سازی رمزگذاری سمت سرور با استفاده از سرویس مدیریت کلید (key management service).

--skip-if-no-change command

به‌طور پیش‌فرض، اگر هیچ فایلی تغییر نکرده باشد، یک پشتیبان افزایشی خالی ایجاد می‌شود. تنظیم این گزینه در صورتی که هیچ داده‌ای تغییر نکرده باشد، از ایجاد پشتیبان صرف‌نظر می‌کند. هیچ داده‌ای به مقصد ارسال نخواهد شد و اطلاعاتی نیز کَش نمی‌شود.

--scp-command command

(تنها در ssh pexpect backend با فعال بودن --use-scp)

--sftp-command command

(تنها در ssh pexpect backend)

--sign-key key-id

این گزینه می‌تواند هنگام پشتیبان‌گیری، بازیابی یا اعتبارسنجی (verifying) استفاده شود. هنگام پشتیبان‌گیری، تمامی فایل‌های پشتیبان با شناسه کلید key امضا خواهند شد. هنگام بازیابی، duplicity در صورتی که هر فایل دوردست با key-id مشخص‌شده امضا نشده باشد، یک خطا صادر خواهد کرد. key-id را می‌توان در هر یک از قالب‌های پشتیبانی‌شده توسط GnuPG ارائه داد؛ برای جزئیات به gpg(1)، بخش "HOW TO SPECIFY A USER ID" مراجعه کنید. این گزینه باید تنها یک بار مشخص شود، زیرا در حال حاضر تنها از یک کلید امضا پشتیبانی می‌شود. آخرین ورودی، بر تمام ورودی‌های دیگر اولویت دارد.
همچنین بخش A NOTE ON SYMMETRIC ENCRYPTION AND SIGNING را ببینید.

--ssh-askpass

به ssh backend می‌گوید در صورتی که گذرواژه در url مقصد تعریف نشده باشد و هیچ متغیر محیطی BACKEND_PASSWORD تنظیم نشده باشد، از کاربر برای گذرواژه سیستم ریموت درخواست کند. این گذرواژه همچنین برای کلیدهای ssh محافظت‌شده با عبارت عبور (passphrase) استفاده می‌شود.

--ssh-options='options'

امکان ارسال گزینه‌ها را به ssh backend فراهم می‌کند. می‌تواند چندین بار یا به صورت فهرستی از گزینه‌ها که با فاصله از هم جدا شده‌اند مشخص شود. فهرست options باید به شکل "-oOpt1='parm1' -oOpt2='parm2'" باشد که در آن رشته گزینه در نقل‌قول قرار گرفته و تنها فاصله‌های مجاز، بین گزینه‌ها است. رشته گزینه عیناً به هر دو دستور scp و sftp ارسال خواهد شد؛ از آنجا که نحو خط فرمان آن‌ها کمی متفاوت است، بنابراین گزینه‌ها باید در قالب گزینه طولانی شرح‌داده‌شده در ssh_config(5) داده شوند.
مثال برای یک فهرست:

--ssl-cacert-file file

(تنها در webdav backend و lftp backend) ارائه یک فایل cacert برای اعتبارسنجی گواهی ssl.

همچنین بخش A NOTE ON SSL CERTIFICATE VERIFICATION را ببینید.

--ssl-cacert-path path/to/certs/

(تنها در webdav backend با پایتون 2.7.9+ یا lftp+webdavs و یک نسخه جدید lftp) ارائه مسیری به یک پوشه حاوی فایل‌های cacert برای اعتبارسنجی گواهی ssl.

همچنین بخش A NOTE ON SSL CERTIFICATE VERIFICATION را ببینید.

--ssl-no-check-certificate

(تنها در webdav backend و lftp backend) غیرفعال‌سازی اعتبارسنجی گواهی ssl.

همچنین بخش A NOTE ON SSL CERTIFICATE VERIFICATION را ببینید.

--swift-storage-policy

استفاده از این خط‌مشی ذخیره‌سازی هنگام کار روی مخازن Swift.

همچنین بخش A NOTE ON SWIFT (OPENSTACK OBJECT STORAGE) ACCESS را ببینید.

--metadata-sync-mode mode

مقدار پیش‌فرض این گزینه 'partial' است، اما می‌توانید آن را روی 'full' تنظیم کنید

برای جلوگیری از همگام‌سازی فراداده برای زنجیره‌های پشتیبانی که قصد استفاده از آن‌ها را ندارید، از 'partial' استفاده کنید. این کار در زمان بازیابی برای اولین بار صرفه‌جویی می‌کند و به شما امکان می‌دهد تنها با ارائه عبارت عبور مقصد، یک پشتیبان قدیمی را که با عبارت عبور متفاوتی رمزگذاری شده بود، بازیابی کنید.

برای همگام‌سازی فراداده تمام زنجیره‌های پشتیبان در مقصد ریموت، از 'full' استفاده کنید..TP --tempdir directory استفاده از این دایرکتوری موجود برای فایل‌های موقت duplicity به جای پیش‌فرض سیستم، که معمولاً دایرکتوری /tmp است. این گزینه بر هر متغیر محیطی اولویت دارد.

همچنین ببینید ENVIRONMENT VARIABLES.

-t time, --time time, --restore-time time

مشخص کردن زمانی که فایل‌ها از آن بازیابی یا فهرست می‌شوند.

برای جزئیات به بخش TIME FORMATS مراجعه کنید.

--time-separator char

استفاده از char به‌عنوان جداکننده زمان در نام فایل‌ها به جای دونقطه (":").

نکته: این گزینه تنها برای عملیات‌های از نوع بازیابی (recovery) و وضعیت (status) اعمال می‌شود. ما دیگر نام فایل‌هایی با جداکننده زمان ایجاد نکرده یا نمی‌نویسیم، اما نسخه‌های پشتیبان قدیمی‌تری را که ممکن است به این گزینه نیاز داشته باشند، خواهیم خواند.

--timeout seconds

استفاده از seconds به‌عنوان مقدار زمان انتظار (timeout) سوکت در صورتی که duplicity در طول عملیات‌های شبکه با پایان مهلت زمانی مواجه شود. پیش‌فرض ۳۰ ثانیه است.

--use-agent

اگر این گزینه مشخص شود، آنگاه --use-agent به فرآیند رمزنگاری GnuPG ارسال می‌شود و در صورت نیاز، پیش از درخواست عبارت عبور برای --encrypt-key یا --sign-key، تلاش می‌کند به gpg-agent متصل شود.

نکته: برخلاف نسخه‌های پیشین duplicity، این گزینه توسط GnuPG 2 و نسخه‌های جدیدتر نیز رعایت خواهد شد. اگر GnuPG 2 در حال استفاده باشد، duplicity گزینه --pinentry-mode=loopback را به فرآیند gpg ارسال می‌کند مگر اینکه --use-agent در خط فرمان duplicity مشخص شده باشد. این امر باعث می‌شود که GnuPG 2 درست مانند GnuPG 1، تنها در صورت ارائه شدن --use-agent از agent استفاده کند.

--use-gpgsm

اگر این گزینه مشخص شود، فرآیند رمزنگاری GnuPG به جای gpg از باینری gpgsm استفاده می‌کند. این باینری بخشی از مجموعه GnuPG است، اما از قالب فایل Cryptographic Message Syntax (یا CMS؛ همچنین با عنوان PKCS#7 نیز شناخته می‌شود، که با ابزارهای دیگری مانند openssl smime نیز سازگار است) استفاده می‌کند.

فایل‌های رمزگذاری‌شده به جای پسوند .gpg، دارای پسوند .p7m خواهند بود. هر عملیاتی که نیاز به رمزگشایی داشته باشد (مانند restore،‏ list-current-files و غیره) نیز باید --use-gpgsm را مشخص کند.

ابزار gpgsm از رمزنگاری متقارن (گذرواژه) یا گیرندگان پنهان پشتیبانی نمی‌کند.

--verbosity level, -vlevel

مشخص کردن سطح پرگویی خروجی (سطح لاگ). سطوح نام‌گذاری‌شده و مقادیر متناظر عبارتند از: 0 Error (خطا)، 2 Warning (هشدار)، 4 Notice (اعلان - پیش‌فرض)، 8 Info (اطلاعات)، 9 Debug (اشکال‌زدایی - پرجزئیات‌ترین).
مقدار level همچنین می‌تواند این موارد باشد:

گزینه‌های -v4،‏ -vn و -vnotice از نظر عملکردی معادلند، همان‌طور که نسخه‌های ترکیبی/حروف بزرگ -vN،‏ -vNotice و -vNOTICE نیز معادل یکدیگر هستند.

--version

نمایش نسخه duplicity و خروج.

--volsize number

تغییر اندازه حجم (volume) به number مگابایت. پیش‌فرض 200MB است.

--webdav-headers csv formatted key,value pairs

قالب ورودی، فهرستی از جفت‌های key,value جداشده با کاما است. می‌توان از قالب استاندارد CSV استفاده کرد.

برای مثال برای تنظیم یک Cookie از 'Cookie,name=value' یا '"Cookie","name=value"' استفاده کنید.

می‌توانید چندین سرآیند را مشخص کنید، مانند '"Cookie","name=value","Authorization","xxx"'..SH "متغیرهای محیطی (ENVIRONMENT VARIABLES)"

TMPDIR, TEMP, TMP

به ترتیب نزولی اولویت، دایرکتوری مورد استفاده برای فایل‌های موقت را مشخص می‌کنند (به ارث رسیده از ماژول tempfile در Python). در نهایت، گزینه --tempdir بر هر یک از این موارد تقدم دارد.

BACKEND_PASSWORD, FTP_PASSWORD (deprecated)

توسط اکثر backendهایی که از گذرواژه پشتیبانی می‌کنند، پذیرفته می‌شود. این روش امن‌تر از وارد کردن آن در URL مربوط به backend است (که ممکن است در فهرست فرایندهای سیستم‌عامل برای سایر کاربران همان ماشین قابل مشاهده باشد).

PASSPHRASE

این عبارت عبور به GnuPG منتقل می‌شود. اگر این متغیر تنظیم نشده باشد، عبارت عبور از کاربر درخواست خواهد شد. GPG برای رمزنگاری عبارت عبور از روش رمزنگاری AES استفاده می‌کند.

SIGN_PASSPHRASE

عبارت عبوری که برای --sign-key استفاده می‌شود. اگر تعیین نشود و کلید امضا هم‌زمان یکی از کلیدهای رمزنگاری نیز باشد، PASSPHRASE به جای آن دوباره استفاده خواهد شد. در غیر این صورت، چنانچه عبارت عبور لازم باشد ولی تنظیم نشده باشد، از کاربر درخواست می‌شود. GPG برای رمزنگاری عبارت عبور از روش رمزنگاری AES استفاده می‌کند.

ممکن است متغیرهای محیطی دیگری نیز برای پیکربندی backendهای خاص استفاده شوند. یادداشت‌های مربوط به backend مورد نظر را مشاهده کنید.

1.

رمزنگاری متقارن (حالت پیش‌فرض، در صورتی که هیچ‌یک از --encrypt-key یا --no-encryption استفاده نشده باشد).

2.

رمزنگاری نامتقارن (با استفاده از --encrypt-key ) برای عملیات‌های restore، verify و cleanup ، زیرا این عملیات‌ها به رمزگشایی با استفاده از کلید خصوصی نیاز دارند.

3.

هنگام امضای پشتیبان‌ها با استفاده از --sign-key.

1.

استفاده از --no-encryption.

2.

رمزنگاری نامتقارن (با استفاده از --encrypt-key ) برای عملیات‌های پشتیبان‌گیری full و inc (مگر اینکه --sign-key نیز استفاده شده باشد)، چرا که برای رمزنگاری تنها کلید عمومی لازم است.

3.

عملیات‌هایی که بدون رمزگشایی فقط به فراداده‌ها دسترسی دارند یا پشتیبان‌ها را مدیریت می‌کنند: collection-status، list-current-files، remove-all-but-n-full، remove-all-inc-of-but-n-full و remove-older-than.

scheme://[[user[:password]@]host[:port]/][/]path

scheme://[/]path

[Login]
Username = MEGA_USERNAME
Password = MEGA_PASSWORD

--exclude
--exclude-device-files
--exclude-if-present
--exclude-filelist
--exclude-regexp
--include
--include-filelist
--include-regexp

duplicity --include /usr --exclude /usr /usr scp://user@host/backup

duplicity /usr scp://user@host/backup

duplicity --include /usr/local/bin --exclude /usr/local /usr scp://user@host/backup

--filter-globbing
--filter-literal
--filter-regexp

--filter-ignorecase
--filter-strictcase

--filter-ignorecase --include /usr/bin/*.PY --filter-literal --filter-include /usr/bin/special?file*name --filter-strictcase --exclude /usr/bin

--exclude /usr/local

--include /usr/local

--include ignorecase:'/usr/[a-z0-9]foo/*/**.py'

/usr/local
- /usr/local/doc
/usr/local/bin
+ /var
- /var

dir/foo
+ dir/bar
- **

--include-regexp '[0-9]{7}(?!foo)'

AWS_ACCESS_KEY_ID
AWS_SECRET_ACCESS_KEY

AWS_ACCESS_KEY_ID=<key_id> AWS_SECRET_ACCESS_KEY=<access_key> duplicity /some/path s3:///<bucket>/<subfolder>

[default]
aws_access_key_id = <key_id>
aws_secret_access_key = <access_key>

AWS_REQUEST_CHECKSUM_CALCULATION=when_required
AWS_RESPONSE_CHECKSUM_VALIDATION=when_required

[default]
request_checksum_calculation = when_required
response_checksum_validation = when_required

1.

نام کانتینر باید با یک حرف یا عدد شروع شود و تنها می‌تواند شامل حروف، اعداد و نویسهٔ خط تیره (-) باشد.

2.

هر نویسهٔ خط تیره (-) باید دقیقاً قبل و بعد از یک حرف یا عدد قرار گیرد؛ خط تیره‌های متوالی در نام کانتینر مجاز نیستند.

3.

تمام حروف در نام کانتینر باید حروف کوچک باشند.

4.

طول نام کانتینر باید بین ۳ تا ۶۳ نویسه باشد.

mf://duplicity%40example.com@mediafire.com/some_folder

multi:///path/to/config.json?mode=mirror&onfail=abort
multi:///path/to/config.json?mode=stripe&onfail=continue
multi:///path/to/config.json?onfail=abort&mode=stripe
multi:///path/to/config.json?onfail=abort

[
 {
  "description": "a comment about the backend"
  "url": "abackend://myuser@domain.com/backup",
  "env": [
    {
     "name" : "MYENV",
     "value" : "xyz"
    },
    {
     "name" : "FOO",
     "value" : "bar"
    }
   ],
   "prefixes": ["prefix1_", "prefix2_"]
 },
 {
  "url": "file:///path/to/dir"
 }
]

client_config_backend: settings
client_config:
    client_id: <Client ID from developers' console>
    client_secret: <Client secret from developers' console>
save_credentials: True
save_credentials_backend: file
save_credentials_file: <filename to cache credentials>
get_refresh_token: True

slate://[slate-id]

duplicity full . "slate://6920df43-5c3w-2x7i-69aw-2390567uav75"

~/.duplicity/cacert.pem
~/duplicity_cacert.pem
/etc/duplicity/cacert.pem

SWIFT_USERNAME (الزامی)،
SWIFT_PASSWORD (الزامی)،
SWIFT_AUTHURL (الزامی)،
SWIFT_TENANTID یا SWIFT_TENANTNAME (با SWIFT_AUTHVERSION=2 الزامی است؛ همچنین می‌تواند به صورت جایگزین در SWIFT_USERNAME مانند SWIFT_USERNAME="tenantname:user" تعریف شود)،
SWIFT_PROJECT_ID یا SWIFT_PROJECT_NAME (با SWIFT_AUTHVERSION=3 الزامی است)،
SWIFT_USERID (اختیاری، تنها برای IBM Bluemix ObjectStorage الزامی است)،
SWIFT_REGIONNAME (اختیاری).

XORRISO_PATH، تعیین یک مسیر جایگزین برای فایل اجرایی xorriso
XORRISO_WRITE_SPEED، مشخص کردن سرعت نوشتن روی دیسک نوری. یکی از مقادیر [min, max]
XORRISO_ASSERT_VOLID، مشخص کردن شناسه حجم (volume ID) الزامی برای ISO. در صورتی که شناسه حجم واقعی متفاوت باشد، عملیات لغو می‌شود.
XORRISO_ARGS، فقط برای کاربران حرفه‌ای. ارسال آرگومان‌های دلخواه به xorriso. مثال: XORRISO_ARGS='-md5 all'