نام (NAME)

vstpg, vstpp - انتقال پرونده با VisioBraille

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

vstpg [-ifbnd] [-s socketport] [-k keyname] [-o configname] file ...

توضیحات (DESCRIPTION)

دستور vstpg (و در مقابل vstpp) پرونده‌ها را از (و در مقابل به) یک پایانه VisioBraille دریافت می‌کند (قرار می‌دهد).

برای برقراری ارتباط با پایانه، باید brltty را با درایور BrlNet اجرا کرده و به BrlNet اعلام کنید که از درایور VisioBraille استفاده کند.

پیش از ارسال به پایانه، نام پرونده‌ها بدون هرگونه پسوند به ۸ نویسه کوتاه می‌شوند.

پیش از دریافت از پایانه، مسیر ابتدایی و پسوندهای انتهایی حذف می‌شوند، اما مجدداً برای نام پرونده محلی اعمال می‌گردند.

گزینه‌های خط فرمان (OPTIONS)

-i: درخواست تایید انتقال برای هر پرونده (روی پایانه)
-f: عدم درخواست تاییدیه (پیش‌فرض)
-b: در صورت وجود پرونده‌های قدیمی، نام آن‌ها را با افزودن پسوند x. به صورت بازگشتی تغییر می‌دهد، همانند کاری که logrotate انجام می‌دهد
-n: عدم نگه‌داری چنین پرونده‌های پشتیبانی (پیش‌فرض)
-s socketport: استفاده از socketport به عنوان شماره درگاه به جای درگاه پیش‌فرض برای اتصال به BrlNet
-k filename: استفاده از filename به عنوان مسیر کلید به جای مسیر پیش‌فرض جهت خواندن کلید احراز هویت BrlNet
-d: استفاده از شاخه جاری به جای شاخه بارگیری (به vbs_dir در زیر مراجعه کنید)
-o filename: خواندن filename به عنوان پرونده پیکربندی

پرونده پیکربندی (FILES)

دستورات vstpg و vstpp یک پرونده پیکربندی به نشانی $HOME/.vstprc را می‌خوانند که در هر سطر آن یک کلیدواژه یا تساوی قرار دارد (محتوای پس از # نادیده گرفته می‌شود).

می‌توانید با استفاده از گزینه -o از آن‌ها بخواهید هر پرونده دیگری را نیز بخوانند.

کلیدواژه‌ها عبارتند از:

backup: تبدیل گزینه -b به حالت پیش‌فرض
nobackup: تبدیل گزینه -f به حالت پیش‌فرض
و تساوی‌ها عبارتند از:
keyname = filename: استفاده از این پرونده به جای پیش‌فرض برای یافتن کلید احراز هویت BrlNet
socketport = port: استفاده از این شماره درگاه به جای پیش‌فرض جهت اتصال به BrlNet
vbs_ext = .ext: استفاده از ext. به عنوان پسوند پرونده‌های بارگیری‌شده (پیش‌فرض vis.)؛ در صورتی که پسوند در نام پرونده در خط فرمان ذکر شود، این مقدار نادیده گرفته می‌شود
vbs_dir = path: استفاده از path به جای شاخه جاری برای ذخیره پرونده‌ها، مگر هنگام استفاده از گزینه -d یا زمانی که نام پرونده با '.' آغاز شود

وضعیت خروج (EXIT STATUS)

1	syntax error on command line
2	connection with BrlNet error
3	Unix file error
4	Protocol error
16	interrupted by user

گسترش‌های شل (SHELL EXPANSIONS)

مراقب نویسه‌های خاص باشید: * و . اغلب توسط پوسته شما بسط داده می‌شوند، بنابراین vstpp * احتمالاً همان کاری را می‌کند که می‌خواهید؛ یعنی قرار دادن تمامی پرونده‌های موجود در شاخه جاری بر روی پایانه، اما vstpg * ممکن است مطابق میل شما عمل نکند: فقط پرونده‌هایی را دریافت می‌کند که از قبل در شاخه جاری وجود دارند و از آن‌هایی که به تازگی روی پایانه ساخته‌اید صرف‌نظر می‌کند! اگر می‌خواهید تمام پرونده‌های موجود در پایانه را دریافت کنید، باید از vstpg '*' یا دستور مشابهی استفاده کنید (لطفاً راهنمای پوسته خود را مطالعه فرمایید).

همین هشدار درباره سایر نویسه‌های خاص نظیر $، ~، &، ... نیز صدق می‌کند که باید با قرار دادن نقل‌قول (') در اطراف آرگومان‌ها یا درج یک بک‌اسلش (\) درست پیش از آن‌ها محافظت شوند.

اشکالات (BUGS)

تنها موردی که توانستیم پیدا کنیم برطرف شده است :)

نویسنده (AUTHOR)

Samuel Thibault <samuel.thibault@ens-lyon.org> و Sebastien Hinderer <sebastien.hinderer@ens-lyon.fr>