.\"  Copyright (c) 2008-2012 Red Hat, Inc. <http://www.redhat.com>
.\"  This file is part of GlusterFS.
.\"
.\"  This file is licensed to you under your choice of the GNU Lesser
.\"  General Public License, version 3 or any later version (LGPLv3 or
.\"  later), or the GNU General Public License, version 2 (GPLv2), in all
.\"  cases as published by the Free Software Foundation.
.\"
.TH GlusterFS 8 "Clustered File System" "07 March 2011" "Gluster Inc."
.SH "نام (NAME)"
glusterfs \- سامانه پرونده توزیع‌شده کلاینت GlusterFS
.SH "خلاصه دستور (SYNOPSIS)"
.B glusterfs
.I [options] [mountpoint]
.PP
.SH "توضیحات (DESCRIPTION)"
‏GlusterFS یک سامانه پرونده کلاسترشده است که توانایی مقیاس‌پذیری تا چندین پتابایت را دارد.
این سامانه بریک‌های (brick) ذخیره‌سازی گوناگون را از طریق Infiniband RDMA یا TCP/IP تجمیع کرده
و با اتصال داخلی به یک سامانه پرونده شبکه‌ای موازی و بزرگ تبدیل می‌کند. بریک‌های ذخیره‌سازی را
می‌توان از سخت‌افزارهای تجاری و متداول، مانند سرورهای x86-64 مجهز به RAID ساتا-۲ (SATA-II) و
کارت Infiniband HBA ساخت.

‏GlusterFS سامانه‌ای کاملاً سازگار با استاندارد POSIX است. در سمت کلاینت به بسته FUSE وابستگی
دارد و در سمت سرور به‌صورت روان و یکپارچه روی سیستم‌عامل‌های گوناگون کار می‌کند.
در حال حاضر روی سامانه‌های GNU/Linux و Solaris پشتیبانی می‌شود.

.SH "گزینه‌ها (OPTIONS)"

.SS "گزینه‌های پایه (Basic options)"
.PP
.TP
\fB\-f, \fB\-\-volfile=VOLUME-FILE\fR
فایلی که باید به‌عنوان VOLUME-FILE استفاده شود.
.TP
\fB\-l, \fB\-\-log\-file=LOGFILE\fR
فایلی که برای ثبت رویدادها (لاگ) استفاده می‌شود (پیش‌فرض <INSTALL-DIR>/var/log/glusterfs/<MOUNT-POINT>.log است).
.TP
\fB\-L, \fB\-\-log\-level=LOGLEVEL\fR
شدت ثبت پیام‌ها در لاگ. مقادیر معتبر عبارتند از TRACE، DEBUG، INFO، WARNING، ERROR و CRITICAL (پیش‌فرض INFO است).
.TP
\fB\-s, \fB\-\-volfile\-server=SERVER\fR
سروری که حجم (volume) از آن دریافت می‌شود. این گزینه اولویت بیشتری نسبت به گزینه \fB\-\-volfile\fR دارد.
.TP
\fB\-\-volfile\-max\-fetch\-attempts=MAX\-ATTEMPTS\fR
حداکثر تعداد تلاش‌ها برای اتصال به سرور. این گزینه باید همراه با گزینه \fB\-\-volfile\-server\fR مشخص شود (پیش‌فرض ۱ است).

.SS "گزینه‌های پیشرفته (Advanced options)"
.PP
.TP
\fB\-\-acl\fR
سوار کردن (mount) سامانه پرونده با پشتیبانی از POSIX ACL.
.TP
\fB\-\-localtime\-logging\fR
فعال‌سازی برچسب زمانی بر اساس زمان محلی در ثبت گزارش‌ها (لاگ).
.TP
\fB\-\-debug\fR
اجرا در حالت اشکال‌زدایی (debug). این گزینه مقدارهای \fB\-\-no\-daemon\fR و \fB\-\-log\-level\fR را برابر با DEBUG و \fB\-\-log\-file\fR را روی کنسول تنظیم می‌کند.
.TP
\fB\-\-enable\-ino32=BOOL\fR
استفاده از inodeهای ۳۲ بیتی هنگام سوار کردن برای دور زدن مشکل برنامه‌هایی که از inodeهای ۶۴ بیتی پشتیبانی نمی‌کنند.
.TP
\fB\-\-fopen\-keep\-cache[=BOOL]\fR
عدم پاکسازی حافظه موقت (cache) هنگام باز کردن فایل (پیش‌فرض: false).
.TP
\fB\-\-mac\-compat=BOOL\fR
ارائه کدهای رابط بدلی (stubs) برای ویژگی‌های مورد نیاز جهت کارکرد بدون نقص در مک (پیش‌فرض غیرفعال است).
.TP
\fB\-N, \fB\-\-no\-daemon\fR
اجرا در پیش‌زمینه (foreground).
.TP
\fB\-p, \fB\-\-pid\-file=PIDFILE\fR
فایلی که به عنوان فایل PID استفاده می‌شود.
.TP
\fB\-\-read\-only\fR
سوار کردن سامانه پرونده در حالت «فقط‌خواندنی» (read-only).
.TP
\fB\-\-selinux\fR
فعال‌سازی پشتیبانی از برچسب‌های SELinux (ویژگی‌های گسترش‌یافته) روی inodeها.
.TP
\fB\-S, \fB\-\-socket\-file=SOCKFILE\fR
فایلی که به عنوان سوکت یونیکس (unix-socket) استفاده می‌شود.
.TP
\fB\-\-volfile\-id=KEY\fR
شناسه/کلید فایل حجم (volume file) که باید از سرور دریافت شود.
.TP
\fB\-\-volfile\-server\-port=PORT\fR
شماره درگاه (پورت) سرور volfile.
.TP
\fB\-\-volfile\-server\-transport=TRANSPORT\fR
نوع پروتکل انتقال برای دریافت فایل حجم از سرور (پیش‌فرض tcp است).
.TP
\fB\-\-volume\-name=VOLUME\-NAME\fR
نام حجمی که برای MOUNT-POINT استفاده می‌شود (پیش‌فرض بالاترین حجم در VOLUME-FILE است).
.TP
\fB\-\-worm\fR
سوار کردن سامانه پرونده در حالت «worm» (یک‌بار بنویس، چندبار بخوان).
.TP
\fB\-\-xlator\-option=VOLUME\-NAME.OPTION=VALUE\fR
افزودن یا بازنویسی گزینه مترجم (translator) برای یک حجم با مقدار مشخص‌شده.
.TP
\fB\-\-subdir\-mount=SUBDIR\-MOUNT\-PATH\fR
سوار کردن یک زیرپوشه به جای شاخه ریشه ('/') حجم.

.SS "گزینه‌های Fuse (Fuse options)"
.PP
.TP
\fB\-\-attr\-times\-granularity=NANOSECONDS\fR
تعیین میزان ریزدانگی (granularity) پشتیبانی‌شده برای زمان‌های ویژگی‌های فایل (پیش‌فرض ۰ است که کرنل با آن به عنوان نامشخص رفتار می‌کند؛ مقادیر واقعی و معتبر بین ۱ تا ۱۰۰۰۰۰۰۰۰۰ هستند).
.TP
\fB\-\-attribute\-timeout=SECONDS\fR
تنظیم زمان انقضای ویژگی‌ها به ثانیه (SECONDS) برای inodeها در ماژول کرنل fuse (پیش‌فرض ۱ است).
.TP
\fB\-\-background\-qlen=N\fR
تنظیم طول صف پس‌زمینه ماژول fuse به تعداد N (پیش‌فرض ۶۴ است).
.TP
\fB\-\-congestion\-threshold=N\fR
تنظیم آستانه ازدحام ماژول fuse به N (پیش‌فرض ۴۸ است).
.TP
\fB\-\-direct\-io\-mode=BOOL|auto\fR
تعیین راهبرد ورودی/خروجی مستقیم (direct I/O) در fuse (پیش‌فرض auto است).
.TP
\fB\-\-dump-fuse=PATH\fR
تخلیه ترافیک fuse در مسیر PATH.
.TP
\fB\-\-entry\-timeout=SECONDS\fR
تنظیم زمان انقضای مدخل‌ها به ثانیه (SECONDS) در ماژول کرنل fuse (پیش‌فرض ۱ است).
.TP
\fB\-\-gid\-timeout=SECONDS\fR
تنظیم مهلت زمانی لیست گروه‌های کمکی به ثانیه (SECONDS) برای مترجم fuse (پیش‌فرض ۰ است).
.TP
\fB\-\-kernel-writeback-cache=BOOL\fR
فعال‌سازی کش بازنویسی درون‌هسته‌ای (in-kernel writeback cache) در fuse.
.TP
\fB\-\-negative\-timeout=SECONDS\fR
تنظیم زمان انقضای منفی به ثانیه (SECONDS) در ماژول کرنل fuse (پیش‌فرض ۰ است).
.TP
\fB\-\-auto\-invalidation=BOOL\fR
کنترل اینکه آیا هسته fuse بتواند ویژگی‌ها، dentry و page-cache را به‌طور خودکار بی‌اعتبار سازد یا خیر. این گزینه را تنها در صورتی غیرفعال کنید که فایل‌ها یا پوشه‌های یکسان به‌طور هم‌زمان از طریق دو نقطه سوار کردن مختلف مورد دسترسی قرار نگیرند [پیش‌فرض: on].
.TP
\fB\-\-volfile-check\fR
فعال‌سازی بررسی دقیق و سخت‌گیرانه فایل حجم (volume file).

.SS "گزینه‌های گوناگون (Miscellaneous Options)"
.PP
.TP
\fB\-?, \fB\-\-help\fR
نمایش این راهنما.
.TP
\fB\-\-usage\fR
نمایش پیام کوتاه نحوه استفاده.
.TP
\fB\-V, \fB\-\-version\fR
چاپ نسخه برنامه.

.PP
.SH "فایل‌ها (FILES)"
.nf
/var/lib/glusterd/vols/*/*.vol
.fi
.SH "مثال‌ها (EXAMPLES)"
سوار کردن حجمی به نام foo بر روی سرور bar با سطح لاگ DEBUG در نقطه اتصال /mnt/foo:
.PP
.nf
# glusterfs \-\-log\-level=DEBUG \-\-volfile\-id=foo \-\-volfile\-server=bar /mnt/foo
.fi

.SH "همچنین ببینید (SEE ALSO)"
.nf
\fBfusermount\fR(1), \fBmount.glusterfs\fR(8), \fBgluster\fR(8)
.fi
.SH "حق نشر (COPYRIGHT)"
.nf
Copyright(c) 2006-2011  Red Hat, Inc.  <http://www.redhat.com>
.fi