نام (NAME)

fb — کلاینتی برای https://paste.xinu.at

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

fb [options] file|directory|id://ID|URL ... fb [-dg] [options] ID|URL ... fb [-hv]

توضیحات (DESCRIPTION)

fb کلاینتی برای https://paste.xinu.at است که به کاربر امکان می‌دهد به سادگی فایل‌ها را بارگذاری، حذف یا بارگیری کند. به‌طور پیش‌فرض، فایل‌ها همان‌گونه که هستند بارگذاری می‌شوند و پس از هر بارگذاری پیوندی به فایل در خروجی استاندارد چاپ می‌شود. اگر چند فایل بارگذاری شوند، یک پیوند چندگانه (multipaste - گزینه --multipaste را ببینید) به صورت خودکار ایجاد خواهد شد.

دایرکتوری‌ها به صورت یک فایل فشرده تاربال بسته‌بندی شده و فایل حاصل با نام upload.tar بارگذاری می‌شود. اگر هیچ آرگومانی داده نشود، داده‌ها از ورودی استاندارد (stdin) در یک فایل موقت خوانده شده و به محض دریافت انتهای فایل (EOF) بارگذاری می‌شوند. اگر فایلی که بارگذاری می‌شود بزرگتر از 10MiB باشد، fb حداکثر اندازه مجاز بارگذاری را از سرور استعلام می‌کند و در صورت عدم پذیرش، بارگذاری را لغو می‌نماید.

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

xclip(1): هنگام اجرا در X11
wl-clipboard(1): هنگام اجرا در Wayland
pbcopy(1): هنگام اجرا در Mac OS / Darwin

اگر می‌خواهید از paste.xinu.at استفاده کنید، باید در آن حساب کاربری ایجاد کرده و سپس دستور ‘fb -a’ را اجرا کنید تا کلید API ساخته شود.

شناسه‌های (ID) پیوندهای موجود را می‌توان به صورت URL اشاره‌کننده به آن پیوند یا با افزودن پیشوند "id://" به شناسه مشخص کرد.

گزینه‌ها (OPTIONS)

-c, --compress: فشرده‌سازی فایل‌های ارسالی با استفاده از gzip(1). این مورد بر روی تمام فایل‌ها از جمله محتوای پایپ‌شده و دایرکتوری‌ها اعمال می‌شود. اگر دو بار مشخص شود، به جای gzip از xz(1) استفاده خواهد شد. اگر همراه با گزینه -g استفاده شود، داده‌های بارگیری‌شده را قبل از چاپ در خروجی استاندارد از حالت فشرده خارج می‌کند.
-d, --delete: حذف شناسه‌ها. در این حالت دیگر نمی‌توانید فایلی بارگذاری کنید. اگر آرگومان یک URL باشد، fb تلاش می‌کند شناسه را از آن استخراج کند. این گزینه شناسه‌ها را بدون پیشوند "id://" نیز می‌پذیرد.
--config <config file>: استفاده از یک فایل پیکربندی جایگزین. مقدار پیش‌فرض "$XDG_CONFIG_HOME/fb-client/config" است.
-e extension, --extension extension: تغییر پسوند مورد استفاده برای رنگ‌آمیزی دستورها (Syntax Highlighting). همچنین در صورتی که فایل را قبلاً بارگذاری کرده‌اید، می‌توانید این کار را با افزودن پسوند به انتهای URL انجام دهید. آدرس https://paste.xinu.at/<ID>/bash نحوه نمایش را به bash تغییر می‌دهد.
-n <file name>, --name <file name>: استفاده از نام فایل مشخص‌شده برای بارگذاری در هنگام ارسال از ورودی استاندارد (stdin). پیش‌فرض "stdin" است.
-a, --create-apikey: ایجاد کلید API جدید. نام کاربری و گذرواژه پرسیده می‌شود.
-H, --history: نمایش تاریخچه بارگذاری‌ها.
-g, --get: بارگیری شناسه‌ها و نمایش در خروجی استاندارد. لطفاً هنگام استفاده از این گزینه احتیاط کنید، زیرا داده‌های باینری در صورت ارسال مستقیم به ترمینال ممکن است رفتارهای غیرمنتظره‌ای ایجاد کنند. در این حالت دیگر نمی‌توانید فایلی بارگذاری کنید. اگر آرگومان یک URL باشد، fb تلاش می‌کند شناسه را استخراج کند. این گزینه شناسه‌ها را بدون پیشوند "id://" نیز می‌پذیرد.
-m, --multipaste: ایجاد پیوند چندگانه (multipaste) از شناسه‌ها/فایل‌ها/دایرکتوری‌ها/آدرس‌های وب. این گزینه فایل‌ها را مانند حالت معمول بارگذاری می‌کند، اما سپس یک پیوند چندگانه ترکیبی از همه آنها ایجاد می‌نماید. آدرس‌هایی که با URL این پیست‌بین شروع می‌شوند شناسه‌شان استخراج شده و بارگیری نخواهند شد. تنها URL پیوند چندگانه نمایش داده شده و در کلیپ‌بورد کپی می‌شود. این گزینه در صورتی که چندین فایل بارگذاری شوند به صورت خودکار فعال می‌گردد.
-M <length>, --min-id-length <length>: درخواست از سرور برای ایجاد شناسه‌هایی با حداقل طول <length> نویسه. حداقل طول پشتیبانی‌شده دو نویسه است.
-h, --help: نمایش یک پیام راهنمای کوتاه.
-t, --tar: بارگذاری یک فایل tar شامل تمام فایل‌ها و دایرکتوری‌های مشخص‌شده در خط فرمان. نام فایل را می‌توان با گزینه -n مشخص کرد (هیچ پسوندی اضافه نکنید).
-v, --version: نمایش نسخه کلاینت.
-D, --debug: نمایش اطلاعات خطایابی.

فایل‌های پیکربندی (CONFIGURATION FILES)

$XDG_CONFIG_HOME/fb-client/apikey

این فایل شامل کلید API مورد استفاده برای احراز هویت است.

$XDG_CONFIG_HOME/fb-client/config

این فایل اجازه می‌دهد برخی متغیرها را با قالب 'option_name="value"' بازنویسی کنید. هم مقدار و هم نام گزینه، رشته‌هایی حساس به حروف کوچک و بزرگ هستند. می‌توان متغیرهای محیطی را با استفاده از نحو $VARIABLE_NAME در مقدار قرار داد.

نام گزینه‌های زیر پشتیبانی می‌شوند:

pastebin

آدرس URL پیست‌بینی که می‌خواهید استفاده کنید.

clipboard_cmd

دستور مورد استفاده برای کپی کردن آدرس فایل‌های بارگذاری‌شده در کلیپ‌بورد. پیش‌فرض در X11 برابر با xclip(1) ، در Wayland برابر با wl-copy(1) و در Mac OS / Darwin برابر با pbcopy(1) است.

clipboard_target

پیکربندی کلیپ‌بورد مورد استفاده. مقادیر مجاز:

default: استفاده از رفتار پیش‌فرض، یعنی "primary" برای X11/xclip و "clipboard" برای Wayland/wl-copy. اگر مشخص نشود، به صورت ضمنی پیش‌فرض همین است.
none / off: غیرفعال کردن کپی آدرس بارگذاری در کلیپ‌بورد.
primary: اجبار کپی در بخش انتخابی "primary" (برای Wayland/wl-copy).
clipboard: اجبار کپی در بخش انتخابی "clipboard" (برای X11/xclip).

apikey_file

فایلی که شامل کلید API است. مقدار پیش‌فرض "$XDG_CONFIG_HOME/fb-client/apikey" است.

محیط (ENVIRONMENT)

برخی گزینه‌ها را می‌توان با تغییر متغیرهای محیطی دگرگون ساخت:

GZIP: مقداردهی به GZIP باعث می‌شود برنامه gzip با مقدار آن طوری رفتار کند که گویی به خط فرمان اضافه شده است.
XZ_OPTS: متغیر محیطی XZ_OPTS را می‌توان برای ارسال گزینه‌های اضافی به xz در صورتی که xz برای فشرده‌سازی استفاده شود به کار برد.
TMPDIR: تنظیم TMPDIR به یک دایرکتوری باعث می‌شود fb فایل‌های موقت را درون آن دایرکتوری ایجاد کند نه در مسیر پیش‌فرض سیستم.

مثال‌ها (EXAMPLES)

fb -tc directory file: یک آرشیو .tar حاوی دایرکتوری و فایل ایجاد کرده، آن را با gzip فشرده می‌کند و به صورت یک آرشیو بارگذاری می‌نماید.
fb -c directory file: یک آرشیو .tar فقط حاوی دایرکتوری ایجاد می‌کند. هر دو (دایرکتوری و فایل) با gzip فشرده شده و به طور مستقل بارگذاری می‌شوند.
fb -cc directory: یک آرشیو .tar فقط حاوی دایرکتوری ایجاد کرده و آن را با xz فشرده می‌کند.
fb id://1bAc directory file https://paste.xinu.at/42SomeID http://example.com/example.png: یک پیوند چندگانه حاوی پیست موجود با شناسه 1bAc، تاربال دایرکتوری، فایل، پیست موجود 42SomeID و فایل example.png ایجاد می‌کند که توسط کلاینت بارگیری شده و سپس به سرور ارسال می‌شود.
make |& fb: خروجی دستور make (شامل خروجی استاندارد و خطای استاندارد) را در csh و پوسته‌های مشابه بارگذاری می‌کند.

همچنین ببینید (SEE ALSO)

curl(1), gzip(1), tar(1), xz(1), xclip(1)

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

fb توسط افراد زیر نوشته شده است:

Florian Pritz ⟨bluewind@xinu.at⟩
Moritz Wilhelmy ⟨moritz@wzff.de⟩

و تحت شرایط GPLv3 قابل بازتوزیع است.