| UUENVIEW(1) | General Commands Manual | UUENVIEW(1) |
نام (NAME)
uuenview - یک کدگذار قدرتمند برای فایل‌های باینری
خلاصه دستور (SYNOPSIS)
uuenview [options] file(s)
توضیحات (DESCRIPTION)
دستور uuenview یک فایل باینری را برای ارسال از طریق کانال‌های داده الکترونیکی غیر ۸ بیتی، مانند رایانامه یا یوزنت (usenet)، به متن ASCII کدگذاری می‌کند. uuenview یک زَبرمجموعه از دستور استاندارد uuencode(1) و کاملاً سازگار با نسخه‌های پیشین آن است که راحتی و انعطاف‌پذیری بیشتری را ارائه می‌دهد.
فایل‌های کدگذاری‌شده با uuenview تا زمانی که روش کدگذاری (در زیر مشاهده کنید) توسط طرف مقصد پشتیبانی شود، تقریباً با تمام رمزگشاها سازگار هستند. اگر طرف مقصد از uudeview(1) استفاده کند، هیچ مشکلی وجود نخواهد داشت.
در صورت پیکربندی مناسب، uuenview می‌تواند فایل‌های کدگذاری‌شده را مستقیماً از طریق رایانامه یا به یوزنت ارسال کند. این پیام‌ها در یک پاکت مناسب MIME قرار می‌گیرند که در صورت استفاده گیرنده از نرم‌افزارهای پستی یا خبری سازگار با MIME، بسیار کاربردی است.
گزینه‌ها (OPTIONS)
انتخاب کدگذاری (ENCODING SELECTION)
- -b
- روش کدگذاری Base64 را مطابق با استاندارد MIME انتخاب می‌کند.
- -u
- روش uuencoding را برای سازگاری با uuencode(1) انتخاب می‌کند.
- -y
- روش yEncoding را انتخاب می‌کند.
- -x
- روش اکنون منسوخ‌شده‌ی xxencoding را انتخاب می‌کند.
- -t
- فایل(ها) را به صورت متن ساده (plain text) ارسال می‌کند.
- -q
- فایل(ها) را با استفاده از کدگذاری quoted-printable کدگذاری می‌کند.
این گزینه‌ها به ترتیب موقعیت مکانی عمل می‌کنند و تا زمانی که تغییر داده نشوند، بر کدگذاری تمام فایل‌های باقی‌مانده در خط فرمان تأثیر می‌گذارند.
هنگام ارسال، پست کردن یا پیوست کردن فایل‌ها، پیش‌فرض استفاده از Base64 است که منجر به پیام‌های سازگار با MIME می‌شود. در غیر این صورت، هنگام کدگذاری در خروجی استاندارد یا در یک فایل، پیش‌فرض استفاده از uuencoding است.
مقصدها (TARGETS)
- -o
- مشخص می‌کند که خروجی باید در فایل‌ها نوشته شود. این فایل‌ها دارای نام پایه‌ای مشابه فایل مبدأ خواهند بود و پسوند آن‌ها بسته به تعداد بخش‌های مورد نیاز بر اساس گزینه -lines به صورت .001, .002 و غیره خواهد بود. فایل‌های کدگذاری‌شده در دایرکتوری جاری نوشته می‌شوند.
- -od path
- همانند '-o' است، اما فایل‌های کدگذاری‌شده به جای آن در دایرکتوری داده‌شده نوشته می‌شوند.
- -m email
- فایل(های) کدگذاری‌شده را که ممکن است هر یک به چندین بخش تقسیم شده باشند، به آدرس رایانامه داده‌شده ارسال می‌کند. گیرندگان متعدد را می‌توان به صورت یک فهرست نقل‌قول‌شده و جداشده با ویرگول مشخص کرد. در سیستم‌های یونیکس، رایانامه معمولاً به sendmail(8) هدایت (pipe) می‌شود.
- -p newsgroup
- فایل(های) کدگذاری‌شده را که ممکن است هر یک به چندین بخش تقسیم شده باشند، در گروه خبری مشخص‌شده پست می‌کند. گروه‌های خبری متعدد را می‌توان به صورت یک فهرست نقل‌قول‌شده و جداشده با ویرگول مشخص کرد. برنامه inews(1) برای ارسال فراخوانی می‌شود. ممکن است لازم باشد متغیر محیطی NNTPSERVER را روی سرور خبری خود تنظیم کنید.
- -a
- فایل‌ها را
پیوست
می‌کند.
انتظار
می‌رود این
قابلیت در
اسکریپت‌های
شل و موارد
مشابه
استفاده
شود. در
حالت
پیوست، یک
پیام کامل
همراه با
سرایندها
از ورودی
استاندارد
خوانده
می‌شود. سپس
فایل‌های
ارائه‌شده
در خط فرمان
به پیام
«پیوست»
می‌شوند که
در صورت
لزوم به
ساختار multipart
مناسب MIME
تبدیل
خواهد شد.
گزینه -a را
می‌توان با
-m یا -p
ترکیب کرد
تا نتیجه
مستقیماً
ایمیل یا
پست شود. در
غیر این
صورت، پیام
همراه با
پیوست‌ها
در خروجی
استاندارد
نوشته
می‌شود.
برنامه Uudeview از یک روش ابتکاری برای تشخیص محل پایان سرایندهای پیام ارائه‌شده و آغاز بدنه پیام استفاده می‌کند. اگر خط نخست با From یا نویسه‌های غیر از فاصله سفید به همراه یک دونقطه (مانند "X-header-blah:" یا "Patch#1:") آغاز نشود، برنامه uuenview کل ورودی را به عنوان بدنه پیام تفسیر می‌کند. در غیر این صورت، هر متنی قبل از نخستین خط خالی به عنوان سرایند تفسیر شده و مابقی ورودی ارائه‌شده به عنوان بدنه پیام در نظر گرفته می‌شود.
اگر هیچ گزینه مقصدی مشخص نشود، داده‌های کدگذاری‌شده در خروجی استاندارد چاپ می‌شوند.
سرایندها (HEADERS)
هنگام ایمیل یا پست کردن یک فایل، امکان تنظیم برخی سرایندها وجود دارد. دقت کنید پارامترهایی را که از بیش از یک کلمه تشکیل شده‌اند، در گیومه قرار دهید.
- -s subject
- خط سرایند Subject: را تنظیم می‌کند. نام فایل و شماره بخش به طور خودکار اضافه می‌شوند. بدون این گزینه، یک سرایند موضوع پیش‌فرض تولید می‌شود.
- -f from
- خط سرایند From: را تنظیم می‌کند.
- -r reply
- خط سرایند Reply-To: را تنظیم می‌کند.
سایر گزینه‌ها (OTHER)
- -v
- تمام کارهایی را که برنامه سعی در انجام آن‌ها دارد، به تفصیل چاپ می‌کند.
- -lines
- با جایگزین کردن lines با یک عدد، حداکثر تعداد خطوط کدگذاری‌شده در هر بخش را تعیین می‌کند. داده‌های کدگذاری‌شده به طور خودکار به تعداد بخش‌های لازم تقسیم می‌شوند. تعداد خطوط کمتر از ۲۰۰ نادیده گرفته می‌شود. روش‌های uuencoding و xxencoding مقدار ۴۵ کیلوبایت و Base64 مقدار ۵۷ کیلوبایت داده را در ۱۰۰۰ خط کدگذاری می‌کنند. اگر این گزینه مشخص نشود، پیش‌فرض تعداد خطوط نامحدود در هر بخش است که به ایجاد دقیقاً یک بخش منجر می‌شود.
- file(s)
- یک یا چند نام فایل برای پردازش. برای کدگذاری یک فایل از ورودی استاندارد، از یک خط تیره منفرد '-' استفاده کرده و نام فایلی را که برای فایل کدگذاری‌شده استفاده می‌شود به عنوان پارامتر بعدی وارد کنید.
گزینه‌ها همچنین می‌توانند در متغیر محیطی $UUENVIEW تنظیم شوند که پیش از پردازش گزینه‌ها در خط فرمان خوانده می‌شود.
نکات (NOTES)
فایل‌های خوانده‌شده از ورودی استاندارد فقط یک‌بار قابل استفاده هستند؛ بدین معنا که حداکثر یک گزینه مقصد می‌تواند مشخص شود.
خروجی نوشته‌شده در خروجی استاندارد نمی‌تواند به چندین بخش تقسیم شود. در این حالت، گزینه -lines نادیده گرفته می‌شود.
uuenview باید در زمان کامپایل به درستی پیکربندی شده باشد تا ارسال رایانامه و پست به درستی کار کند. اگر کار نمی‌کند، با مدیر سیستم خود مشورت کنید. برنامه‌ای که برای پست کردن یک فایل استفاده می‌شود را می‌توان در زمان اجرا با استفاده از متغیر محیطی INEWS تنظیم کرد. این تنظیم، پیکربندی زمان کامپایل را بازنویسی می‌کند.
فرمت Base64 به معنای MIME نیست. Base64 روش کدگذاری مشخص‌شده توسط استاندارد MIME است، اما برای اینکه یک پیام به یک پیام استاندارد MIME تبدیل شود، تعدادی سرایند مورد نیاز است. uuenview این سرایندها را هنگام ارسال رایانامه یا پست کردن تولید می‌کند، اما هنگام نوشتن در یک فایل تولید نمی‌کند. در این حالت، uuenview هیچ کنترلی بر روی سرایندها ندارد. اگر خروجی Base64 را در پیام‌های خود قرار دهید، آن‌ها سازگار با MIME نخواهند بود!
اگر نام برنامه را تغییر دهید، آن را کپی کنید یا به uuencode پیوند دهید، ممکن است به عنوان یک جایگزین هوشمند برای دستور استاندارد عمل کرده و ساختار خط فرمان یکسانی را بپذیرد. این مورد هنوز به خوبی آزمایش نشده است.
مثال‌ها (EXAMPLES)
- uuenview -m 'root,fred@somewhere.com' uudeview.tgz
- فایل uudeview.tgz را کدگذاری کرده و آن را هم برای مدیر سیستم محلی شما و هم برای دوستتان Fred در شرکت Somewhere ایمیل می‌کند.
اگر بیش از یک نام فایل در خط فرمان مشخص کنید، معمولاً با هر فایل به صورت جداگانه برخورد می‌شود. یک راهکار موقت برای ارسال همه آن‌ها به عنوان پیوست یک رایانامه واحد (یا خالی) به این صورت است:
- uuenview -m root -b -a file1 file2 < /dev/null
- یک رایانامه خالی ایجاد می‌کند و دو فایل مشخص‌شده را که با ساختار Base64 کدگذاری شده‌اند به آن پیوست کرده و نتیجه را برای مدیر سیستم شما ارسال می‌کند.
همچنین ببینید (SEE ALSO)
uudeview(1), uuencode(1), uudecode(1), sendmail(8), inews(1).
وب‌گاه uudeview در وب،
گزارش باگ‌ها (BUGS)
برنامه شرایط خطا را هنگام ارسال رایانامه یا پست تشخیص نمی‌دهد.
پیوست کردن فایل‌ها تنها زمانی به درستی عمل می‌کند که برخی سرایندهای پیام ورودی (برای مثال Content-Type) شکسته نشده باشند و کوتاه‌تر از ۱۰۲۴ نویسه باشند.
امکان کدگذاری به فرمت BinHex وجود ندارد.
به احتمال بسیار زیاد، برنامه در کار با داده‌های باینری به عنوان ورودی برای پیوست‌های متنی ساده یا quoted-printable با شکست مواجه خواهد شد. در پیوست‌های متنی ساده، محدودیت طول خط (که طبق MIME باید کمتر از ۹۹۸ نویسه باشد) اعمال نمی‌شود.
تنظیم مقدار "charset" برای پیوست‌های متنی ساده امکان‌پذیر نیست.
تنظیم مقدار نوع محتوا (content type) برای پیوست‌ها امکان‌پذیر نیست.
sendmail(8) با رسیدن به خطی که تنها شامل یک نقطه باشد خواندن را متوقف می‌کند. uudeview فایل‌های ورودی متنی ساده را برای این شرایط بررسی نمی‌کند. (این مشکل هنگام استفاده از quoted-printable برطرف می‌شود و در سایر روش‌های کدگذاری نیز وجود ندارد.)
| June 2001 |