.\" This man page was generated from MANPAGE.md. View it using 'man ./gocryptfs.1'
.\"
.\" Automatically generated by Pandoc 3.1.12.1
.\"
.TH "GOCRYPTFS" "1" "Aug 2017" "" ""
.SH "نام (NAME)"
gocryptfs \- ایجاد یا سوار کردن یک سامانه فایل رمزنگاری‌شده
.SH "خلاصه دستور (SYNOPSIS)"
.SS مقداردهی اولیه سامانه فایل رمزنگاری‌شده جدید
\f[CR]gocryptfs \-init [OPTIONS] CIPHERDIR\f[R]
.SS سوار کردن (Mount)
\f[CR]gocryptfs [OPTIONS] CIPHERDIR MOUNTPOINT [\-o COMMA\-SEPARATED\-OPTIONS]\f[R]
.SS پیاده کردن (Unmount)
\f[CR]fusermount \-u MOUNTPOINT\f[R]
.SS تغییر گذرواژه
\f[CR]gocryptfs \-passwd [OPTIONS] CIPHERDIR\f[R]
.SS بررسی یکپارچگی
\f[CR]gocryptfs \-fsck [OPTIONS] CIPHERDIR\f[R]
.SS نمایش اطلاعات سامانه فایل
\f[CR]gocryptfs \-info [OPTIONS] CIPHERDIR\f[R]
.SH "توضیحات (DESCRIPTION)"
دستور gocryptfs یک سامانه فایل لایه‌ای (overlay) رمزنگاری‌شده است که با زبان Go نوشته شده است.
فایل‌های رمزنگاری‌شده در CIPHERDIR ذخیره می‌شوند و با سوار کردن سامانه فایل در نقطه اتصال MOUNTPOINT، نمایی با متن خام (plaintext) ارائه می‌گردد.
.PP
برنامه gocryptfs با الهام از encfs(1) طراحی شده است و می‌کوشد در عین ارائه کارایی و سرعت بالا، مشکلات امنیتی آن را برطرف کند.
.SH "پرچم‌های عملیات (ACTION FLAGS)"
در صورتی که هیچ‌یک از \f[I]پرچم‌های عملیات\f[R] زیر مشخص نشود، عملیات پیش‌فرض سوار کردن سامانه فایل خواهد بود (بخش خلاصه دستور را ببینید).
.SS \-fsck
بررسی یکپارچگی دایرکتوری CIPHERDIR.
در صورت یافتن خرابی، کد خروج ۲۶ خواهد بود.
.SS \-h, \-help
چاپ متن راهنمای کوتاه که گزینه‌های پرکاربردتر را نمایش می‌دهد.
.SS \-hh
نمایش متن راهنمای طولانی شامل تمامی گزینه‌های موجود.
.SS \-info
نمایش خوانا و ساختاریافته محتوای فایل پیکربندی موجود در CIPHERDIR برای کاربر، همراه با حذف داده‌های حساس.
.PP
مثال:
.IP
.EX
$ gocryptfs \-info my_cipherdir
Creator:      gocryptfs v2.0\-beta2
FeatureFlags: GCMIV128 HKDF DirIV EMENames LongNames Raw64
EncryptedKey: 64B
ScryptObject: Salt=32B N=65536 R=8 P=1 KeyLen=32
.EE
.SS \-init
مقداردهی اولیه دایرکتوری رمزنگاری‌شده.
.SS \-passwd
تغییر گذرواژه.
ابتدا گذرواژه پیشین درخواست شده و صحت آن بررسی می‌شود، سپس گذرواژه جدید دریافت می‌گردد.
.PP
اگر گذرواژه را فراموش کرده‌اید اما کلید اصلی (master key) را دارید، می‌توانید از این گزینه به همراه \f[CR]\-masterkey\f[R] استفاده کنید.
توجه داشته باشید که بدون گذرواژه قدیمی، gocryptfs نمی‌تواند درستی کلید اصلی را تشخیص دهد و فایل پیکربندی قبلی را بدون درنگ بازنویسی خواهد کرد.
با این وجود، یک نسخه پشتیبان از فایل پیکربندی قدیمی به نام \f[CR]gocryptfs.conf.bak\f[R] ایجاد می‌کند.
پس از حصول اطمینان از دسترسی به فایل‌ها با گذرواژه جدید، می‌توانید این فایل پشتیبان را حذف کنید.
.SS \-speed
اجرای آزمون سنجش سرعت رمزنگاری.
آزمون سنجش کارایی الگوریتم توکار GCM در Go در برابر OpenSSL (در صورت وجود).
کتابخانه‌ای که در صورت تعیین «\-openssl=auto» (حالت پیش‌فرض) انتخاب می‌شود، مشخص می‌گردد.
.SS \-version
چاپ اطلاعات نسخه و خروج.
خروجی شامل سه فیلد است که با «;» از یکدیگر جدا شده‌اند.
مثال: «gocryptfs v1.1.1\-5\-g75b776c; go\-fuse 6b801d3; 2016\-11\-01 go1.7.3».
فیلد ۱ نسخه gocryptfs، فیلد ۲ نسخه کتابخانه go\-fuse و فیلد ۳ تاریخ کامپایل و نسخه Go استفاده‌شده است.
.SH "گزینه‌های مقداردهی اولیه (INIT OPTIONS)"
گزینه‌های موجود برای \f[CR]\-init\f[R] در زیر فهرست شده‌اند.
معمولاً به هیچ‌کدام نیاز نخواهید داشت؛ مقادیر پیش‌فرض مناسب هستند.
.SS \-aessiv
استفاده از حالت رمزنگاری AES\-SIV.
این حالت کندتر از AES\-GCM است اما با نانس‌های قطعی مورد استفاده در حالت «\-reverse» ایمن است.
.PP
دستور \f[CR]gocryptfs \-speed\f[R] را اجرا کنید تا از میزان تفاوت سرعت مطلع شوید.
.SS \-deterministic\-names
غیرفعال کردن تصادفی‌سازی نام فایل‌ها و ایجاد فایل‌های \f[CR]gocryptfs.diriv\f[R].
این گزینه می‌تواند از تداخل همگام‌سازی هنگام سنکرون کردن فایل‌ها جلوگیری کند، اما اطلاعات مربوط به نام‌های فایل یکسان را در دایرکتوری‌های مختلف فاش می‌سازد
(بخش «Identical names leak» را در
https://nuetzlich.net/gocryptfs/comparison/#file\-names
ببینید).
.PP
در فایل \f[CR]gocryptfs.conf\f[R] حاصل، ویژگی «DirIV» در «FeatureFlags» موجود نخواهد بود.
.SS \-devrandom
منسوخ شده و در gocryptfs نسخه 2.2 و بعد از آن نادیده گرفته می‌شود.
.PP
برای اطلاعات پیش‌زمینه به
https://github.com/rfjakob/gocryptfs/commit/f3c777d5eaa682d878c638192311e52f9c204294
و
https://github.com/rfjakob/gocryptfs/issues/596
مراجعه کنید.
.SS \-hkdf
استفاده از HKDF برای اشتقاق کلیدهای جداگانه محتوا و نام فایل از کلید اصلی.
پیش‌فرض true است.
.SS \-longnamemax
.IP
.EX
integer value, allowed range 62...255
.EE
.PP
هش کردن نام‌هایی که طول آن‌ها (در حالت رمزنگاری‌شده) از این مقدار فراتر می‌رود.
مقدار پیش‌فرض ۲۵۵ است که با محدودیت معمول طول نام فایل در لینوکس همخوانی داشته و بهترین کارایی را فراهم می‌آورد.
.PP
با این وجود، سرویس‌های ذخیره‌سازی ابری ممکن است محدودیت‌های کمتری روی طول نام فایل و/یا مسیر اعمال کنند.
در این وضعیت، تنظیم \-longnamemax روی مقداری کمتر می‌تواند راهگشا باشد.
.PP
هرچه مقدار کمتر باشد، فایل‌های اضافی \f[CR].name\f[R] بیشتری باید ایجاد شوند که این امر فهرست‌گیری دایرکتوری‌ها را کند می‌کند.
.PP
مقادیر کمتر از ۶۲ مجاز نیستند زیرا نام هش‌شده طولانی‌تر از نام اصلی خواهد شد.
.PP
مثال:
.IP
.EX
\-longnamemax 100
.EE
.SS \-plaintextnames
عدم رمزنگاری نام فایل‌ها و مقصدهای پیوندهای نمادین.
.SS \-raw64
استفاده از کدگذاری بدون پدینگ base64 برای نام فایل‌ها.
این کار نویسه‌های انتهایی «==» را حذف می‌کند.
سامانه فایل ایجادشده با این گزینه فقط توسط gocryptfs نسخه 1.2 و بالاتر قابل سوار کردن است.
پیش‌فرض true است.
.SS \-reverse
حالت معکوس، نمایی فقط‌خواندنی و رمزنگاری‌شده از یک دایرکتوری با متن خام را ارائه می‌دهد.
متضمن گزینه \f[CR]\-aessiv\f[R] است.
.PP
اگر می‌خواهید نمای رمزنگاری‌شده را با استفاده از \f[CR]\-masterkey\f[R] سوار کنید، \f[I]باید\f[R] گزینه \f[CR]\-aessiv\f[R] را مشخص نمایید.
.SS \-xchacha
استفاده از رمزنگاری محتوای فایل با XChaCha20\-Poly1305.
این حالت در پردازنده‌هایی که فاقد شتاب سخت‌افزاری AES هستند بسیار سریع‌تر از AES\-GCM خواهد بود.
.PP
برای اطلاع از میزان تفاوت سرعت، دستور \f[CR]gocryptfs \-speed\f[R] را اجرا کنید.
.SH "گزینه‌های سوار کردن (MOUNT OPTIONS)"
گزینه‌های موجود برای سوار کردن در زیر فهرست شده‌اند.
معمولاً به هیچ‌یک نیازی نیست؛ مقادیر پیش‌فرض مناسب هستند.
.SS \-acl
فعال‌سازی اعمال کنترل دسترسی (ACL).
هنگامی که می‌خواهید از ACL استفاده کنید، باید این گزینه را فعال کنید.
.SS \-allow_other
به‌طور پیش‌فرض، هسته لینوکس از دسترسی هر کاربر دیگری (حتی root) به یک سامانه فایل FUSE متصل جلوگیری می‌کند.
تنظیم این گزینه، امکان دسترسی دیگر کاربران را مشروط به بررسی مجوزهای فایل فراهم می‌سازد.
تنها در صورتی کار می‌کند که user_allow_other در /etc/fuse.conf تنظیم شده باشد.
این گزینه معادل «allow_other» به‌علاوه «default_permissions» توصیف‌شده در fuse(8) است.
.SS \-badname string
هنگامی که gocryptfs با نام فایل «نامعتبر» مواجه می‌شود (نامی که قابل رمزگشایی نیست یا پس از رمزگشایی به نویسه‌های نامفهوم تبدیل می‌شود)، هشداری ثبت شده و فایل از نمای متن خام پنهان می‌گردد.
.PP
با گزینه \f[CR]\-badname\f[R]، می‌توانید نام‌های نامعتبر را مشخص کنید تا به جای پنهان شدن، همچنان در نمای متن خام نمایش داده شوند.
به انتهای نام چنین فایل‌هایی عبارت \f[CR]GOCRYPTFS_BAD_NAME\f[R] افزوده خواهد شد.
.PP
الگوی انطباق سراسری (Glob).
می‌تواند چندین بار برای الگوهای مختلف تکرار شود.
.PP
مثال‌ها:
.PP
تداخل‌های همگام‌سازی در Dropbox:
.IP
.EX
\-badname \[aq]*conflicted copy*\[aq]
.EE
.PP
تداخل‌های همگام‌سازی در Syncthing:
.IP
.EX
\-badname \[aq]*.sync\-conflict*\[aq]
.EE
.PP
نمایش تمام نام‌های نامعتبر فایل‌ها:
.IP
.EX
\-badname \[aq]*\[aq]
.EE
.SS \-context string
تنظیم بافتار امنیتی SELinux.
برای جزئیات به mount(8) مراجعه کنید.
.PP
این گزینه جهت سازگاری با آزمون‌های xfstests افزوده شده است که این گزینه را با \f[CR]\-o context=\[dq]system_u:object_r:root_t:s0\[dq]\f[R] تعیین می‌کند.
.PP
تنها هنگام سوار کردن به عنوان کاربر root کار می‌کند، در غیر این صورت این خطا را از fusermount3 دریافت خواهید کرد:
.IP
.EX
fusermount3: unknown option \[aq]context=\[dq]system_u:object_r:root_t:s0\[dq]\[aq]
.EE
.SS \-ctlsock string
ایجاد یک سوکت کنترلی در مسیر مشخص‌شده.
از این سوکت می‌توان برای رمزگشایی و رمزنگاری مسیرها در داخل سامانه فایل استفاده کرد.
هنگام استفاده از این گزینه، مطمئن شوید که دایرکتوری حاوی سوکت برای همگان قابل دسترس نباشد.
برای نمونه، مسیری مانند \f[CR]/run/user/UID/my.socket\f[R] مناسب خواهد بود.
.SS \-dev, \-nodev
فعال‌سازی (\f[CR]\-dev\f[R]) یا غیرفعال‌سازی (\f[CR]\-nodev\f[R]) فایل‌های دستگاه در نقطه اتصال gocryptfs (پیش‌فرض: \f[CR]\-nodev\f[R]).
در صورت تعیین هر دو، \f[CR]\-nodev\f[R] اولویت خواهد داشت.
برای استفاده از \f[CR]\-dev\f[R] به مجوزهای کاربر ریشه (root) نیاز است.
.SS \-e PATH, \-exclude PATH
تنها برای حالت معکوس: مستثنی کردن مسیر نسبی متن خام از نمای رمزنگاری‌شده، با تطبیق تنها از ریشه سامانه فایل سوارشده.
می‌تواند چندین بار ارسال شود.
.PP
مثالی که دایرکتوری‌های «Music» و «Movies» را از دایرکتوری ریشه مستثنی می‌کند:
.IP
.EX
gocryptfs \-reverse \-exclude Music \-exclude Movies /home/user /mnt/user.encrypted
.EE
.PP
همچنین گزینه‌های \f[CR]\-exclude\-wildcard\f[R]، \f[CR]\-exclude\-from\f[R] و بخش «مستثنی کردن فایل‌ها» را ببینید.
.SS \-ew GITIGNORE\-PATTERN, \-exclude\-wildcard GITIGNORE\-PATTERN
تنها برای حالت معکوس: مستثنی کردن مسیرها از نمای رمزنگاری‌شده مطابق با نحو gitignore(5)، با پشتیبانی از کاراکترهای عمومی.
می‌تواند چندین بار برای تعیین چندین الگو مشخص شود.
.PP
مثال برای مستثنی کردن تمامی فایل‌های \f[CR].mp3\f[R] در هر دایرکتوری:
.IP
.EX
gocryptfs \-reverse \-exclude\-wildcard \[aq]*.mp3\[aq] /home/user /mnt/user.encrypted
.EE
.PP
مثال برای مستثنی کردن همه‌چیز به جز دایرکتوری `important` در دایرکتوری ریشه:
.IP
.EX
gocryptfs \-reverse \-exclude\-wildcard \[aq]*\[aq] \-exclude\-wildcard \[aq]!/important\[aq] /home/user /mnt/user.encrypted
.EE
.PP
همچنین گزینه \f[CR]\-exclude\-from\f[R] و بخش «مستثنی کردن فایل‌ها» را ببینید.
.SS \-exclude\-from FILE
تنها برای حالت معکوس: خواندن الگوهای gitignore از یک فایل.
می‌تواند چندین بار تکرار شود.
مثال:
.IP
.EX
gocryptfs \-reverse \-exclude\-from \[ti]/crypt\-exclusions /home/user /mnt/user.encrypted
.EE
.PP
همچنین گزینه‌های \f[CR]\-exclude\f[R]، \f[CR]\-exclude\-wildcard\f[R] و بخش «مستثنی کردن فایل‌ها» را ببینید.
.SS \-exec, \-noexec
فعال‌سازی (\f[CR]\-exec\f[R]) یا غیرفعال‌سازی (\f[CR]\-noexec\f[R]) اجرای فایل‌های اجرایی در سامانه فایل gocryptfs (پیش‌فرض: \f[CR]\-exec\f[R]).
در صورت تعیین هر دو، \f[CR]\-noexec\f[R] اولویت دارد.
.SS \-fg, \-f
ماندن در پیش‌زمینه به جای رفتن به پس‌زمینه (daemonize شدن).
جهت سازگاری، «\-f» نیز پذیرفته می‌شود، اما «\-fg» ارجح است.
.PP
مگر در حالتی که \f[CR]\-notifypid\f[R] مشخص شده باشد، لاگ‌ها به جای syslog به stdout و stderr فرستاده می‌شوند.
.SS \-force_owner string
در صورت دریافت رشته‌ای به شکل «uid:gid» (که در آن «uid» و «gid» با اعداد صحیح مثبت جایگزین شده‌اند)، مالکیت تمامی فایل‌ها را بدون توجه به مالکیت واقعی آن‌ها، به عنوان uid و gid مشخص‌شده نمایش می‌دهد.
متضمن گزینه «allow_other» است.
.PP
این رفتار به‌ندرت مورد نیاز است: کاربر \f[I]معمولاً\f[R] باید gocryptfs را با همان کاربری اجرا کند که مالک فایل‌های ذخیره‌سازی پشتیبان است، که این حساب معمولاً \f[I]باید\f[R] با حساب کاربری که قصد دسترسی به محتوای رمزگشایی‌شده را دارد یکی باشد.
نمونه‌ای که این گزینه می‌تواند در آن سودمند باشد وضعیتی است که در آن محتوا روی سامانه فایلی ذخیره شده که از مالکیت و مجوزهای یونیکس به‌درستی پشتیبانی نمی‌کند.
.SS \-forcedecode
منسوخ شده و در gocryptfs نسخه 2.2 و بالاتر نادیده گرفته می‌شود.
.PP
برای اطلاع از اینکه این گزینه چه بود و چرا حذف شد به پیوند زیر مراجعه نمایید:
https://github.com/rfjakob/gocryptfs/commit/d023cd6c95fcbc6b5056ba1f425d2ac3df4abc5a
.SS \-fsname string
بازنویسی نام سامانه فایل (ستون اول در df \-T).
می‌تواند به صورت «\-o fsname=» نیز ارسال شود و معادل گزینه‌ای با همین نام در libfuse است.
به‌طور پیش‌فرض از CIPHERDIR استفاده می‌شود.
.SS \-fusedebug
فعال کردن خروجی اشکال‌زدایی کتابخانه fuse.
.SS \-i duration, \-idle duration
فقط برای حالت مستقیم: پیاده کردن خودکار سامانه فایل در صورتی که برای مدت مشخص‌شده بدون فعالیت (بیکار) بوده باشد.
مدت‌زمان می‌تواند مانند «500s» یا «2h45m» مشخص شود.
مقدار ۰ (پیش‌فرض) به معنای متصل ماندن دائمی است.
.PP
هنگامی که فرایندی فایل‌های باز در نقطه اتصال داشته باشد یا دایرکتوری کاری آن در آنجا باشد، مانع از بیکار شدن سامانه فایل خواهد شد.
.SS \-kernel_cache
فعال کردن گزینه kernel_cache در سامانه فایل FUSE؛ برای جزئیات به fuse(8) مراجعه فرمایید.
.SS \-ko
ارسال گزینه‌های سوار کردن اضافی به هسته (فهرست جداشده با کاما).
سامانه‌های فایل FUSE به‌طور پیش‌فرض با «nodev,nosuid» متصل می‌شوند.
اگر gocryptfs با کاربر root اجرا شود، می‌توانید فایل‌های دستگاه را با ارسال گزینه متضاد «dev» فعال کنید، و اگر می‌خواهید باینری‌های دارای پرچم suid فعال باشند، «suid» را ارسال نمایید.
گزینه‌های «ro» (معادل گزینه «\-ro») و «noexec» نیز می‌توانند مفید باشند.
برای فهرست کامل، بخش
\f[CR]FILESYSTEM\-INDEPENDENT MOUNT OPTIONS\f[R]
را در mount(8) ببینید.
در مک‌اواس (macOS)، گزینه «local» قابلیت سطل زباله مبتنی بر حجم را فعال می‌کند اگر پوشه \f[CR].Trashes\f[R] در ریشه حجم وجود داشته باشد (ممکن است نیاز به ساخت دستی باشد). توجه کنید که «local» در مستندات
.UR https://github.com/osxfuse/osxfuse/wiki/Mount-options#local
osxfuse
.UE \c
به عنوان «آزمایشی» علامت خورده است؛ همچنین گزینه‌های «noapplexattr» و «noappledouble» ممکن است سودمند باشند.
.PP
توجه کنید که برخلاف «\-o»، گزینه «\-ko» یک گزینه معمولی است و باید پیش از دایرکتوری‌ها ارسال شود.
مثال:
.IP
.EX
gocryptfs \-ko noexec /tmp/foo /tmp/bar
.EE
.SS \-longnames
ذخیره نام‌های طولانی‌تر از ۱۷۵ بایت در فایل‌های اضافی (پیش‌فرض true).
.PP
این پرچم تنها هنگام بازیابی سامانه‌های فایل بسیار قدیمی gocryptfs (نسخه 0.8 و قبل از آن) با استفاده از «\-masterkey» مفید است.
در غیر این صورت نادیده گرفته می‌شود (روی پیش‌فرض می‌ماند).
.SS \-nodev
به \f[CR]\-dev, \-nodev\f[R] مراجعه کنید.
.SS \-noexec
به \f[CR]\-exec, \-noexec\f[R] مراجعه کنید.
.SS \-nofail
قرار داشتن گزینه \f[CR]nofail\f[R] در \f[CR]/etc/fstab\f[R] به \f[CR]systemd\f[R] اعلام می‌کند که حتی در صورت شکست عملیات سوار کردن، بوت سیستم به‌طور عادی ادامه یابد (به \f[CR]man systemd.fstab\f[R] مراجعه کنید).
.PP
این گزینه توسط خود \f[CR]gocryptfs\f[R] نادیده گرفته می‌شود و خارج از \f[CR]/etc/fstab\f[R] اثری ندارد.
.SS \-nonempty
اجازه اتصال روی دایرکتوری‌های غیرخالی.
سامانه FUSE به‌طور پیش‌فرض برای جلوگیری از پنهان‌سازی تصادفی فایل‌ها، این کار را مجاز نمی‌داند.
.SS \-noprealloc
غیرفعال‌سازی پیش‌تخصیص فضا پیش از نوشتن.
به‌طور پیش‌فرض، gocryptfs فضایی را که نوشتن بعدی اشغال می‌کند با استفاده از fallocate(2) در حالت FALLOC_FL_KEEP_SIZE پیش‌تخصیص می‌دهد.
این کار تضمین می‌کند که در میانه نوشتن فضا کم نیاید؛ رخدادی که باعث خراب و غیرقابل‌خواندن شدن آخرین بلوک 4kB می‌شود.
.PP
در سامانه فایل ext4، پیش‌تخصیص سریع است و افت کارایی محسوسی ایجاد نمی‌کند.
متأسفانه در Btrfs، پیش‌تخصیص بسیار کند است، به‌ویژه روی دیسک‌های مغناطیسی چرخشی (HDD).
گزینه «\-noprealloc» این امکان را فراهم می‌کند که مقاومت در برابر خطاهای کمبود فضا با افزایش چشمگیر سرعت مبادله شود.
.PP
برای بنچمارک‌ها و جزئیات بیشتر به پیوند زیر مراجعه کنید:
https://github.com/rfjakob/gocryptfs/issues/63
.SS \-nosuid
به \f[CR]\-suid, \-nosuid\f[R] مراجعه کنید.
.SS \-nosyslog
پیام‌های عیب‌یابی معمولاً پس از رفتن gocryptfs به حالت پس‌زمینه (daemonize) به syslog فرستاده می‌شوند.
این گزینه این تغییر مسیر را غیرفعال کرده و پیام‌ها همچنان در stdout و stderr چاپ خواهند شد.
.SS \-notifypid int
ارسال سیگنال USR1 به فرایند مشخص‌شده پس از سوار کردن موفقیت‌آمیز.
این گزینه به‌طور داخلی برای رفتن فرایند به پس‌زمینه استفاده می‌شود.
.SS \-one\-file\-system
عدم عبور از مرزهای سامانه‌های فایل (مشابه گزینه \f[CR]\-\-one\-file\-system\f[R] در rsync).
نقاط اتصال به صورت دایرکتوری‌های خالی نمایش داده می‌شوند.
.PP
تنها در حالت معکوس کاربرد دارد.
.PP
محدودیت: تک‌فایل‌های سوارشده پنهان نخواهند شد.
.SS \-rw, \-ro
سوار کردن سامانه فایل به صورت خواندن/نوشتن (\f[CR]\-rw\f[R]، پیش‌فرض) یا فقط‌خواندنی (\f[CR]\-ro\f[R]).
در صورت مشخص شدن هر دو، \f[CR]\-ro\f[R] اولویت دارد.
.SS \-reverse
به بخش \f[CR]\-reverse\f[R] در «گزینه‌های مقداردهی اولیه» مراجعه کنید.
باید گزینه \f[CR]\-reverse\f[R] را هم در هنگام \f[CR]\-init\f[R] و هم هنگام سوار کردن مشخص کنید.
.SS \-serialize_reads
هسته معمولاً چندین درخواست خواندن هم‌روند را برای پاسخ‌گویی به درخواست‌های فضای کاربری و خواندن پیشاپیش (readahead) ارسال می‌کند.
برنامه gocryptfs به آن‌ها به‌صورت هم‌روند و با ترتیب دلخواه پاسخ می‌دهد.
روی فضاهای ذخیره‌سازی که کارایی ضعیفی برای خواندن‌های هم‌روند یا نامنظم دارند (مانند Amazon Cloud Drive)، این رفتار می‌تواند موجب افت شدید سرعت خواندن شود.
.PP
گزینه \f[CR]\-serialize_reads\f[R] دو کار انجام می‌دهد: (۱) درخواست‌های خواندن یکی‌یکی (بدون هم‌روندی) ارسال خواهند شد و (۲) gocryptfs تلاش می‌کند خواندن‌ها را به ترتیب آفست فایل مرتب سازد.
.PP
این ترتیب‌دهی مستلزم آن است که gocryptfs پیش از ارسال خواندن، مدت‌زمان معینی درنگ کند.
سریالی‌سازی قفل‌گذاری اضافی تحمیل می‌کند.
این عوامل سرعت انتقال داده را به زیر 70MB/s محدود می‌سازند.
.PP
برای جزئیات بیشتر به پیوند زیر مراجعه کنید:
https://github.com/rfjakob/gocryptfs/issues/92
.SS \-sharedstorage
فعال‌سازی سازوکارهای تطبیقی به منظور کارکرد بهتر gocryptfs زمانی که دایرکتوری پشتیبان به‌طور هم‌زمان توسط چندین نمونه از gocryptfs مورد دسترسی قرار می‌گیرد.
.PP
در حال حاضر، این گزینه دو کار انجام می‌دهد:
.IP "1." 3
غیرفعال‌سازی کش‌گذاری stat() تا تغییرات در فضای ذخیره‌سازی پشتیبان بلافاصله نمایان شوند.
.IP "2." 3
غیرفعال‌سازی ردیابی پیوندهای سخت (hard links)، زیرا شماره‌های inode روی ذخیره‌ساز پشتیبان در صورت حذف و ساخت مجدد فایل‌ها در پشت صحنه پایدار نیستند.
در غیر این صورت، این وضعیت خطاهای عجیب «file does not exist» و خطاهای دیگر را تولید می‌کرد.
.PP
هنگامی که «\-sharedstorage» فعال باشد، کارایی کاهش یافته و پیوندهای سخت قابل ایجاد نخواهند بود.
.PP
حتی با فعال بودن این پرچم، ممکن است گهگاه با مشکلاتی روبرو شوید.
اجرای gocryptfs روی فضای ذخیره‌سازی مشترک به اندازه حالت کاربرد اختصاصی مورد آزمایش قرار نگرفته است.
لطفاً حجم کاری خود را از قبل بیازمایید و هرگونه مشکلی را گزارش دهید.
.PP
اطلاعات بیشتر:
https://github.com/rfjakob/gocryptfs/issues/156
.SS \-suid, \-nosuid
فعال‌سازی (\f[CR]\-suid\f[R]) یا غیرفعال‌سازی (\f[CR]\-nosuid\f[R]) فایل‌های اجرایی suid و sgid در نقطه اتصال gocryptfs (پیش‌فرض: \f[CR]\-nosuid\f[R]).
در صورت تعیین هر دو، \f[CR]\-nosuid\f[R] اولویت خواهد داشت.
برای استفاده از \f[CR]\-suid\f[R] به مجوزهای کاربر ریشه نیاز دارید.
.SS \-zerokey
استفاده از کلید اصلی ساختگی متشکل از تمام بایت‌های صفر.
این گزینه فقط برای آزمایش‌های خودکار در نظر گرفته شده است زیرا هیچ‌گونه امنیتی ارائه نمی‌دهد.
.SH "گزینه‌های عمومی (COMMON OPTIONS)"
گزینه‌هایی که برای بیش از یک عملیات کاربرد دارند در زیر آمده‌اند.
برای هر گزینه مشخص شده است که در چه مواردی کاربرد دارد.
مجدداً، معمولاً به هیچ‌یک از آن‌ها نیازی نخواهید داشت.
.SS \-config string
استفاده از فایل پیکربندی مشخص‌شده به جای
\f[CR]CIPHERDIR/gocryptfs.conf\f[R].
.PP
کاربرد: تمامی عملیاتی که از یک فایل پیکربندی استفاده می‌کنند: سوار کردن،
\f[CR]\-fsck\f[R]، \f[CR]\-passwd\f[R]، \f[CR]\-info\f[R] و
\f[CR]\-init\f[R].
.SS \-cpuprofile string
نوشتن نمایه مصرف پردازنده (CPU profile) در فایل مشخص‌شده.
.PP
کاربرد: تمامی عملیات‌ها.
.SS \-d, \-debug
فعال کردن خروجی اشکال‌زدایی.
.PP
کاربرد: تمامی عملیات‌ها.
.SS \-extpass CMD [\-extpass ARG1 \&...]
استفاده از یک برنامه خارجی (مانند ssh\-askpass) برای اعلان دریافت گذرواژه.
برنامه باید گذرواژه را در خروجی استاندارد ارائه دهد؛ خط جدید انتهایی توسط gocryptfs حذف می‌شود.
اگر فقط می‌خواهید گذرواژه را از یک فایل بخوانید، گزینه
\f[CR]\-passfile\f[R]
را ببینید.
.PP
هنگامی که \f[CR]\-extpass\f[R] یک بار مشخص شود، آرگومان رشته‌ای بر اساس فاصله‌ها تفکیک می‌گردد.
برای مثال، \f[CR]\-extpass \[dq]md5sum my password.txt\[dq]\f[R] به صورت
\f[CR]\[dq]md5sum\[dq] \[dq]my\[dq] \[dq]password.txt\[dq]\f[R]
اجرا می‌شود که مسلماً خروجی مطلوب شما نیست.
.PP
گزینه \f[CR]\-extpass\f[R] را دو بار یا بیشتر مشخص کنید تا آرگومان‌های رشته‌ای دست‌نخورده استفاده شوند.
برای مثال، فراخوانی مطلوب به این شکل خواهد بود:
\f[CR]\-extpass \[dq]md5sum\[dq] \-extpass \[dq]my password.txt\[dq]\f[R].
.PP
اگر می‌خواهید از تفکیک بر اساس فاصله جلوگیری کنید اما نمی‌خواهید آرگومانی به برنامه ارسال نمایید، از \f[CR]\[dq]\-\-\[dq]\f[R] استفاده کنید که توسط اکثر برنامه‌ها پذیرفته می‌شود:
\f[CR]\-extpass \[dq]my program\[dq] \-extpass \[dq]\-\-\[dq]\f[R]
.PP
کاربرد: تمامی عملیاتی که گذرواژه درخواست می‌کنند.
.PP
اشکال: در حالت \f[CR]\-extpass \-X\f[R]، مقدار \f[CR]\-X\f[R] به عنوان \f[CR]\-\-X\f[R] تفسیر خواهد شد.
لطفاً برای جلوگیری از آن از \f[CR]\-extpass=\-X\f[R] استفاده کنید.
برای جزئیات به بخش \f[B]تکرار خط تیره\f[R] در بخش \f[B]اشکالات (BUGS)\f[R] مراجعه کنید.
.SS \-fido2 DEVICE_PATH
استفاده از توکن امنیتی FIDO2 برای مقداردهی اولیه و بازگشایی قفل سامانه فایل.
از دستور \f[CR]fido2\-token \-L\f[R] برای دریافت مسیر دستگاه توکن FIDO2 استفاده کنید.
در لینوکس، بسته \f[B]fido2\-tools\f[R] مورد نیاز است.
.PP
کاربرد: تمامی عملیاتی که گذرواژه درخواست می‌کنند.
.SS \-fido2\-assert\-option OPTION
گزینه‌های ارسال‌شده به \f[CR]fido2\-assert\f[R] همراه با گزینه \f[CR]\-t\f[R].
این گزینه می‌تواند چندین بار تکرار شود و هر بار دو آرگومان \f[CR]\-t\f[R] و \f[CR]OPTION\f[R] را به \f[CR]fido2\-assert\f[R] اضافه می‌کند.
برای بررسی گزینه‌های پشتیبانی‌شده به \f[CR]man fido2\-assert\f[R] مراجعه کنید.
.PP
مثال‌ها:
.PP
ایجاد یک سامانه فایل بدون اعتبارسنجی پین (PIN):
.IP
.EX
gocryptfs \-init \-fido2 DEVICE_PATH \-fido2\-assert\-option pin=false CIPHERDIR
.EE
.PP
ایجاد یک سامانه فایل با هر دو اعتبارسنجی کاربر و اعتبارسنجی پین:
.IP
.EX
gocryptfs \-init \-fido2 DEVICE_PATH \-fido2\-assert\-option uv=true \-fido2\-assert\-option pin=true CIPHERDIR
.EE
.PP
ایجاد یک سامانه فایل با هر دو حضور کاربر و اعتبارسنجی کاربر:
.IP
.EX
gocryptfs \-init \-fido2 DEVICE_PATH \-fido2\-assert\-option up=true \-fido2\-assert\-option uv=true CIPHERDIR
.EE
.SS \-masterkey string
استفاده از یک کلید اصلی صریح مشخص‌شده در خط فرمان یا اگر مقدار ویژه «stdin» به کار رود، خواندن کلید اصلی از stdin، به جای خواندن فایل پیکربندی و درخواست گذرواژه.
.PP
توجه داشته باشید که خط فرمان و در نتیجه کلید اصلی برای هر کاربری در سیستم که بتواند دستور «ps \-auxwww» را اجرا کند قابل رؤیت است.
برای اجتناب از این خطر از «\-masterkey=stdin» استفاده کنید.
.PP
گزینه masterkey به عنوان گزینه‌ای برای بازیابی در شرایط اضطراری در نظر گرفته شده است، مانند زمانی که گذرواژه را فراموش کرده یا فایل پیکربندی را از دست داده‌اید.
.PP
حتی در صورت وجود فایل پیکربندی، از آن استفاده نخواهد شد.
تمام تنظیمات غیرپیش‌فرض باید در خط فرمان ارسال شوند:
\f[CR]\-aessiv\f[R] هنگام سوار کردن سامانه فایلی که با حالت معکوس ایجاد شده است، یا \f[CR]\-plaintextnames\f[R] برای سامانه فایلی که با آن گزینه ساخته شده است.
.PP
مثال ۱: سوار کردن سامانه فایلی که با گزینه‌های پیش‌فرض ایجاد شده است:
.IP
.EX
gocryptfs \-masterkey=6f717d8b\-6b5f8e8a\-fd0aa206\-778ec093\-62c5669b\-abd229cd\-241e00cd\-b4d6713d cipher mnt
gocryptfs \-masterkey=stdin cipher mnt
.EE
.PP
مثال ۲: سوار کردن سامانه فایل \f[CR]gocryptfs \-reverse\f[R] (توجه داشته باشید که \f[I]باید\f[R] گزینه \f[CR]\-aessiv\f[R] را مشخص کنید):
.IP
.EX
gocryptfs \-masterkey=stdin \-aessiv cipher mnt
.EE
.PP
کاربرد: تمامی عملیاتی که گذرواژه درخواست می‌کنند.
.SS \-memprofile string
نوشتن نمایه حافظه در فایل مشخص‌شده.
این گزینه هنگام بررسی و اشکال‌زدایی مصرف حافظه gocryptfs سودمند است.
.PP
کاربرد: تمامی عملیات‌ها.
.SS \-o COMMA\-SEPARATED\-OPTIONS
جهت سازگاری با mount(1)، گزینه‌ها به صورت «\-o COMMA\-SEPARATED\-OPTIONS» در انتهای خط فرمان نیز پذیرفته می‌شوند.
برای مثال، «\-o q,zerokey» معادل با ارسال «\-q \-zerokey» است.
.PP
توجه داشته باشید که با «\-o» تنها می‌توانید گزینه‌هایی را ارسال کنید که توسط gocryptfs شناخته می‌شوند.
اگر می‌خواهید پرچم‌های ویژه‌ای به هسته بفرستید، باید از «\-ko» (گزینه هسته) استفاده کنید.
این موضوع با سامانه‌های فایل مبتنی بر libfuse تفاوت دارد که گزینه‌های ناشناخته «\-o» را به‌طور خودکار به هسته ارسال می‌کنند.
.PP
مثال:
.IP
.EX
gocryptfs /tmp/foo /tmp/bar \-o q,zerokey
.EE
.PP
کاربرد: تمامی عملیات‌ها.
.SS \-openssl bool/\[lq]auto\[rq]
استفاده از OpenSSL به جای کتابخانه رمزنگاری توکار Go (پیش‌فرض «auto»).
استفاده از کتابخانه توکار Go حدود ۴ برابر کندتر است، مگر اینکه پردازنده شما دستورالعمل‌های سخت‌زاری AES داشته باشد و از نسخه Go 1.6 یا بالاتر استفاده کنید.
در حالت «auto»، برنامه gocryptfs گزینه سریع‌تر را انتخاب می‌کند.
.PP
کاربرد: تمامی عملیات‌ها.
.SS \-passfile FILE [\-passfile FILE2 \&...]
خواندن گذرواژه از فایل متنی ساده مشخص‌شده.
فایل باید دقیقاً شامل یک سطر باشد (از فایل‌های دودویی استفاده نکنید!).
در صورت وجود بیش از یک سطر، هشداری چاپ شده و تنها سطر اول استفاده می‌شود.
وجود یک نویسه خط جدید انتهایی مجاز است و باعث هشدار نمی‌شود.
.PP
این گزینه را چندین بار ارسال کنید تا سطر اول از چند فایل خوانده شود.
آن‌ها برای تشکیل گذرواژه مؤثر به یکدیگر متصل می‌شوند.
.PP
مثال:
.IP
.EX
echo hello > hello.txt
echo world > world.txt
gocryptfs \-passfile hello.txt \-passfile world.txt
.EE
.PP
گذرواژه مؤثر «helloworld» خواهد بود.
.PP
کاربرد: تمامی عملیاتی که گذرواژه درخواست می‌کنند.
.SS \-q, \-quiet
حالت بی‌صدا \- عدم نمایش پیام‌های اطلاعاتی.
.PP
کاربرد: تمامی عملیات‌ها.
.SS \-scryptn int
برنامه gocryptfs از الگوریتم \f[I]scrypt\f[R] برای درهم‌سازی (هش کردن) گذرواژه هنگام سوار کردن استفاده می‌کند که آن را در برابر حملات جستجوی فراگیر (brute\-force) محافظت می‌نماید.
.PP
گزینه \f[CR]\-scryptn\f[R] پارامتر هزینه «N» در \f[I]scrypt\f[R] را کنترل می‌کند که به صورت scryptn=log2(N) بیان می‌شود.
مقادیر مجاز از \f[CR]\-scryptn=10\f[R] تا \f[CR]\-scryptn=28\f[R] متغیر بوده و بیانگر N=2\[ha]10 تا N=2\[ha]28 است.
.PP
تنظیم این مقدار روی عددی کمتر سرعت سوار کردن را افزایش داده و مصرف حافظه را کاهش می‌دهد، اما گذرواژه را در برابر حملات جستجوی فراگیر آسیب‌پذیرتر می‌سازد.
مقدار پیش‌فرض ۱۶ است.
.PP
میزان مصرف حافظه برای \f[I]scrypt\f[R] در حین سوار کردن به شرح زیر است:
.IP
.EX
scryptn     Memory Usage  
=======     ============
10          1   MiB
11          2 
12          4 
13          8 
14          16  
15          32  
16          64  
17          128 
18          256 
19          512 
20          1   GiB
21          2 
22          4 
23          8 
24          16  
25          32  
26          64  
27          128 
28          256 
.EE
.PP
کاربرد: \f[CR]\-init\f[R]، \f[CR]\-passwd\f[R]
.PP
همچنین ببینید: بنچمارک‌های موجود در کد منبع gocryptfs در پوشه internal/configfile.
.SS \-trace string
نوشتن ردگیری اجرا در فایل.
ردگیری را با استفاده از دستور «go tool trace FILE» مشاهده کنید.
.PP
کاربرد: تمامی عملیات‌ها.
.SS \-wpanic
در صورت مواجهه با هرگونه هشدار، برنامه با وضعیت هراس (panic) بلافاصله خارج شود.
این گزینه برای آزمون‌های رگرسیون مناسب است.
.PP
کاربرد: تمامی عملیات‌ها.
.SS \-\-
پایان پردازش گزینه‌ها.
زمانی مفید است که نام دایرکتوری CIPHERDIR با خط‌تیره «\-» آغاز شود.
.PP
کاربرد: تمامی عملیات‌ها.
.SH "مستثنی کردن فایل‌ها (EXCLUDING FILES)"
در حالت معکوس، امکان مستثنی کردن فایل‌ها از نمای رمزنگاری‌شده با استفاده از گزینه‌های
\f[CR]\-exclude\f[R]، \f[CR]\-exclude\-wildcard\f[R]
و
\f[CR]\-exclude\-from\f[R]
وجود دارد.
.PP
گزینه \f[CR]\-exclude\f[R] مسیرهای کامل را تطبیق می‌دهد، بنابراین
\f[CR]\-exclude file.txt\f[R] تنها فایلی به نام \f[CR]file.txt\f[R] را در ریشه سامانه فایل سوارشده مستثنی می‌کند؛ فایل‌هایی به نام \f[CR]file.txt\f[R] در زیردایرکتوری‌ها همچنان قابل مشاهده خواهند بود.
کاراکترهای عمومی پشتیبانی \f[I]نمی‌شوند\f[R].
این گزینه برای حفظ سازگاری با رفتار نسخه‌های تا 1.6.x حفظ شده است.
کاربران جدید باید به جای آن از \f[CR]\-exclude\-wildcard\f[R] استفاده کنند.
.PP
گزینه \f[CR]\-exclude\-wildcard\f[R] از نحو gitignore استفاده می‌کند و فایل‌ها را در هر مکانی تطبیق می‌دهد، بنابراین
\f[CR]\-exclude\-wildcard file.txt\f[R] فایل‌هایی به نام \f[CR]file.txt\f[R] را در هر دایرکتوری مستثنی می‌سازد.
اگر می‌خواهید مسیرهای کامل را تطبیق دهید، می‌توانید نام فایل را با پیشوند \f[CR]/\f[R] آغاز کنید:
\f[CR]\-exclude\-wildcard /file.txt\f[R] تنها \f[CR]file.txt\f[R] را در ریشه سامانه فایل سوارشده مستثنی می‌کند.
.PP
اگر موارد استثنا زیاد باشند، می‌توانید از \f[CR]\-exclude\-from\f[R] برای خواندن الگوهای gitignore از یک فایل استفاده کنید.
مشابه \f[CR]\-exclude\-wildcard\f[R]، از یک \f[CR]/\f[R] ابتدایی برای تطبیق مسیرهای کامل استفاده کنید.
.PP
قواعد مستثنی‌سازی همان قواعد مربوط به
.UR https://git-scm.com/docs/gitignore#_pattern_format
gitignore
.UE \c
\& هستند.
به‌طور خلاصه:
.IP "1." 3
یک سطر خالی با هیچ فایلی تطبیق پیدا نمی‌کند، بنابراین می‌تواند به عنوان فاصله‌انداز برای خوانایی عمل کند.
.IP "2." 3
سطری که با \f[CR]#\f[R] آغاز شود به عنوان توضیح در نظر گرفته می‌شود.
برای الگوهایی که با علامت شارپ آغاز می‌شوند، یک بک‌اسلش (\f[CR]\[rs]\f[R]) جلوی شارپ نخست قرار دهید.
.IP "3." 3
فاصله‌های خالی انتهایی نادیده گرفته می‌شوند مگر آنکه با بک‌اسلش (\f[CR]\[rs]\f[R]) نقل‌قول شوند.
.IP "4." 3
یک پیشوند اختیاری \f[CR]!\f[R] الگو را نفی می‌کند؛ هر فایل مطابقی که با الگوی قبلی مستثنی شده بود، مجدداً مشمول خواهد شد.
اگر دایرکتوری والد یک فایل مستثنی شده باشد، مشمول کردن مجدد آن فایل ممکن نیست.
برای الگوهایی که با علامت واقعی \f[CR]!\f[R] شروع می‌شوند، یک بک‌اسلش (\f[CR]\[rs]\f[R]) در ابتدای آن قرار دهید؛ برای مثال:
\f[CR]\[rs]!important!.txt\f[R].
.IP "5." 3
اگر الگو به یک اسلش ختم شود، برای اهداف توصیف زیر اسلش حذف می‌شود، اما تنها با دایرکتوری‌ها مطابقت خواهد یافت.
به عبارت دیگر، \f[CR]foo/\f[R] با دایرکتوری foo و مسیرهای زیر آن مطابقت دارد، اما با فایل عادی یا پیوند نمادین با نام foo مطابقت ندارد.
.IP "6." 3
اگر الگو شامل اسلش \f[CR]/\f[R] نباشد، به عنوان الگوی انطباق شل تلقی شده و برای تطبیق با مسیر نسبی نسبت به ریشه سامانه فایل سوارشده بررسی می‌شود.
.IP "7." 3
در غیر این صورت، الگو به عنوان الگوی شل مناسب برای پردازش توسط fnmatch(3) با پرچم FNM_PATHNAME در نظر گرفته می‌شود: کاراکترهای عمومی در الگو با \f[CR]/\f[R] در نام مسیر مطابقت نخواهند داشت.
برای مثال، \f[CR]Documentation/*.html\f[R] با
\f[CR]Documentation/git.html\f[R] تطبیق دارد اما با
\f[CR]Documentation/ppc/ppc.html\f[R] یا
\f[CR]tools/perf/Documentation/perf.html\f[R] مطابقت ندارد.
.IP "8." 3
یک اسلش در ابتدای الگو با شروع نام مسیر مطابقت دارد.
برای مثال، \f[CR]/*.c\f[R] با \f[CR]cat\-file.c\f[R] تطبیق دارد اما با
\f[CR]mozilla\-sha1/sha1.c\f[R] مطابقت ندارد.
.IP "9." 3
دو ستاره متوالی (\f[CR]**\f[R]) در الگوهایی که در برابر مسیر کامل مطابقت داده می‌شوند ممکن است معنای خاصی داشته باشند:
.RS 4
.IP "  i." 5
یک \f[CR]**\f[R] ابتدایی که به دنبال آن یک اسلش آمده باشد به معنای تطبیق در تمامی دایرکتوری‌ها است.
برای مثال، \f[CR]**/foo\f[R] با فایل یا دایرکتوری \f[CR]foo\f[R] در هر مکانی تطبیق دارد، مشابه الگوی \f[CR]foo\f[R].
الگوی \f[CR]**/foo/bar\f[R] با فایل یا دایرکتوری \f[CR]bar\f[R] در هر جایی که مستقیماً در زیر دایرکتوری \f[CR]foo\f[R] باشد تطبیق می‌یابد.
.IP " ii." 5
یک \f[CR]/**\f[R] انتهایی با تمام محتویات داخل آن تطبیق دارد.
برای مثال، \f[CR]abc/**\f[R] با تمام فایل‌های داخل دایرکتوری \f[CR]abc\f[R] با عمق نامحدود مطابقت پیدا می‌کند.
.IP "iii." 5
یک اسلش که به دنبال آن دو ستاره متوالی و سپس یک اسلش دیگر بیاید با صفر یا چند دایرکتوری تطبیق می‌یابد.
برای مثال، \f[CR]a/**/b\f[R] با \f[CR]a/b\f[R]، \f[CR]a/x/b\f[R]، \f[CR]a/x/y/b\f[R] و نظایر آن مطابقت دارد.
.IP " iv." 5
سایر موارد ستاره‌های متوالی نامعتبر تلقی می‌شوند.
.RE
.SH "مثال‌ها (EXAMPLES)"
.SS مقداردهی اولیه
ایجاد یک سامانه فایل رمزنگاری‌شده در دایرکتوری «mydir.crypt» و سوار کردن آن روی «mydir»:
.IP
.EX
mkdir mydir.crypt mydir
gocryptfs \-init mydir.crypt
gocryptfs mydir.crypt mydir
.EE
.SS سوار کردن
سوار کردن نمای رمزنگاری‌شده دایرکتوری خانه joe با استفاده از حالت معکوس:
.IP
.EX
mkdir /home/joe.crypt
gocryptfs \-init \-reverse /home/joe
gocryptfs \-reverse /home/joe /home/joe.crypt
.EE
.SS تنظیم در fstab
افزودن این سطر به \f[CR]/etc/fstab\f[R] موجب می‌شود \f[CR]/tmp/cipher\f[R] هنگام بالا آمدن سیستم در \f[CR]/tmp/plain\f[R] با استفاده از گذرواژه موجود در \f[CR]/tmp/passfile\f[R] سوار شود.
از دستور \f[CR]sudo mount \-av\f[R] برای آزمایش این سطر بدون نیاز به راه‌اندازی مجدد استفاده کنید.
مسیر gocryptfs را بر اساس خروجی دستور \f[CR]which gocryptfs\f[R] تنظیم کنید.
حتماً از گزینه \f[CR]nofail\f[R] استفاده کنید تا در صورت بروز خطا در سوار کردن سامانه فایل gocryptfs، بوت سیستم مختل نشود (برای جزئیات به گزینه \f[CR]\-nofail\f[R] مراجعه کنید).
.IP
.EX
/tmp/cipher /tmp/plain fuse./usr/local/bin/gocryptfs nofail,allow_other,passfile=/tmp/password 0 0
.EE
.SH "متغیرهای محیطی (ENVIRONMENT VARIABLES)"
.SS NO_COLOR
در صورت تنظیم \f[CR]NO_COLOR\f[R] (صرف‌نظر از مقدار آن)، خروجی رنگی غیرفعال می‌شود (به https://no\-color.org مراجعه کنید).
.SH "کدهای خروج (EXIT CODES)"
0: موفقیت
.PD 0
.P
.PD
6: دایرکتوری CIPHERDIR خالی نیست (در «\-init»)
.PD 0
.P
.PD
10: نقطه اتصال MOUNTPOINT دایرکتوری خالی نیست
.PD 0
.P
.PD
12: گذرواژه نادرست است
.PD 0
.P
.PD
22: گذرواژه خالی است (در «\-init»)
.PD 0
.P
.PD
23: امکان خواندن gocryptfs.conf وجود نداشت
.PD 0
.P
.PD
24: امکان نوشتن gocryptfs.conf وجود نداشت (در «\-init» یا «\-password»)
.PD 0
.P
.PD
26: دستور fsck خطاهایی یافت
.PD 0
.P
.PD
سایر موارد: لطفاً پیام خطا را بررسی کنید
.PP
همچنین ببینید:
https://github.com/rfjakob/gocryptfs/blob/master/internal/exitcodes/exitcodes.go
.SH "اشکالات (BUGS)"
.SS تکرار خط تیره (Dash duplication)
برنامه gocryptfs در نسخه 2.1 برای تجزیه خط فرمان به کتابخانه \f[CR]pflag\f[R] مهاجرت کرد تا از پرچم‌ها و آرگومان‌های مکانی با هر ترتیبی پشتیبانی کند.
برای حفظ سازگاری با گزینه‌های بلند تک‌خط‌تیره مانند \f[CR]\-extpass\f[R]، خط فرمان پیش‌پردازش شده و تمامی گزینه‌های دارای تک‌خط‌تیره به دوخط‌تیره تبدیل می‌شوند.
.PP
متأسفانه این بدان معناست که در دستور:
.IP
.EX
gocryptfs \-extpass myapp \-extpass \-X
.EE
.PP
برنامه gocryptfs گزینه \f[CR]\-X\f[R] را به \f[CR]\-\-X\f[R] تبدیل کرده و برنامه extpass را به صورت \f[CR]myapp \-\-X\f[R] فراخوانی می‌کند.
.PP
برای رفع این مشکل، لطفاً از فرمت زیر استفاده کنید:
.IP
.EX
gocryptfs \-extpass myapp \-extpass=\-X
.EE
.SH "همچنین ببینید (SEE ALSO)"
mount(2) fuse(8) fallocate(2) encfs(1) gitignore(5)
.SH "نویسندگان (AUTHORS)"
github.com/rfjakob.