'\" t
.TH "SYSTEMD\-VPICK" "1" "" "systemd 261.2" "systemd-vpick"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
systemd-vpick \- حل و تبدیل مسیرها به دایرکتوری‌های دارای نسخه «\&.v/»
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBsystemd\-vpick\ \fR\fB[OPTIONS...]\fR\fB\ \fR\fB[PATH...]\fR\ 'u
\fBsystemd\-vpick \fR\fB[OPTIONS...]\fR\fB \fR\fB[PATH...]\fR
.SH "توضیحات (DESCRIPTION)"
.PP
\fBsystemd\-vpick\fR
یک مسیر فایل‌سیستم را که به یک دایرکتوری دارای نسخه
"\&.v/"
اشاره دارد، به مسیری به جدیدترین فایل (از نظر نسخه) موجود در آن حل و تبدیل می‌کند\&. این ابزار یک رابط خط فرمان برای منطق
\fBsystemd.v\fR(7)
فراهم می‌کند\&.
.PP
این ابزار یک مسیر به دایرکتوری
"\&.v/"
را به عنوان آرگومان انتظار دارد (خواه به طور مستقیم، یا با الگوی سه‌گانه زیرخط به عنوان آخرین جزء مسیر)\&. سپس جدیدترین فایل موجود در آن دایرکتوری را تعیین کرده و مسیر آن را در خروجی استاندارد می‌نویسد\&.
.PP
مگر در مواردی که الگوی سه‌گانه زیرخط به عنوان آخرین جزء مسیر ارسال شود، معمولاً لازم است دست‌کم سوییچ
\fB\-\-suffix=\fR
را برای پیکربندی پسوند فایلی که باید جستجو شود مشخص کنید\&.
.PP
اگر مسیر مشخص‌شده به یک مسیر
"\&.v/"
اشاره نکند (یعنی نه جزء نهایی به
"\&.v"
ختم شود، نه جزء یکی مانده به آخر، و جزء نهایی نیز حاوی سه زیرخط نباشد)، مسیر مشخص‌شده بدون تغییر در خروجی استاندارد نوشته می‌شود\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
گزینه‌های زیر پشتیبانی می‌شوند:
.PP
\fB\-\-basename=\fR, \fB\-B\fR
.RS 4
نام پایه (basename) فایل‌های مورد جستجو را بازنویسی می‌کند، یعنی بخشی که در سمت چپ بخش متغیر نام‌های فایل قرار دارد\&. به طور معمول این مقدار به صورت خودکار از نام فایل جزء
"\&.v"
مسیر مشخص‌شده، یا از الگوی سه‌گانه زیرخط در آخرین جزء مسیر مشخص‌شده به دست می‌آید\&.
.sp
افزوده شده در نسخه 256\&.
.RE
.PP
\fB\-V\fR
.RS 4
نسخه‌ای را که باید انتخاب شود به طور صریح پیکربندی می‌کند\&. در صورت مشخص شدن، به جای جدیدترین نسخه موجود، فایلی با رشته نسخه مشخص‌شده جستجو خواهد شد\&.
.sp
افزوده شده در نسخه 256\&.
.RE
.PP
\fB\-A\fR
.RS 4
معماری مورد نظر برای انتخاب را به طور صریح پیکربندی می‌کند\&. در صورت مشخص شدن، فایلی با شناسه معماری مشخص‌شده جستجو خواهد شد\&. اگر مشخص نشود، تنها نام‌های فایلی که دارای معماری پشتیبانی‌شده محلی هستند، یا فاقد هرگونه شناسه معماری می‌باشند، در نظر گرفته می‌شوند\&.
.sp
افزوده شده در نسخه 256\&.
.RE
.PP
\fB\-\-suffix=\fR, \fB\-S\fR
.RS 4
پسوند نام‌های فایل را برای بررسی پیکربندی می‌کند\&. برای منطق
"\&.v/"
مشخص کردن پسوندی که باید جستجو شود ضروری است، و جزء
"\&.v/"
نیز باید پسوند را دقیقاً قبل از
"\&.v"
در نام خود داشته باشد\&.
.sp
افزوده شده در نسخه 256\&.
.RE
.PP
\fB\-\-type=\fR, \fB\-t\fR
.RS 4
نوع inode را برای جستجو در دایرکتوری
"\&.v/"
پیکربندی می‌کند\&. یکی از مقادیر
"reg"،
"dir"،
"sock"،
"fifo"،
"blk"،
"chr"،
"lnk"
را به عنوان آرگومان می‌پذیرد که هر یک نوعی از inode را مشخص می‌کنند\&. برای جزئیات درباره انواع inode به
\fBinode\fR(7)
مراجعه کنید\&. اگر از این گزینه استفاده شود، inodeهایی که با نوع مشخص‌شده مطابقت ندارند فیلتر شده و در نظر گرفته نمی‌شوند\&.
.sp
افزوده شده در نسخه 256\&.
.RE
.PP
\fB\-\-print=\fR, \fB\-p\fR
.RS 4
دقیقاً آنچه را که باید در خروجی استاندارد نوشته شود پیکربندی می‌کند\&. اگر مشخص نشود، مسیر کامل و حل‌شده جدیدترین فایل منطبق در دایرکتوری
"\&.v/"
را چاپ می‌کند\&. این سوییچ می‌تواند روی یکی از موارد زیر تنظیم شود:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
اگر روی
"filename"
تنظیم شود، به جای مسیر کامل فایل حل‌شده، تنها نام فایل را چاپ می‌کند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
اگر روی
"version"
تنظیم شود، تنها نسخه فایل حل‌شده را چاپ می‌کند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
اگر روی
"type"
تنظیم شود، تنها نوع inode فایل حل‌شده را چاپ می‌کند (یعنی رشته‌ای مانند
"reg"
برای فایل‌های معمولی، یا
"dir"
برای دایرکتوری‌ها)\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
اگر روی
"arch"
تنظیم شود، تنها معماری فایل حل‌شده را چاپ می‌کند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
اگر روی
"tries"
تنظیم شود، تنها تلاش‌های باقی‌مانده/تلاش‌های انجام‌شده (tries left/tries done) فایل حل‌شده را چاپ می‌کند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
اگر روی
"all"
تنظیم شود، تمام موارد فوق را در یک خروجی جدولی ساده چاپ می‌کند\&.
.RE
.sp
افزوده شده در نسخه 256\&.
.RE
.PP
\fB\-\-resolve=\fR
.RS 4
یک آرگومان بولی (boolean) می‌پذیرد\&. اگر درست (true) باشد، مسیر فایل نسخه‌دار پیش از نمایش کاملاً متعارف‌سازی (canonicalize) می‌شود (یعنی پیوندهای نمادین حل می‌شوند و اجزای زاید مسیر حذف می‌گردند)\&. اگر نادرست (false - پیش‌فرض) باشد، این کار انجام نمی‌شود و مسیر بدون متعارف‌سازی نشان داده می‌شود\&.
.sp
افزوده شده در نسخه 256\&.
.RE
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
یک متن راهنمای کوتاه را چاپ کرده و خارج می‌شود\&.
.RE
.PP
\fB\-\-version\fR
.RS 4
یک رشته کوتاه نسخه را چاپ کرده و خارج می‌شود\&.
.RE
.SH "مثال‌ها (EXAMPLES)"
.PP
از دستور زیر برای انتخاب خودکار جدیدترین تصویر خام دیسک از یک دایرکتوری
"\&.v/"
استفاده کنید:
.sp
.if n \{\
.RS 4
.\}
.nf
$ systemd\-vpick \-\-suffix=\&.raw \-\-type=reg /var/lib/machines/quux\&.raw\&.v/
.fi
.if n \{\
.RE
.\}
.PP
این دستور تمام فایل‌های معمولی مطابق با
/var/lib/machines/quux\&.raw\&.v/quux*\&.raw
را شمارش کرده، آن‌ها را مطابق با قوانین شرح‌داده‌شده در
\fBsystemd.v\fR(7)
فیلتر و مرتب می‌کند و سپس مسیر جدیدترین فایل (از نظر نسخه) را در خروجی استاندارد می‌نویسد\&.
.PP
از دستور زیر برای انتخاب خودکار جدیدترین درخت دایرکتوری سیستم‌عامل از یک دایرکتوری
"\&.v/"
استفاده کنید:
.sp
.if n \{\
.RS 4
.\}
.nf
$ systemd\-vpick \-\-type=dir /var/lib/machines/waldo\&.v/
.fi
.if n \{\
.RE
.\}
.PP
این دستور تمام inodeهای دایرکتوری مطابق با
/var/lib/machines/waldo\&.v/waldo*
را شمارش کرده، آن‌ها را مطابق با قوانین شرح‌داده‌شده در
\fBsystemd.v\fR(7)
فیلتر و مرتب می‌کند و سپس مسیر جدیدترین دایرکتوری (از نظر نسخه) را در خروجی استاندارد می‌نویسد\&.
.PP
برای مثال‌های بیشتر به
\fBsystemd.v\fR(7)
مراجعه کنید\&.
.SH "کدهای خروج (EXIT STATUS)"
.PP
در صورت موفقیت، 0 برگردانده می‌شود؛ در غیر این صورت یک کد خطای غیر صفر برگردانده خواهد شد\&.
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBsystemd\fR(1), \fBsystemd.v\fR(7)