.\" $Header$
.nr yr \n(yr+1900
.af mo 01
.af dy 01
.TH ncvalidator 1 "PnetCDF 1.14.1" "Printed: \n(yr-\n(mo-\n(dy" "PnetCDF utilities"
.SH "نام (NAME)"
ncvalidator \- اعتبارسنجی فایل netCDF کلاسیک در برابر قالب‌های فایل CDF
.SH "خلاصه دستور (SYNOPSIS)"
.ft B
.HP
ncvalidator
.nh
\%[-x]
\%[-t]
\%[-q]
\%[-h]
\%\fIfile\fP
.hy
.ft
.SH "توضیحات (DESCRIPTION)"
دستور \fBncvalidator\fP سرآیند یک فایل netCDF را بررسی می‌کند تا مشخص شود با قالب‌های فایل CDF کلاسیک مطابقت دارد یا خیر. اگر فایل ورودی یک فایل NetCDF معتبر باشد، پیامی مبنی بر اعتبارسنجی موفقیت‌آمیز در خروجی خط فرمان چاپ می‌شود؛ برای مثال: File "testfile.nc" is a valid NetCDF file.
در غیر این صورت، یک پیام خطای NetCDF چاپ خواهد شد.
.SH "گزینه‌ها (OPTIONS)"
.IP "\fB-x\fP"
تعمیر فاصله‌گذاری بایت تهی (null-byte padding) در سرآیند فایل. فاصله‌گذاری با بایت تهی طبق مشخصات قالب کلاسیک NetCDF الزامی است. PnetCDF این الزام را اعمال می‌کند، اما NetCDF هرگز آن را اجباری نکرده است. این گزینه سرآیند را برای موقعیت‌هایی که بایت‌های تهی انتظار می‌رود بررسی کرده و در صورت یافتن بایت‌های غیرتهی، آن‌ها را با بایت تهی جایگزین می‌کند. فایل تعمیرشده با مشخصات استاندارد مطابقت پیدا کرده و به هر دو کتابخانه PnetCDF و NetCDF اجازه می‌دهد بدون گزارش کد خطای NC_ENOTNC یا NC_ENULLPAD فایل را بخوانند. توجه داشته باشید که این تعمیر درجا (in-place) انجام می‌شود و ممکن است کاربران مایل باشند ابتدا از فایل ورودی یک نسخه پشتیبان تهیه کنند. پس از تعمیر فایل، می‌توان دستور ncmpidiff را برای مقایسه محتویات دو فایل اجرا کرد.
.IP "\fB-t\fP"
فعال کردن حالت ردگیری (tracing)، که روند پیشرفت تمام اعتبارسنجی‌های موفقیت‌آمیز فراداده را چاپ می‌کند. هنگامی که خطایی شناسایی شود، ردگیری در محل خطای یافت‌شده متوقف می‌شود.
.IP "\fB-q\fP"
حالت بی‌صدا \- چیزی در خروجی خط فرمان چاپ نمی‌شود. در حالت بی‌صدا، کاربران باید وضعیت خروج را بررسی کنند. بخش «وضعیت خروج (EXIT STATUS)» در ادامه را ببینید.
.IP "\fB-h\fP"
چاپ گزینه‌های دردسترس در خط فرمان.
.SH "وضعیت خروج (EXIT STATUS)"
وضعیت خروج 0 به معنای مطابقت فایل با قالب فایل CDF کلاسیک است، و 1 به معنای عدم مطابقت است.
توجه داشته باشید که در سیستم‌های مبتنی بر VMS، مقادیر وضعیت خروج معکوس هستند.
.SH "همچنین ببینید (SEE ALSO)"
.LP
.BR ncmpidump (1),
.BR pnetcdf (3)
.SH "تاریخ (DATE)"
31 ژوئیه 2025
.LP