.\" -*- mode: troff; coding: utf-8 -*- .\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>. .ie n \{\ . ds C` "" . ds C' "" 'br\} .el\{\ . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" .\" Required to disable full justification in groff 1.23.0. .if n .ds AD l .\" ======================================================================== .\" .IX Title "dos2unix 1" .TH dos2unix 1 2026-08-27 "dos2unix" 2026-08-27 .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "نام (NAME)" dos2unix \- مبدل قالب فایل‌های متنی DOS/Mac به Unix و برعکس .SH "خلاصه دستور (SYNOPSIS)" .IX Header "SYNOPSIS" .Vb 2 \& dos2unix [options] [FILE ...] [\-n INFILE OUTFILE ...] \& unix2dos [options] [FILE ...] [\-n INFILE OUTFILE ...] .Ve .SH "توضیحات (DESCRIPTION)" .IX Header "DESCRIPTION" بستهٔ dos2unix شامل ابزارهای \f(CW\*(C`dos2unix\*(C'\fR و \f(CW\*(C`unix2dos\*(C'\fR برای تبدیل فایل‌های متنی ساده در قالب‌های DOS یا Mac به قالب Unix و برعکس است. .PP در فایل‌های متنی DOS/Windows شکستگی خط، که با نام خط جدید (newline) نیز شناخته می‌شود، ترکیبی از دو نویسه است: یک بازگشت به ابتدای سطر (CR) به همراه سطر جدید (LF). در فایل‌های متنی Unix شکستگی خط یک نویسهٔ منفرد است: سطر جدید (LF). در فایل‌های متنی Mac، پیش از Mac OS X، شکستگی خط یک نویسهٔ منفردِ بازگشت به ابتدای سطر (CR) بود. امروزه Mac OS از شکستگی‌های خط به سبک Unix یعنی (LF) استفاده می‌کند. .PP علاوه بر شکستگی‌های خط، dos2unix می‌تواند کُدگذاری فایل‌ها را نیز تبدیل کند. چند صفحهٔ کُد (code page) داس را می‌توان به Unix Latin\-1 تبدیل کرد. همچنین فایل‌های یونیکُد ویندوز (UTF\-16) را می‌توان به فایل‌های یونیکُد یونیکس (UTF\-8) تبدیل کرد. .PP از فایل‌های باینری به طور خودکار صرف‌نظر می‌شود، مگر اینکه تبدیل به صورت اجباری تعیین شده باشد. .PP از فایل‌های غیرعادی (non-regular)، مانند دایرکتوری‌ها و FIFOها، به طور خودکار صرف‌نظر می‌شود. .PP پیوندهای نمادین (symbolic links) و مقصدهای آن‌ها به طور پیش‌فرض دست‌نخورده باقی می‌مانند. پیوندهای نمادین را می‌توان به صورت اختیاری جایگزین کرد، یا خروجی را می‌توان در مقصد پیوند نمادین نوشت. نوشتن در مقصد پیوند نمادین در ویندوز پشتیبانی نمی‌شود. .PP ابزار dos2unix بر اساس dos2unix در SunOS/Solaris الگوبرداری شده است. یک تفاوت مهم با نسخهٔ اصلی SunOS/Solaris وجود دارد: این نسخه به طور پیش‌فرض تبدیل درجا (حالت فایل قدیمی یا old file mode) را انجام می‌دهد، در حالی که نسخهٔ اصلی SunOS/Solaris فقط از تبدیل جفتی (حالت فایل جدید یا new file mode) پشتیبانی می‌کند. گزینه‌های \f(CW\*(C`\-o\*(C'\fR و \f(CW\*(C`\-n\*(C'\fR را نیز ببینید. تفاوت دیگر این است که نسخهٔ SunOS/Solaris به طور پیش‌فرض از تبدیل در حالت \fIiso\fR استفاده می‌کند، در حالی که این نسخه به طور پیش‌فرض از حالت تبدیل \fIascii\fR بهره می‌برد. .SH "گزینه‌ها (OPTIONS)" .IX Header "OPTIONS" .IP \fB\-\-\fR 4 .IX Item "--" با تمام گزینه‌های پس از این به عنوان نام فایل رفتار می‌کند. اگر می‌خواهید فایل‌هایی را که نامشان با خط تیره (dash) آغاز می‌شود تبدیل کنید، از این گزینه استفاده نمایید. برای نمونه، جهت تبدیل فایلی به نام «\-foo»، می‌توانید از این دستور استفاده کنید: .Sp .Vb 1 \& dos2unix \-\- \-foo .Ve .Sp یا در حالت فایل جدید: .Sp .Vb 1 \& dos2unix \-n \-\- \-foo out.txt .Ve .IP \fB\-\-allow\-chown\fR 4 .IX Item "--allow-chown" اجازه دادن به تغییر مالکیت فایل در حالت فایل قدیمی. .Sp هنگام استفاده از این گزینه، در صورتی که مالکیت کاربر و/یا گروهِ فایل اصلی در حالت فایل قدیمی قابل حفظ نباشد، تبدیل لغو نخواهد شد. فرایند تبدیل ادامه می‌یابد و فایل تبدیل‌شده همان مالکیت جدیدی را دریافت می‌کند که گویی در حالت فایل جدید تبدیل شده است. همچنین گزینه‌های \f(CW\*(C`\-o\*(C'\fR و \&\f(CW\*(C`\-n\*(C'\fR را ببینید. این گزینه تنها در صورتی در دسترس است که dos2unix از حفظ مالکیت کاربر و گروه فایل‌ها پشتیبانی کند. .IP \fB\-ascii\fR 4 .IX Item "-ascii" حالت تبدیل پیش‌فرض. بخش «حالت‌های تبدیل (CONVERSION MODES)» را نیز ببینید. .IP \fB\-iso\fR 4 .IX Item "-iso" تبدیل بین مجموعه نویسه‌های DOS و ISO\-8859\-1. بخش «حالت‌های تبدیل (CONVERSION MODES)» را نیز ببینید. .IP \fB\-1252\fR 4 .IX Item "-1252" استفاده از صفحهٔ کُد 1252 ویندوز (اروپای غربی). .IP \fB\-437\fR 4 .IX Item "-437" استفاده از صفحهٔ کُد 437 داس (ایالات متحده). این صفحهٔ کُد پیش‌فرض برای تبدیل ISO است. .IP \fB\-850\fR 4 .IX Item "-850" استفاده از صفحهٔ کُد 850 داس (اروپای غربی). .IP \fB\-860\fR 4 .IX Item "-860" استفاده از صفحهٔ کُد 860 داس (پرتغالی). .IP \fB\-863\fR 4 .IX Item "-863" استفاده از صفحهٔ کُد 863 داس (فرانسوی کانادایی). .IP \fB\-865\fR 4 .IX Item "-865" استفاده از صفحهٔ کُد 865 داس (نوردیک). .IP \fB\-7\fR 4 .IX Item "-7" تبدیل نویسه‌های 8 بیتی به فضای 7 بیتی. .IP "\fB\-b, \-\-keep\-bom\fR" 4 .IX Item "-b, --keep-bom" نگه‌داشتن نشانگر ترتیب بایت (BOM). زمانی که فایل ورودی دارای BOM باشد، یک BOM در فایل خروجی می‌نویسد. این رفتار پیش‌فرض هنگام تبدیل به شکستگی‌های خط DOS است. گزینهٔ \f(CW\*(C`\-r\*(C'\fR را نیز ببینید. .IP "\fB\-c, \-\-convmode CONVMODE\fR" 4 .IX Item "-c, --convmode CONVMODE" تنظیم حالت تبدیل. که در آن CONVMODE یکی از موارد زیر است: \&\fIascii\fR، \fI7bit\fR، \fIiso\fR، \fImac\fR که ascii حالت پیش‌فرض است. .IP "\fB\-D, \-\-display\-enc ENCODING\fR" 4 .IX Item "-D, --display-enc ENCODING" تنظیم کُدگذاری متن نمایش‌داده‌شده. که در آن ENCODING یکی از موارد زیر است: \&\fIansi\fR، \fIunicode\fR، \fIunicodebom\fR، \fIutf8\fR، \fIutf8bom\fR که ansi حالت پیش‌فرض است. .Sp این گزینه فقط در dos2unix برای ویندوز با پشتیبانی از نام فایل‌های یونیکُد در دسترس است. این گزینه هیچ تأثیری بر نام واقعی فایل‌های خوانده‌شده و نوشته‌شده ندارد، بلکه فقط بر نحوهٔ نمایش آن‌ها اثر می‌گذارد. .Sp روش‌های مختلفی برای نمایش متن در کنسول ویندوز بر اساس کُدگذاری متن وجود دارد. همهٔ آن‌ها مزایا و معایب خاص خود را دارند. .RS 4 .IP \fBansi\fR 4 .IX Item "ansi" روش پیش‌فرض dos2unix استفاده از متن با کُدگذاری ANSI است. مزیت آن سازگاری رو به عقب (backwards compatibility) است. این روش با قلم‌های شطرنجی (raster) و TrueType کار می‌کند. در برخی مناطق ممکن است لازم باشد با استفاده از دستور \f(CW\*(C`chcp\*(C'\fR صفحهٔ کُد فعالِ DOS OEM را به صفحهٔ کُد ANSI سیستم ویندوز تغییر دهید، زیرا dos2unix از صفحهٔ کُد سیستم ویندوز استفاده می‌کند. .Sp عیب ansi این است که نام فایل‌های بین‌المللی حاوی نویسه‌های خارج از صفحهٔ کُد پیش‌فرض سیستم، به درستی نمایش داده نمی‌شوند؛ به جای آن‌ها علامت سؤال یا نمادی نادرست مشاهده خواهید کرد. اگر با نام فایل‌های بین‌المللی کار نمی‌کنید، این روش مشکلی نخواهد داشت. .IP "\fBunicode, unicodebom\fR" 4 .IX Item "unicode, unicodebom" مزیت کُدگذاری unicode (نام ویندوز برای UTF\-16) این است که متن معمولاً به درستی نمایش داده می‌شود. نیازی به تغییر صفحهٔ کُد فعال نیست. برای نمایش صحیح نویسه‌های بین‌المللی ممکن است نیاز باشد قلم کنسول را روی یک قلم TrueType تنظیم کنید. هنگامی که نویسه‌ای در قلم TrueType موجود نباشد، معمولاً یک مربع کوچک، گاهی اوقات همراه با یک علامت سؤال در داخل آن مشاهده می‌کنید. .Sp هنگامی که از کنسول ConEmu استفاده می‌کنید، همهٔ متن‌ها به درستی نمایش داده می‌شوند، زیرا ConEmu به طور خودکار قلم مناسبی را انتخاب می‌کند. .Sp عیب unicode این است که با ASCII سازگار نیست. زمانی که خروجی را به برنامهٔ دیگری هدایت (redirect) می‌کنید، مدیریت آن آسان نخواهد بود. .Sp هنگامی که روش \f(CW\*(C`unicodebom\*(C'\fR استفاده شود، پیش از متن یونیکُد یک BOM (نشانگر ترتیب بایت) قرار می‌گیرد. وجود BOM برای هدایت خروجی یا لوله‌کشی (piping) صحیح در PowerShell الزامی است..IP "\fButf8, utf8bom\fR" 4 .IX Item "utf8, utf8bom" مزیت utf8 سازگاری آن با ASCII است. لازم است قلم کنسول را روی یک قلم TrueType تنظیم کنید. با یک قلم TrueType، متن مشابه با کدگذاری \f(CW\*(C`unicode\*(C'\fR نمایش داده می‌شود. .Sp عیب آن این است که هنگام استفاده از قلم شطرنجی (raster font) پیش‌فرض، تمام نویسه‌های غیر ASCII به اشتباه نمایش داده می‌شوند. نه تنها نام‌های یونیکد فایل‌ها، بلکه پیام‌های ترجمه‌شده نیز ناخوانا می‌شوند. در ویندوز پیکربندی‌شده برای منطقهٔ شرق آسیا، ممکن است هنگام نمایش پیام‌ها لرزش و پرش زیادی در کنسول مشاهده کنید. .Sp در کنسول ConEmu روش کدگذاری utf8 به خوبی کار می‌کند. .Sp هنگامی که از روش \f(CW\*(C`utf8bom\*(C'\fR استفاده می‌شود، متن UTF\-8 با یک علامت ترتیب بایت یا BOM (مخفف Byte Order Mark) آغاز خواهد شد. برای هدایت مجدد (redirection) یا لوله‌کشی (piping) صحیح در PowerShell، وجود BOM الزامی است. .RE .RS 4 .Sp کدگذاری پیش‌فرض را می‌توان با تنظیم متغیر محیطی DOS2UNIX_DISPLAY_ENC به مقادیر \f(CW\*(C`unicode\*(C'\fR، \f(CW\*(C`unicodebom\*(C'\fR، \f(CW\*(C`utf8\*(C'\fR یا \f(CW\*(C`utf8bom\*(C'\fR تغییر داد. .RE .IP "\fB\-e, \-\-add\-eol\fR" 4 .IX Item "-e, --add-eol" افزودن شکست خط به سطر پایانی در صورتی که فاقد آن باشد. این گزینه برای تمام تبدیل‌ها اعمال می‌شود. .Sp فایلی که از قالب DOS به Unix تبدیل می‌شود ممکن است در سطر آخر فاقد شکست خط باشد. برخی از ویرایشگرهای متن فایل‌ها را بدون شکست خط در سطر آخر ذخیره می‌کنند. برخی از برنامه‌های Unix در پردازش این فایل‌ها دچار مشکل می‌شوند، زیرا استاندارد POSIX تعیین می‌کند که هر خط در یک فایل متنی باید با یک نویسهٔ خط‌جدید (newline) خاتمه یابد. برای نمونه، الحاق کردن فایل‌ها (concatenation) ممکن است نتیجهٔ مورد انتظار را در پی نداشته باشد. .IP \fB\-\-error\-binary\fR 4 .IX Item "--error-binary" بازگرداندن خطا در صورتی که از یک فایل باینری صرف‌نظر شود. .IP "\fB\-f, \-\-force\fR" 4 .IX Item "-f, --force" اجبار به تبدیل فایل‌های باینری. .IP "\fB\-gb, \-\-gb18030\fR" 4 .IX Item "-gb, --gb18030" در ویندوز، فایل‌های UTF\-16 صرف‌نظر از تنظیمات locale به‌طور پیش‌فرض به UTF\-8 تبدیل می‌شوند. از این گزینه برای تبدیل فایل‌های UTF\-16 به GB18030 استفاده کنید. این گزینه تنها در ویندوز در دسترس است. بخش GB18030 را نیز ببینید. .IP "\fB\-h, \-\-help\fR" 4 .IX Item "-h, --help" نمایش راهنما و خروج. .IP "\fB\-i[FLAGS], \-\-info[=FLAGS] FILE ...\fR" 4 .IX Item "-i[FLAGS], --info[=FLAGS] FILE ..." نمایش اطلاعات فایل. هیچ تبدیلی انجام نمی‌شود. .Sp اطلاعات زیر به همین ترتیب چاپ می‌شوند: تعداد شکست‌های خط DOS، تعداد شکست‌های خط Unix، تعداد شکست‌های خط Mac، علامت ترتیب بایت (BOM)، متنی یا باینری، نام فایل. .Sp خروجی نمونه: .Sp .Vb 8 \& 6 0 0 no_bom text dos.txt \& 0 6 0 no_bom text unix.txt \& 0 0 6 no_bom text mac.txt \& 6 6 6 no_bom text mixed.txt \& 50 0 0 UTF\-16LE text utf16le.txt \& 0 50 0 no_bom text utf8unix.txt \& 50 0 0 UTF\-8 text utf8dos.txt \& 2 418 219 no_bom binary dos2unix.exe .Ve .Sp توجه داشته باشید که گاهی ممکن است یک فایل باینری به اشتباه فایل متنی تشخیص داده شود. همچنین گزینهٔ \f(CW\*(C`\-s\*(C'\fR را ببینید. .Sp اگر علاوه‌بر این از گزینهٔ \f(CW\*(C`\-e\*(C'\fR یا \f(CW\*(C`\-\-add\-eol\*(C'\fR استفاده شود، نوع شکست خط در سطر پایانی نیز چاپ می‌شود، و در صورت نبود آن عبارت \f(CW\*(C`noeol\*(C'\fR چاپ خواهد شد. .Sp خروجی نمونه: .Sp .Vb 4 \& 6 0 0 no_bom text dos dos.txt \& 0 6 0 no_bom text unix unix.txt \& 0 0 6 no_bom text mac mac.txt \& 1 0 0 no_bom text noeol noeol_dos.txt .Ve .Sp به‌صورت اختیاری می‌توان پرچم‌های بیشتری را برای تغییر خروجی تعیین کرد. یک یا چند پرچم را می‌توان اضافه کرد. .RS 4 .IP \fB0\fR 4 .IX Item "0" چاپ خطوط اطلاعات فایل که به‌جای نویسهٔ خط‌جدید با یک نویسهٔ null خاتمه می‌یابند. این پرچم هنگام استفاده از پرچم c امکان تفسیر صحیح نام‌های فایلی را که شامل فاصله یا علامت‌های نقل‌قول هستند فراهم می‌کند. از این پرچم در ترکیب با گزینهٔ \f(CW\-0\fR یا \f(CW\*(C`\-\-null\*(C'\fR در \&\fBxargs\fR\|(1) استفاده کنید. .IP \fBd\fR 4 .IX Item "d" چاپ تعداد شکست‌های خط DOS. .IP \fBu\fR 4 .IX Item "u" چاپ تعداد شکست‌های خط Unix. .IP \fBm\fR 4 .IX Item "m" چاپ تعداد شکست‌های خط Mac. .IP \fBb\fR 4 .IX Item "b" چاپ علامت ترتیب بایت (BOM). .IP \fBt\fR 4 .IX Item "t" چاپ وضعیت متنی یا باینری بودن فایل. .IP \fBe\fR 4 .IX Item "e" چاپ نوع شکست خط در سطر آخر، یا \f(CW\*(C`noeol\*(C'\fR در صورت نبود آن. .IP \fBc\fR 4 .IX Item "c" تنها چاپ فایل‌هایی که تبدیل خواهند شد. .Sp با پرچم \f(CW\*(C`c\*(C'\fR، دستور dos2unix تنها فایل‌هایی را چاپ می‌کند که حاوی شکست خط DOS هستند، و دستور unix2dos تنها نام فایل‌هایی را چاپ می‌کند که شکست خط Unix دارند. .Sp اگر علاوه‌بر این از گزینهٔ \f(CW\*(C`\-e\*(C'\fR یا \f(CW\*(C`\-\-add\-eol\*(C'\fR استفاده شود، فایل‌هایی که در سطر پایانی فاقد شکست خط هستند نیز چاپ خواهند شد. .IP \fBh\fR 4 .IX Item "h" چاپ سربرگ. .IP \fBp\fR 4 .IX Item "p" نمایش نام فایل‌ها بدون مسیر. .RE .RS 4 .Sp مثال‌ها: .Sp نمایش اطلاعات برای تمام فایل‌های *.txt: .Sp .Vb 1 \& dos2unix \-i *.txt .Ve .Sp نمایش تنها تعداد شکست‌های خط DOS و شکست‌های خط Unix: .Sp .Vb 1 \& dos2unix \-idu *.txt .Ve .Sp نمایش تنها علامت ترتیب بایت (BOM): .Sp .Vb 1 \& dos2unix \-\-info=b *.txt .Ve .Sp فهرست کردن فایل‌هایی که دارای شکست خط DOS هستند: .Sp .Vb 1 \& dos2unix \-ic *.txt .Ve .Sp فهرست کردن فایل‌هایی که دارای شکست خط Unix هستند: .Sp .Vb 1 \& unix2dos \-ic *.txt .Ve .Sp فهرست کردن فایل‌هایی که دارای شکست خط DOS هستند یا در سطر پایانی شکست خط ندارند: .Sp .Vb 1 \& dos2unix \-e \-ic *.txt .Ve .Sp تبدیل تنها فایل‌هایی که شکست خط DOS دارند و دست‌نخورده باقی گذاشتن سایر فایل‌ها: .Sp .Vb 1 \& dos2unix \-ic0 *.txt | xargs \-0 dos2unix .Ve .Sp یافتن فایل‌های متنی که دارای شکست خط DOS هستند: .Sp .Vb 1 \& find \-name \*(Aq*.txt\*(Aq \-print0 | xargs \-0 dos2unix \-ic .Ve .RE .IP "\fB\-k, \-\-keepdate\fR" 4 .IX Item "-k, --keepdate" حفظ برچسب تاریخ و زمان فایل خروجی، مشابه با فایل ورودی. .IP "\fB\-L, \-\-license\fR" 4 .IX Item "-L, --license" نمایش پروانهٔ برنامه. .IP "\fB\-l, \-\-newline\fR" 4 .IX Item "-l, --newline" افزودن خط‌جدید اضافی. .Sp \&\fBdos2unix\fR: تنها شکست‌های خط DOS به دو شکست خط Unix تبدیل می‌شوند. در حالت Mac تنها شکست‌های خط Mac به دو شکست خط Unix تبدیل می‌شوند. .Sp \&\fBunix2dos\fR: تنها شکست‌های خط Unix به دو شکست خط DOS تبدیل می‌شوند. در حالت Mac شکست‌های خط Unix به دو شکست خط Mac تبدیل می‌شوند. .IP "\fB\-m, \-\-add\-bom\fR" 4 .IX Item "-m, --add-bom" نوشتن یک علامت ترتیب بایت (BOM) در فایل خروجی. به‌طور پیش‌فرض یک BOM برای UTF\-8 نوشته می‌شود. .Sp هنگامی که فایل ورودی UTF\-16 باشد و از گزینهٔ \f(CW\*(C`\-u\*(C'\fR استفاده شود، یک BOM برای UTF\-16 نوشته خواهد شد. .Sp هرگز از این گزینه هنگامی که کدگذاری خروجی چیزی غیر از UTF\-8، UTF\-16 یا GB18030 است استفاده نکنید. همچنین بخش UNICODE را ببینید..IP "\fB\-n, \-\-newfile INFILE OUTFILE ...\fR" 4 .IX Item "-n, --newfile INFILE OUTFILE ..." حالت فایل جدید. فایل INFILE را تبدیل کرده و خروجی را در فایل OUTFILE می‌نویسد. نام‌های فایل باید به صورت جفت ارائه شوند و از الگوهای عام (wildcard) \fIنباید\fR استفاده شود، در غیر این صورت فایل‌های خود را از دست \fIخواهید\fR داد. .Sp کسی که تبدیل را در حالت فایل جدید (جفتی) آغاز می‌کند، مالک فایل تبدیل‌شده خواهد بود. مجوزهای خواندن/نوشتن فایل جدید، همان مجوزهای فایل اصلی منهای مقدار \fBumask\fR\|(1) کاربری است که تبدیل را اجرا می‌کند. .IP \fB\-\-no\-allow\-chown\fR 4 .IX Item "--no-allow-chown" اجازه ندادن به تغییر مالکیت فایل در حالت فایل قدیمی (پیش‌فرض). .Sp هنگامی که مالکیت کاربر و/یا گروهِ فایل اصلی نتواند در حالت فایل قدیمی حفظ شود، تبدیل متوقف می‌شود. همچنین گزینه‌های \f(CW\*(C`\-o\*(C'\fR و \f(CW\*(C`\-n\*(C'\fR را ببینید. این گزینه تنها در صورتی در دسترس است که dos2unix از حفظ مالکیت کاربر و گروه فایل‌ها پشتیبانی کند. .IP \fB\-\-no\-add\-eol\fR 4 .IX Item "--no-add-eol" در صورتی که خط پایانی فاقد شکست خط باشد، شکست خطی به آن اضافه نشود (پیش‌فرض). .IP \fB\-\-no\-error\-binary\fR 4 .IX Item "--no-error-binary" در صورت نادیده گرفتن یک فایل باینری، خطایی برگردانده نشود (پیش‌فرض). .IP "\fB\-O, \-\-to\-stdout\fR" 4 .IX Item "-O, --to-stdout" نوشتن در خروجی استاندارد، مانند یک فیلتر Unix. برای بازگشت به حالت فایل قدیمی (درجا یا in\-place)، از گزینهٔ \f(CW\*(C`\-o\*(C'\fR استفاده کنید. .Sp در صورت ترکیب با گزینهٔ \f(CW\*(C`\-e\*(C'\fR، فایل‌ها را می‌توان به درستی به هم متصل (concatenate) کرد؛ بدون ادغام شدن خطوط پایانی و آغازین، و بدون نشانه‌های ترتیب بایت (BOM) یونیکد در میانهٔ فایلِ متصل‌شده. مثال: .Sp .Vb 1 \& dos2unix \-e \-O file1.txt file2.txt > output.txt .Ve .IP "\fB\-o, \-\-oldfile FILE ...\fR" 4 .IX Item "-o, --oldfile FILE ..." حالت فایل قدیمی. فایل FILE را تبدیل کرده و خروجی را روی آن بازنویسی می‌کند. برنامه به طور پیش‌فرض در این حالت اجرا می‌شود. نام‌های دارای نویسه عام (wildcard) مجاز هستند. .Sp در حالت فایل قدیمی (درجا یا in\-place)، فایل تبدیل‌شده همان مالک، گروه و مجوزهای خواندن/نوشتن فایل اصلی را دریافت می‌کند؛ حتی زمانی که فایل توسط کاربر دیگری تبدیل شود که مجوز نوشتن روی فایل را دارد (برای نمونه کاربر root). در صورتی که حفظ مقادیر اصلی ممکن نباشد، عملیات تبدیل متوقف خواهد شد. تغییر مالک می‌تواند به این معنی باشد که مالک اصلی دیگر قادر به خواندن فایل نخواهد بود. تغییر گروه نیز می‌تواند یک ریسک امنیتی باشد، زیرا ممکن است فایل برای اشخاصی که مورد نظر نبوده‌اند، قابل خواندن شود. حفظ مالک، گروه و مجوزهای خواندن/نوشتن تنها در Unix پشتیبانی می‌شود. .Sp برای بررسی اینکه آیا dos2unix از حفظ مالکیت کاربر و گروه فایل‌ها پشتیبانی می‌کند، عبارت \f(CW\*(C`dos2unix \-V\*(C'\fR را تایپ کنید. .Sp تبدیل همیشه از طریق یک فایل موقت انجام می‌شود. هنگامی که خطایی در میانهٔ تبدیل رخ دهد، فایل موقت حذف شده و فایل اصلی دست‌نخورده باقی می‌ماند. وقتی تبدیل با موفقیت انجام شود، فایل اصلی با فایل موقت جایگزین می‌شود. ممکن است شما مجوز نوشتن روی فایل اصلی را داشته باشید، اما مجوز تنظیم همان ویژگی‌های مالکیت کاربر و/یا گروهِ فایل اصلی را روی فایل موقت نداشته باشید. این بدان معناست که شما قادر به حفظ مالکیت کاربر و/یا گروه فایل اصلی نیستید. در این حالت می‌توانید از گزینهٔ \f(CW\*(C`\-\-allow\-chown\*(C'\fR برای ادامهٔ تبدیل استفاده کنید: .Sp .Vb 1 \& dos2unix \-\-allow\-chown foo.txt .Ve .Sp گزینهٔ دیگر، استفاده از حالت فایل جدید است: .Sp .Vb 1 \& dos2unix \-n foo.txt foo.txt .Ve .Sp مزیت گزینهٔ \f(CW\*(C`\-\-allow\-chown\*(C'\fR این است که می‌توانید از نویسه‌های عام استفاده کنید و ویژگی‌های مالکیت در صورت امکان حفظ خواهند شد. .IP "\fB\-q, \-\-quiet\fR" 4 .IX Item "-q, --quiet" حالت بی‌صدا. فرونشاندن تمامی هشدارها و پیام‌ها. مقدار بازگشتی صفر است، مگر زمانی که از گزینه‌های خط فرمان نادرست استفاده شده باشد. .IP "\fB\-r, \-\-remove\-bom\fR" 4 .IX Item "-r, --remove-bom" حذف نشانه ترتیب بایت (BOM). در فایل خروجی نشانه BOM نوشته نمی‌شود. این رفتارِ پیش‌فرض هنگام تبدیل به شکست خط‌های Unix است. همچنین گزینهٔ \f(CW\*(C`\-b\*(C'\fR را ببینید. .IP "\fB\-s, \-\-safe\fR" 4 .IX Item "-s, --safe" نادیده گرفتن فایل‌های باینری (پیش‌فرض). .Sp نادیده گرفتن فایل‌های باینری برای جلوگیری از اشتباهات ناخواسته انجام می‌شود. توجه داشته باشید که تشخیص فایل‌های باینری ۱۰۰٪ خطاناپذیر نیست. فایل‌های ورودی برای نمادهای باینری که معمولاً در فایل‌های متنی یافت نمی‌شوند، پویش می‌شوند. ممکن است یک فایل باینری تنها حاوی نویسه‌های متنی عادی باشد. چنین فایل باینری به اشتباه به عنوان یک فایل متنی دیده خواهد شد. .Sp به طور پیش‌فرض، هنگامی که یک فایل باینری نادیده گرفته می‌شود، خطایی بازگردانده نمی‌شود. زمانی که از گزینهٔ \&\f(CW\*(C`\-\-error\-binary\*(C'\fR استفاده شود، خطا برگردانده خواهد شد. .IP "\fB\-u, \-\-keep\-utf16\fR" 4 .IX Item "-u, --keep-utf16" حفظ کدگذاری اصلی UTF\-16 فایل ورودی. فایل خروجی در همان کدگذاری UTF\-16 (ترتیب بایت‌های little\-endian یا big\-endian) مانند فایل ورودی نوشته خواهد شد. این کار مانع از تبدیل به UTF\-8 می‌شود. بر همین اساس یک BOM مربوط به UTF\-16 نیز نوشته خواهد شد. این گزینه می‌تواند با گزینهٔ \f(CW\*(C`\-ascii\*(C'\fR غیرفعال شود. .IP "\fB\-ul, \-\-assume\-utf16le\fR" 4 .IX Item "-ul, --assume-utf16le" فرض کردن اینکه قالب فایل ورودی UTF\-16LE است. .Sp هنگامی که یک نشانه ترتیب بایت (BOM) در فایل ورودی وجود داشته باشد، BOM بر این گزینه اولویت دارد. .Sp اگر فرضی نادرست داشته باشید (فایل ورودی در قالب UTF\-16LE نبوده باشد) و تبدیل موفق شود، یک فایل خروجی UTF\-8 با متنی نادرست دریافت خواهید کرد. می‌توانید تبدیل اشتباه را با \fBiconv\fR\|(1) از طریق تبدیل فایل خروجی UTF\-8 به UTF\-16LE واگردانی کنید. این کار فایل اصلی را بازمی‌گرداند. .Sp فرض UTF\-16LE به عنوان یک \fIحالت تبدیل\fR عمل می‌کند. با جابه‌جایی به حالت پیش‌فرض \&\fIascii\fR، فرض UTF\-16LE خاموش می‌شود. .IP "\fB\-ub, \-\-assume\-utf16be\fR" 4 .IX Item "-ub, --assume-utf16be" فرض کردن اینکه قالب فایل ورودی UTF\-16BE است. .Sp این گزینه مانند گزینهٔ \f(CW\*(C`\-ul\*(C'\fR عمل می‌کند. .IP "\fB\-v, \-\-verbose\fR" 4 .IX Item "-v, --verbose" نمایش پیام‌های مفصل (verbose). اطلاعات بیشتری در مورد نشانه‌های ترتیب بایت و میزان شکست‌های خط تبدیل‌شده نمایش داده می‌شود. .IP "\fB\-F, \-\-follow\-symlink\fR" 4 .IX Item "-F, --follow-symlink" پیروی از پیوندهای نمادین و تبدیل مقصدهای آن‌ها. .IP "\fB\-R, \-\-replace\-symlink\fR" 4 .IX Item "-R, --replace-symlink" جایگزین کردن پیوندهای نمادین با فایل‌های تبدیل‌شده (فایل‌های مقصد اصلی بدون تغییر باقی می‌مانند). .IP "\fB\-S, \-\-skip\-symlink\fR" 4 .IX Item "-S, --skip-symlink" دست‌نخورده نگه داشتن پیوندهای نمادین و مقصدها (پیش‌فرض). .IP "\fB\-V, \-\-version\fR" 4 .IX Item "-V, --version" نمایش اطلاعات نسخه و خروج..SH "حالت مک (MAC MODE)" .IX Header "MAC MODE" به‌طور پیش‌فرض، شکست‌های خط از DOS به Unix و برعکس تبدیل می‌شوند. شکست‌های خط Mac تبدیل نمی‌شوند. .PP در حالت Mac، شکست‌های خط از Mac به Unix و برعکس تبدیل می‌شوند. شکست‌های خط DOS دست‌نخورده باقی می‌مانند. .PP برای اجرا در حالت Mac، از گزینهٔ خط فرمان \f(CW\*(C`\-c mac\*(C'\fR یا از دستورهای \f(CW\*(C`mac2unix\*(C'\fR یا \f(CW\*(C`unix2mac\*(C'\fR استفاده کنید. .SH "حالت‌های تبدیل (CONVERSION MODES)" .IX Header "CONVERSION MODES" .IP \fBascii\fR 4 .IX Item "ascii" این حالتِ پیش‌فرض تبدیل است. این حالت برای تبدیل فایل‌هایی با کدگذاری ASCII و سازگار با ASCII، مانند UTF\-8 است. فعال‌کردن حالت \fBascii\fR حالت‌های \&\fB7bit\fR و \fBiso\fR را غیرفعال می‌کند. .Sp اگر dos2unix از UTF\-16 پشتیبانی کند، فایل‌های با کدگذاری UTF\-16 در سیستم‌های POSIX به کدگذاری نویسهٔ locale فعلی و در ویندوز به UTF\-8 تبدیل می‌شوند. فعال‌کردن حالت \fBascii\fR گزینهٔ حفظ کدگذاری UTF\-16 (\f(CW\*(C`\-u\*(C'\fR) و گزینه‌های فرض ورودی UTF\-16 (\f(CW\*(C`\-ul\*(C'\fR و \f(CW\*(C`\-ub\*(C'\fR) را غیرفعال می‌کند. برای بررسی این‌که آیا dos2unix از UTF\-16 پشتیبانی می‌کند، دستور \f(CW\*(C`dos2unix \-V\*(C'\fR را اجرا کنید. همچنین بخش UNICODE را ببینید. .IP \fB7bit\fR 4 .IX Item "7bit" در این حالت تمام نویسه‌های ۸ بیتی غیر ASCII (با مقادیر ۱۲۸ تا ۲۵۵) به یک نویسهٔ فاصلهٔ ۷ بیتی تبدیل می‌شوند. .IP \fBiso\fR 4 .IX Item "iso" نویسه‌ها بین یک مجموعه نویسهٔ DOS (صفحه کد) و مجموعه نویسهٔ ISO یعنی ISO\-8859\-1 (Latin\-1) در Unix تبدیل می‌شوند. نویسه‌های DOS فاقد معادل ISO\-8859\-1، که تبدیل آن‌ها ممکن نیست، به یک نقطه تبدیل می‌شوند. همین قاعده برای نویسه‌های ISO\-8859\-1 فاقد معادل در DOS نیز صدق می‌کند. .Sp هنگامی که تنها از گزینهٔ \f(CW\*(C`\-iso\*(C'\fR استفاده شود، dos2unix تلاش خواهد کرد صفحه کد فعال را تشخیص دهد. در صورتی که این کار ممکن نباشد، dos2unix از صفحه کد پیش‌فرض CP437 که عمدتاً در ایالات متحده کاربرد دارد استفاده خواهد کرد. برای تحمیل یک صفحه کد خاص، از گزینه‌های \&\f(CW\-437\fR (ایالات متحده)، \f(CW\-850\fR (اروپای غربی)، \f(CW\-860\fR (پرتغالی)، \f(CW\-863\fR (فرانسوی کانادایی)، یا \f(CW\-865\fR (نوردیک) استفاده کنید. صفحه کد ویندوز CP1252 (اروپای غربی) نیز با گزینهٔ \f(CW\-1252\fR پشتیبانی می‌شود. برای سایر صفحه‌های کد، dos2unix را در ترکیب با \fBiconv\fR\|(1) به کار ببرید. ابزار Iconv می‌تواند بین فهرست بلندی از کدگذاری‌های نویسه تبدیل انجام دهد. .Sp هرگز تبدیل ISO را روی فایل‌های متنی یونیکد اعمال نکنید؛ چرا که فایل‌های با کدگذاری UTF\-8 را خراب خواهد کرد. .Sp چند مثال: .Sp تبدیل از صفحه کد پیش‌فرض DOS به Latin\-1 یونیکس: .Sp .Vb 1 \& dos2unix \-iso \-n in.txt out.txt .Ve .Sp تبدیل از DOS CP850 به Latin\-1 یونیکس: .Sp .Vb 1 \& dos2unix \-850 \-n in.txt out.txt .Ve .Sp تبدیل از Windows CP1252 به Latin\-1 یونیکس: .Sp .Vb 1 \& dos2unix \-1252 \-n in.txt out.txt .Ve .Sp تبدیل از Windows CP1252 به UTF\-8 یونیکس (یونیکد): .Sp .Vb 1 \& iconv \-f CP1252 \-t UTF\-8 in.txt | dos2unix > out.txt .Ve .Sp تبدیل از Latin\-1 یونیکس به صفحه کد پیش‌فرض DOS: .Sp .Vb 1 \& unix2dos \-iso \-n in.txt out.txt .Ve .Sp تبدیل از Latin\-1 یونیکس به DOS CP850: .Sp .Vb 1 \& unix2dos \-850 \-n in.txt out.txt .Ve .Sp تبدیل از Latin\-1 یونیکس به Windows CP1252: .Sp .Vb 1 \& unix2dos \-1252 \-n in.txt out.txt .Ve .Sp تبدیل از UTF\-8 یونیکس (یونیکد) به Windows CP1252: .Sp .Vb 1 \& unix2dos < in.txt | iconv \-f UTF\-8 \-t CP1252 > out.txt .Ve .Sp همچنین ببینید: و . .SH "یونیکد (UNICODE)" .IX Header "UNICODE" .SS "کدگذاری‌ها (Encodings)" .IX Subsection "Encodings" کدگذاری‌های یونیکد متفاوتی وجود دارند. در Unix و Linux فایل‌های یونیکد معمولاً دارای کدگذاری UTF\-8 هستند. در Windows فایل‌های متنی یونیکد می‌توانند دارای کدگذاری UTF\-8، UTF\-16 یا UTF\-16 big\-endian باشند، اما بیشتر در قالب UTF\-16 کدگذاری می‌شوند. .SS "تبدیل (Conversion)" .IX Subsection "Conversion" فایل‌های متنی یونیکد نیز مانند فایل‌های متنی ASCII می‌توانند دارای شکست‌های خط DOS، Unix یا Mac باشند. .PP تمام نسخه‌های dos2unix و unix2dos می‌توانند فایل‌های با کدگذاری UTF\-8 را تبدیل کنند؛ زیرا UTF\-8 برای سازگاری عقبروی با ASCII طراحی شده است. .PP ابزارهای dos2unix و unix2dos مجهز به پشتیبانی از Unicode UTF\-16، می‌توانند فایل‌های متنی با کدگذاری UTF\-16 در دو حالت little\-endian و big\-endian را بخوانند. برای بررسی اینکه آیا dos2unix با پشتیبانی از UTF\-16 ساخته شده است، عبارت \f(CW\*(C`dos2unix \-V\*(C'\fR را اجرا کنید. .PP در Unix/Linux فایل‌های با کدگذاری UTF\-16 به کدگذاری نویسهٔ locale جاری تبدیل می‌شوند. برای پیدا کردن کدگذاری نویسهٔ locale از دستور \fBlocale\fR\|(1) استفاده کنید. هنگامی که تبدیل امکان‌پذیر نباشد، خطای تبدیل رخ می‌دهد و فایل نادیده گرفته خواهد شد. .PP در Windows فایل‌های UTF\-16 به‌طور پیش‌فرض به UTF\-8 تبدیل می‌شوند. فایل‌های متنی با قالب UTF\-8 به‌خوبی در هر دو سیستم‌عامل Windows و Unix/Linux پشتیبانی می‌شوند. .PP کدگذاری‌های UTF\-16 و UTF\-8 کاملاً با یکدیگر سازگارند و هیچ متنی در طول تبدیل از بین نخواهد رفت. هنگامی که یک خطای تبدیل UTF\-16 به UTF\-8 رخ دهد (برای نمونه زمانی که فایل ورودی UTF\-16 شامل خطایی باشد)، از فایل صرف‌نظر خواهد شد. .PP هنگامی که از گزینهٔ \f(CW\*(C`\-u\*(C'\fR استفاده شود، فایل خروجی با همان کدگذاری UTF\-16 فایل ورودی نوشته می‌شود. گزینهٔ \f(CW\*(C`\-u\*(C'\fR از تبدیل به UTF\-8 جلوگیری می‌کند. .PP دستورهای dos2unix و unix2dos هیچ گزینه‌ای برای تبدیل فایل‌های UTF\-8 به UTF\-16 ندارند. .PP تبدیل در حالت‌های ISO و 7\-bit روی فایل‌های UTF\-16 کار نمی‌کند..SS "نشانگر ترتیب بایت (Byte Order Mark)" .IX Subsection "Byte Order Mark" در ویندوز، فایل‌های متنی یونیکد معمولاً دارای یک نشانگر ترتیب بایت (BOM یا Byte Order Mark) هستند، زیرا بسیاری از برنامه‌های ویندوز (از جمله Notepad) به‌طور پیش‌فرض BOM را اضافه می‌کنند. همچنین ببینید: . .PP در یونیکس، فایل‌های یونیکد معمولاً فاقد BOM هستند. فرض بر این است که فایل‌های متنی با کدگذاری نویسه محلی (locale character encoding) کدگذاری شده‌اند. .PP دستور dos2unix تنها در صورتی می‌تواند تشخیص دهد که فایلی با قالب UTF\-16 است که فایل دارای BOM باشد. هنگامی که یک فایل UTF\-16 فاقد BOM باشد، dos2unix آن را به عنوان یک فایل باینری در نظر می‌گیرد. .PP برای تبدیل یک فایل UTF\-16 بدون BOM، از گزینهٔ \f(CW\*(C`\-ul\*(C'\fR یا \f(CW\*(C`\-ub\*(C'\fR استفاده کنید. .PP دستور dos2unix به‌طور پیش‌فرض هیچ BOMای در فایل خروجی نمی‌نویسد. با گزینهٔ \f(CW\*(C`\-b\*(C'\fR، dos2unix در صورتی که فایل ورودی دارای BOM باشد، یک BOM در خروجی می‌نویسد. .PP دستور unix2dos در صورتی که فایل ورودی دارای BOM باشد، به‌طور پیش‌فرض یک BOM در فایل خروجی می‌نویسد. برای حذف BOM از گزینهٔ \f(CW\*(C`\-r\*(C'\fR استفاده کنید. .PP هنگامی که گزینهٔ \f(CW\*(C`\-m\*(C'\fR استفاده شود، dos2unix و unix2dos همواره یک BOM می‌نویسند. .SS "نام‌های فایل یونیکد در ویندوز (Unicode file names on Windows)" .IX Subsection "Unicode file names on Windows" دستور dos2unix دارای پشتیبانی اختیاری برای خواندن و نوشتن نام‌های فایل یونیکد در Windows Command Prompt است. این بدان معناست که dos2unix می‌تواند فایل‌هایی را باز کند که نام آن‌ها دارای نویسه‌هایی خارج از کدپیج پیش‌فرض ANSI سیستم است. برای بررسی اینکه آیا dos2unix برای ویندوز با پشتیبانی از نام فایل یونیکد ساخته شده است یا خیر، دستور \&\f(CW\*(C`dos2unix \-V\*(C'\fR را اجرا کنید. .PP مشکلاتی در نمایش نام‌های فایل یونیکد در کنسول ویندوز وجود دارد. گزینه‌های \f(CW\*(C`\-D\*(C'\fR و \f(CW\*(C`\-\-display\-enc\*(C'\fR را ببینید. ممکن است نام فایل‌ها در کنسول به‌نادرستی نمایش داده شوند، اما فایل‌ها با نام صحیح نوشته خواهند شد. .SS "مثال‌های یونیکد (Unicode examples)" .IX Subsection "Unicode examples" تبدیل از UTF\-16 ویندوز (همراه با BOM) به UTF\-8 یونیکس: .PP .Vb 1 \& dos2unix \-n in.txt out.txt .Ve .PP تبدیل از UTF\-16LE ویندوز (بدون BOM) به UTF\-8 یونیکس: .PP .Vb 1 \& dos2unix \-ul \-n in.txt out.txt .Ve .PP تبدیل از UTF\-8 یونیکس به UTF\-8 ویندوز همراه با BOM: .PP .Vb 1 \& unix2dos \-m \-n in.txt out.txt .Ve .PP تبدیل از UTF\-8 یونیکس به UTF\-16 ویندوز: .PP .Vb 1 \& unix2dos < in.txt | iconv \-f UTF\-8 \-t UTF\-16 > out.txt .Ve .SH GB18030 .IX Header "GB18030" استاندارد GB18030 یک استاندارد دولتی چین است. یک زیرمجموعهٔ الزامی از استاندارد GB18030 رسماً برای تمام محصولات نرم‌افزاری فروخته‌شده در چین اجباری است. همچنین ببینید: . .PP استاندارد GB18030 کاملاً با یونیکد سازگار است و می‌تواند یک قالب تبدیل یونیکد در نظر گرفته شود. همانند UTF\-8، استاندارد GB18030 نیز با ASCII سازگار است. همچنین GB18030 با کدپیج ۹۳۶ ویندوز، که با نام GBK نیز شناخته می‌شود، سازگار است. .PP در یونیکس/لینوکس، هنگامی که کدگذاری locale روی GB18030 تنظیم شده باشد، فایل‌های UTF\-16 به GB18030 تبدیل می‌شوند. توجه داشته باشید که این تنها در صورتی کار می‌کند که لوکال توسط سیستم پشتیبانی شود. برای مشاهدهٔ فهرست لوکال‌های پشتیبانی‌شده از دستور \f(CW\*(C`locale \-a\*(C'\fR استفاده کنید. .PP در ویندوز، برای تبدیل فایل‌های UTF\-16 به GB18030 باید از گزینهٔ \f(CW\*(C`\-gb\*(C'\fR استفاده کنید. .PP فایل‌های کدگذاری‌شده با GB18030 می‌توانند همانند فایل‌های یونیکد دارای نشانگر ترتیب بایت (BOM) باشند. .SH "مثال‌ها (EXAMPLES)" .IX Header "EXAMPLES" خواندن ورودی از \*(Aqstdin\*(Aq و نوشتن خروجی در \*(Aqstdout\*(Aq: .PP .Vb 2 \& dos2unix < a.txt \& cat a.txt | dos2unix .Ve .PP تبدیل و جایگزینی a.txt. تبدیل و جایگزینی b.txt: .PP .Vb 2 \& dos2unix a.txt b.txt \& dos2unix \-o a.txt b.txt .Ve .PP تبدیل و جایگزینی a.txt در حالت تبدیل ascii: .PP .Vb 1 \& dos2unix a.txt .Ve .PP تبدیل و جایگزینی a.txt در حالت تبدیل ascii، تبدیل و جایگزینی b.txt در حالت تبدیل 7bit: .PP .Vb 3 \& dos2unix a.txt \-c 7bit b.txt \& dos2unix \-c ascii a.txt \-c 7bit b.txt \& dos2unix \-ascii a.txt \-7 b.txt .Ve .PP تبدیل a.txt از قالب Mac به قالب Unix: .PP .Vb 2 \& dos2unix \-c mac a.txt \& mac2unix a.txt .Ve .PP تبدیل a.txt از قالب Unix به قالب Mac: .PP .Vb 2 \& unix2dos \-c mac a.txt \& unix2mac a.txt .Ve .PP تبدیل و جایگزینی a.txt در حین حفظ برچسب زمان اصلی: .PP .Vb 2 \& dos2unix \-k a.txt \& dos2unix \-k \-o a.txt .Ve .PP تبدیل a.txt و نوشتن در e.txt: .PP .Vb 1 \& dos2unix \-n a.txt e.txt .Ve .PP تبدیل a.txt و نوشتن در e.txt، و یکسان نگه‌داشتن برچسب زمان e.txt با a.txt: .PP .Vb 1 \& dos2unix \-k \-n a.txt e.txt .Ve .PP تبدیل و جایگزینی a.txt، تبدیل b.txt و نوشتن در e.txt: .PP .Vb 2 \& dos2unix a.txt \-n b.txt e.txt \& dos2unix \-o a.txt \-n b.txt e.txt .Ve .PP تبدیل c.txt و نوشتن در e.txt، تبدیل و جایگزینی a.txt، تبدیل و جایگزینی b.txt، تبدیل d.txt و نوشتن در f.txt: .PP .Vb 1 \& dos2unix \-n c.txt e.txt \-o a.txt b.txt \-n d.txt f.txt .Ve.SH "تبدیل بازگشتی (RECURSIVE CONVERSION)" .IX Header "RECURSIVE CONVERSION" در شل یونیکس، از دستورهای \fBfind\fR\|(1) و \fBxargs\fR\|(1) می‌توان برای اجرای بازگشتی dos2unix روی تمام فایل‌های متنی یک درخت دایرکتوری استفاده کرد. برای مثال جهت تبدیل تمام فایل‌های .txt در درخت دایرکتوریِ زیر دایرکتوری جاری، بنویسید: .PP .Vb 1 \& find . \-name \*(Aq*.txt\*(Aq \-print0 |xargs \-0 dos2unix .Ve .PP گزینهٔ \f(CW\*(C`\-print0\*(C'\fR در \fBfind\fR\|(1) و گزینهٔ متناظر آن در \fBxargs\fR\|(1)، یعنی \f(CW\-0\fR، زمانی لازم هستند که نام فایل‌ها حاوی فاصله یا علامت‌های نقل‌قول باشد. در غیر این صورت می‌توان این گزینه‌ها را حذف کرد. راهکار دیگر، استفاده از \fBfind\fR\|(1) با گزینهٔ \f(CW\*(C`\-exec\*(C'\fR است: .PP .Vb 1 \& find . \-name \*(Aq*.txt\*(Aq \-exec dos2unix {} \e; .Ve .PP در خط فرمان ویندوز (Command Prompt) می‌توان از دستور زیر استفاده کرد: .PP .Vb 1 \& for /R %G in (*.txt) do dos2unix "%G" .Ve .PP کاربران پاورشل می‌توانند از دستور زیر در Windows PowerShell استفاده کنند: .PP .Vb 1 \& get\-childitem \-path . \-filter \*(Aq*.txt\*(Aq \-recurse | foreach\-object {dos2unix $_.Fullname} .Ve .SH "محلی‌سازی (LOCALIZATION)" .IX Header "LOCALIZATION" .IP \fBLANG\fR 4 .IX Item "LANG" زبان اصلی با متغیر محیطی LANG مشخص می‌شود. متغیر LANG از چندین بخش تشکیل شده است. بخش نخست، کد زبان با حروف کوچک است. بخش دوم اختیاری بوده و کد کشور با حروف بزرگ است که یک خط زیرین (_) پیش از آن می‌آید. بخش سومی نیز به صورت اختیاری وجود دارد: کدبندی نویسه‌ها (character encoding)، که با یک نقطه شروع می‌شود. چند مثال برای شل‌های استاندارد POSIX: .Sp .Vb 7 \& export LANG=nl Dutch \& export LANG=nl_NL Dutch, The Netherlands \& export LANG=nl_BE Dutch, Belgium \& export LANG=es_ES Spanish, Spain \& export LANG=es_MX Spanish, Mexico \& export LANG=en_US.iso88591 English, USA, Latin\-1 encoding \& export LANG=en_GB.UTF\-8 English, UK, UTF\-8 encoding .Ve .Sp برای دیدن فهرست کاملی از کدهای زبان و کشور، راهنمای gettext را ببینید: .Sp در سیستم‌های یونیکس می‌توانید از دستور \fBlocale\fR\|(1) برای دریافت اطلاعات مربوط به locale استفاده کنید. .IP \fBLANGUAGE\fR 4 .IX Item "LANGUAGE" با متغیر محیطی LANGUAGE می‌توانید فهرستی اولویت‌بندی‌شده از زبان‌ها را با دونقطه (:) از یکدیگر جدا کرده و مشخص کنید. dos2unix متغیر LANGUAGE را بر LANG ترجیح می‌دهد. برای نمونه، ابتدا هلندی و سپس آلمانی: \f(CW\*(C`LANGUAGE=nl:de\*(C'\fR. پیش از استفاده از فهرست اولویت زبان‌ها از طریق متغیر LANGUAGE، ابتدا باید محلی‌سازی را با مقداردهی LANG (یا LC_ALL) به مقداری غیر از \(lqC\(rq فعال کنید. همچنین راهنمای gettext را ببینید: .Sp اگر زبانی را انتخاب کنید که در دسترس نباشد، پیام‌ها با زبان استاندارد انگلیسی نمایش داده خواهند شد. .IP \fBDOS2UNIX_LOCALEDIR\fR 4 .IX Item "DOS2UNIX_LOCALEDIR" با متغیر محیطی DOS2UNIX_LOCALEDIR می‌توان مقدار LOCALEDIR تعیین‌شده هنگام کامپایل را لغو و بازنویسی کرد. LOCALEDIR برای یافتن فایل‌های زبان به کار می‌رود. مقدار پیش‌فرض در گنو \f(CW\*(C`/usr/local/share/locale\*(C'\fR است. گزینهٔ \fB\-\-version\fR مقدار LOCALEDIR مورداستفاده را نمایش خواهد داد. .Sp مثال (شل POSIX): .Sp .Vb 1 \& export DOS2UNIX_LOCALEDIR=$HOME/share/locale .Ve .SH "مقدار بازگشتی (RETURN VALUE)" .IX Header "RETURN VALUE" در صورت موفقیت، صفر بازگردانده می‌شود. هنگام رخ دادن یک خطای سیستمی، آخرین خطای سیستم برگردانده خواهد شد. برای سایر خطاها، مقدار 1 بازگردانده می‌شود. .PP مقدار بازگشتی در حالت بی‌صدا (quiet mode) همیشه صفر است، مگر این‌که گزینه‌های نادرستی در خط فرمان به کار گرفته شده باشند. .SH "استانداردها (STANDARDS)" .IX Header "STANDARDS" .PP .PP .PP .SH "نویسندگان (AUTHORS)" .IX Header "AUTHORS" Benjamin Lin \- ، Bernd Johannes Wuebben (حالت mac2unix) \- ، Christian Wurll (افزودن خط جدید اضافه) \- ، Erwin Waterlander \- (نگه‌دارنده) .PP صفحهٔ پروژه: .PP صفحهٔ سورس‌فورج: .SH "همچنین ببینید (SEE ALSO)" .IX Header "SEE ALSO" \&\fBfile\fR\|(1) \&\fBfind\fR\|(1) \&\fBiconv\fR\|(1) \&\fBlocale\fR\|(1) \&\fBxargs\fR\|(1)