.\" Copyright (c) 1989, 1990, 1993
.\"     The Regents of the University of California.  All rights reserved.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\"    notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\"    notice, this list of conditions and the following disclaimer in the
.\"    documentation and/or other materials provided with the distribution.
.\" 4. Neither the name of the University nor the names of its contributors
.\"    may be used to endorse or promote products derived from this software
.\"    without specific prior written permission.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\"     From: @(#)mtree.8       8.2 (Berkeley) 12/11/93
.\"
.Dd September 4, 2013
.Dt MTREE 5
.Os
.Sh "نام (NAME)"
.Nm mtree
.Nd قالب پروندههای ساختار سلسلهمراتبی پوشه mtree
.Sh "توضیحات (DESCRIPTION)"
قالب
.Nm
یک قالب متنی است که مجموعه‌ای از اشیای سیستم‌پرونده را توصیف می‌کند.
چنین پرونده‌هایی معمولاً برای ایجاد یا اعتبارسنجی ساختارهای سلسله‌مراتبی پوشه‌ها به کار می‌روند.
.Ss "قالب کلی (General Format)"
یک پرونده
.Nm
از مجموعه‌ای از خطوط تشکیل شده است که هر یک اطلاعاتی را درباره یک شیء منفرد در سیستم‌پرونده ارائه می‌دهند.
فاصله‌های خالی ابتدای خطوط همواره نادیده گرفته می‌شوند.
.Pp
هنگام کدگذاری پرونده‌ها یا نام مسیرها، هر نویسه بک‌اسلش یا نویسه‌ای خارج از ۹۵ نویسه اسکی (ASCII) قابل‌چاپ، باید به صورت یک بک‌اسلش و در ادامه سه رقم در مبنای هشت (اکتال) کدگذاری شود.
هنگام خواندن پرونده‌های mtree، هرگونه ظاهر شدن بک‌اسلش که سه رقم هشت‌هشتی به دنبال آن آمده باشد، باید به نویسه متناظر آن تبدیل شود.
.Pp
هر خط به صورت مستقل به عنوان یکی از انواع زیر تفسیر می‌شود:
.Bl -tag -width Cm
.It Blank
خطوط خالی نادیده گرفته می‌شوند.
.It Comment
خطوطی که با
.Cm #
آغاز می‌شوند نادیده گرفته می‌شوند.
.It Special
خطوطی که با
.Cm /
آغاز می‌شوند، دستورهای ویژه‌ای هستند که بر تفسیر خطوط بعدی اثر می‌گذارند.
.It Relative
اگر اولین کلمه جداشده با فاصله فاقد نویسه
.Cm /
باشد، نام یک پرونده در پوشه جاری است.
هر مدخل نسبی که یک پوشه را توصیف کند، پوشه جاری را تغییر می‌دهد.
.It dot-dot
به عنوان یک حالت خاص، یک مدخل نسبی با نام پرونده
.Pa ..
پوشه جاری را به پوشه والد تغییر می‌دهد.
گزینه‌ها در مدخل‌های dot-dot همواره نادیده گرفته می‌شوند.
.It Full
اگر نخستین کلمه جداشده با فاصله، دارای یک نویسه
.Cm /
پس از نویسه نخست باشد، نام مسیر یک پرونده نسبت به پوشه آغازین است.
می‌تواند چندین مدخل کامل وجود داشته باشد که یک پرونده یکسان را توصیف کنند.
.El
.Pp
برخی از ابزارهایی که پرونده‌های
.Nm
را پردازش می‌کنند، ممکن است لازم داشته باشند که خطوط متعددی که یک پرونده یکسان را توصیف می‌کنند، به صورت متوالی و پشت سر هم قرار گیرند.
اشاره به یک پرونده یکسان به صورت هم‌زمان با استفاده از هر دو روش مشخص‌سازی نسبی و کامل مجاز نیست.
.Ss "دستورهای ویژه (Special commands)"
در حال حاضر دو دستور ویژه تعریف شده است:
.Bl -tag -width Cm
.It Cm /set
این دستور مقادیر پیش‌فرض را برای یک یا چند کلیدواژه تعریف می‌کند.
به دنبال این دستور در همان خط، یک یا چند تعریف کلیدواژه که با فاصله از هم جدا شده‌اند می‌آید.
این تعاریف برای تمامی پرونده‌های بعدی که مقداری را برای آن کلیدواژه مشخص نکرده باشند اعمال می‌شود.
.It Cm /unset
این دستور هر مقدار پیش‌فرضی را که توسط دستور پیشین
.Cm /set
تعیین شده باشد لغو می‌کند.
به دنبال آن در همان خط، یک یا چند کلیدواژه که با فاصله از هم جدا شده‌اند می‌آیند.
.El
.Ss "کلیدواژه‌ها (Keywords)"
پس از نام پرونده، یک مدخل کامل یا نسبی شامل صفر یا چند تعریف کلیدواژه است که با فاصله از هم جدا شده‌اند.
هر تعریف از این دست، شامل یک کلید از فهرست زیر است که بلافاصله علامت '=' و سپس یک مقدار به دنبال آن می‌آید.
برنامه‌های نرم‌افزاری که پرونده‌های mtree را می‌خوانند، باید در مورد کلیدواژه‌های ناشناخته هشدار دهند.
.Pp
کلیدواژه‌هایی که در حال حاضر پشتیبانی می‌شوند عبارتند از:
.Bl -tag -width Cm
.It Cm cksum
مجموع مقابله‌ای (checksum) پرونده با استفاده از الگوریتم پیش‌فرضی که توسط ابزار
.Xr cksum 1
مشخص شده است.
.It Cm device
شماره دستگاه برای انواع پرونده
.Sy block
یا
.Sy char .
مقدار باید یکی از فرم‌های زیر باشد:
.Bl -tag -width 4n
.It Ar format , Ns Ar major , Ns Ar minor Ns Bo , Ns Ar subunit Bc
دستگاهی با فیلدهای
.Ar major , minor
و فیلد اختیاری
.Ar subunit .
معنای آن‌ها توسط
.Ar format
سیستم‌عامل مشخص می‌شود.
برای قالب‌های معتبر به بخش زیر مراجعه کنید.
.It Ar number
عدد مات (همان‌گونه که در سیستم‌پرونده ذخیره شده است).
.El
.Pp
مقادیر زیر برای
.Ar format
شناخته شده‌اند:
.Sy native ,
.Sy 386bsd ,
.Sy 4bsd ,
.Sy bsdos ,
.Sy freebsd ,
.Sy hpux ,
.Sy isc ,
.Sy linux ,
.Sy netbsd ,
.Sy osf1 ,
.Sy sco ,
.Sy solaris ,
.Sy sunos ,
.Sy svr3 ,
.Sy svr4 ,
و
.Sy ultrix .
.Pp
برای جزئیات بیشتر به
.Xr mknod 8
مراجعه کنید.
.It Cm contents
نام مسیر کامل پرونده‌ای که محتویات این پرونده را در بر دارد.
.It Cm flags
پرچم‌های پرونده به عنوان یک نام نمادین.
برای اطلاعات بیشتر درباره این نام‌ها به
.Xr chflags 1
مراجعه کنید.
اگر قرار نیست هیچ پرچمی تنظیم شود، می‌توان از رشته
.Dq none
برای لغو مقدار پیش‌فرض جاری استفاده کرد.
.It Cm gid
گروه پرونده به صورت یک مقدار عددی.
.It Cm gname
گروه پرونده به صورت یک نام نمادین.
.It Cm ignore
هر ساختار سلسله‌مراتبی از پرونده‌ها را که در زیر این پرونده قرار دارد، نادیده می‌گیرد.
.It Cm inode
شماره آی‌نود (inode).
.It Cm link
مقصد پیوند نمادین، زمانی که
.Li type=link
باشد.
.It Cm md5
چکیده پیام MD5 برای پرونده.
.It Cm md5digest
مترادفی برای
.Cm md5 .
.It Cm mode
مجوزهای دسترسی پرونده جاری به صورت یک مقدار عددی (هشت‌هشتی/اکتال) یا نمادین.
.It Cm nlink
تعداد پیوندهای سختی که انتظار می‌رود پرونده داشته باشد.
.It Cm nochange
اطمینان حاصل می‌کند که این پرونده یا پوشه وجود دارد، اما در غیر این صورت تمامی ویژگی‌ها را نادیده می‌گیرد.
.It Cm optional
پرونده اختیاری است؛ اگر پرونده در ساختار سلسله‌مراتبی پرونده‌ها وجود نداشته باشد، خطایی اعلام نشود.
.It Cm resdevice
شماره دستگاه
.Dq مقیم (resident)
پرونده، به عنوان مثال شناسه دستگاهی که پرونده را در بر دارد.
قالب آن همانند قالب مشخص‌شده برای
.Cm device
است.
.It Cm ripemd160digest
چکیده پیام
.Tn RIPEMD160
برای پرونده.
.It Cm rmd160
مترادفی برای
.Cm ripemd160digest .
.It Cm rmd160digest
مترادفی برای
.Cm ripemd160digest .
.It Cm sha1
چکیده پیام
.Tn FIPS
160-1
.Pq Dq Tn SHA-1
برای پرونده.
.It Cm sha1digest
مترادفی برای
.Cm sha1 .
.It Cm sha256
چکیده پیام
.Tn FIPS
180-2
.Pq Dq Tn SHA-256
برای پرونده.
.It Cm sha256digest
مترادفی برای
.Cm sha256 .
.It Cm sha384
چکیده پیام
.Tn FIPS
180-2
.Pq Dq Tn SHA-384
برای پرونده.
.It Cm sha384digest
مترادفی برای
.Cm sha384 .
.It Cm sha512
چکیده پیام
.Tn FIPS
180-2
.Pq Dq Tn SHA-512
برای پرونده.
.It Cm sha512digest
مترادفی برای
.Cm sha512 .
.It Cm size
اندازه پرونده بر حسب بایت.
.It Cm time
زمان آخرین تغییر پرونده.
.It Cm type
نوع پرونده؛ می‌تواند روی هر یک از موارد زیر تنظیم شود:
.Pp
.Bl -tag -width Cm -compact
.It Cm block
دستگاه ویژه بلوکی (block special device)
.It Cm char
دستگاه ویژه نویسه‌ای (character special device)
.It Cm dir
پوشه (directory)
.It Cm fifo
صف لوله نام‌گذاری‌شده (fifo)
.It Cm file
پرونده عادی (regular file)
.It Cm link
پیوند نمادین (symbolic link)
.It Cm socket
سوکت (socket)
.El
.It Cm uid
مالک پرونده به صورت یک مقدار عددی.
.It Cm uname
مالک پرونده به صورت یک نام نمادین.
.El
.Sh "همچنین ببینید (SEE ALSO)"
.Xr cksum 1 ,
.Xr find 1 ,
.Xr mtree 8
.Sh "تاریخچه (HISTORY)"
ابزار
.Nm
در
.Bx 4.3 Reno
ظاهر شد.
قابلیت چکیده
.Tn MD5
در
.Fx 2.1
در پاسخ به استفاده گسترده از برنامه‌هایی که می‌توانستند
.Xr cksum 1
را جعل کنند، افزوده شد.
چکیده‌های
.Tn SHA-1
و
.Tn RIPEMD160
در
.Fx 4.0
افزوده شدند، چرا که حملات جدید ضعف‌هایی را در
.Tn MD5
نشان داده بودند.
چکیده
.Tn SHA-256
در
.Fx 6.0
افزوده شد.
پشتیبانی از پرچم‌های پرونده در
.Fx 4.0
افزوده شد و عمدتاً از
.Nx
می‌آید.
قالب مدخل
.Dq full
توسط
.Nx
افزوده شد.