SYSTEMD-VPICK(1) systemd-vpick SYSTEMD-VPICK(1)

systemd-vpick - حل و تبدیل مسیرها به دایرکتوری‌های دارای نسخه «.v/»

systemd-vpick [OPTIONS...] [PATH...]

systemd-vpick یک مسیر فایل‌سیستم را که به یک دایرکتوری دارای نسخه ".v/" اشاره دارد، به مسیری به جدیدترین فایل (از نظر نسخه) موجود در آن حل و تبدیل می‌کند. این ابزار یک رابط خط فرمان برای منطق systemd.v(7) فراهم می‌کند.

این ابزار یک مسیر به دایرکتوری ".v/" را به عنوان آرگومان انتظار دارد (خواه به طور مستقیم، یا با الگوی سه‌گانه زیرخط به عنوان آخرین جزء مسیر). سپس جدیدترین فایل موجود در آن دایرکتوری را تعیین کرده و مسیر آن را در خروجی استاندارد می‌نویسد.

مگر در مواردی که الگوی سه‌گانه زیرخط به عنوان آخرین جزء مسیر ارسال شود، معمولاً لازم است دست‌کم سوییچ --suffix= را برای پیکربندی پسوند فایلی که باید جستجو شود مشخص کنید.

اگر مسیر مشخص‌شده به یک مسیر ".v/" اشاره نکند (یعنی نه جزء نهایی به ".v" ختم شود، نه جزء یکی مانده به آخر، و جزء نهایی نیز حاوی سه زیرخط نباشد)، مسیر مشخص‌شده بدون تغییر در خروجی استاندارد نوشته می‌شود.

گزینه‌های زیر پشتیبانی می‌شوند:

--basename=, -B

نام پایه (basename) فایل‌های مورد جستجو را بازنویسی می‌کند، یعنی بخشی که در سمت چپ بخش متغیر نام‌های فایل قرار دارد. به طور معمول این مقدار به صورت خودکار از نام فایل جزء ".v" مسیر مشخص‌شده، یا از الگوی سه‌گانه زیرخط در آخرین جزء مسیر مشخص‌شده به دست می‌آید.

افزوده شده در نسخه 256.

-V

نسخه‌ای را که باید انتخاب شود به طور صریح پیکربندی می‌کند. در صورت مشخص شدن، به جای جدیدترین نسخه موجود، فایلی با رشته نسخه مشخص‌شده جستجو خواهد شد.

افزوده شده در نسخه 256.

-A

معماری مورد نظر برای انتخاب را به طور صریح پیکربندی می‌کند. در صورت مشخص شدن، فایلی با شناسه معماری مشخص‌شده جستجو خواهد شد. اگر مشخص نشود، تنها نام‌های فایلی که دارای معماری پشتیبانی‌شده محلی هستند، یا فاقد هرگونه شناسه معماری می‌باشند، در نظر گرفته می‌شوند.

افزوده شده در نسخه 256.

--suffix=, -S

پسوند نام‌های فایل را برای بررسی پیکربندی می‌کند. برای منطق ".v/" مشخص کردن پسوندی که باید جستجو شود ضروری است، و جزء ".v/" نیز باید پسوند را دقیقاً قبل از ".v" در نام خود داشته باشد.

افزوده شده در نسخه 256.

--type=, -t

نوع inode را برای جستجو در دایرکتوری ".v/" پیکربندی می‌کند. یکی از مقادیر "reg"، "dir"، "sock"، "fifo"، "blk"، "chr"، "lnk" را به عنوان آرگومان می‌پذیرد که هر یک نوعی از inode را مشخص می‌کنند. برای جزئیات درباره انواع inode به inode(7) مراجعه کنید. اگر از این گزینه استفاده شود، inodeهایی که با نوع مشخص‌شده مطابقت ندارند فیلتر شده و در نظر گرفته نمی‌شوند.

افزوده شده در نسخه 256.

--print=, -p

دقیقاً آنچه را که باید در خروجی استاندارد نوشته شود پیکربندی می‌کند. اگر مشخص نشود، مسیر کامل و حل‌شده جدیدترین فایل منطبق در دایرکتوری ".v/" را چاپ می‌کند. این سوییچ می‌تواند روی یکی از موارد زیر تنظیم شود:
•اگر روی "filename" تنظیم شود، به جای مسیر کامل فایل حل‌شده، تنها نام فایل را چاپ می‌کند.
•اگر روی "version" تنظیم شود، تنها نسخه فایل حل‌شده را چاپ می‌کند.
•اگر روی "type" تنظیم شود، تنها نوع inode فایل حل‌شده را چاپ می‌کند (یعنی رشته‌ای مانند "reg" برای فایل‌های معمولی، یا "dir" برای دایرکتوری‌ها).
•اگر روی "arch" تنظیم شود، تنها معماری فایل حل‌شده را چاپ می‌کند.
•اگر روی "tries" تنظیم شود، تنها تلاش‌های باقی‌مانده/تلاش‌های انجام‌شده (tries left/tries done) فایل حل‌شده را چاپ می‌کند.
•اگر روی "all" تنظیم شود، تمام موارد فوق را در یک خروجی جدولی ساده چاپ می‌کند.

افزوده شده در نسخه 256.

--resolve=

یک آرگومان بولی (boolean) می‌پذیرد. اگر درست (true) باشد، مسیر فایل نسخه‌دار پیش از نمایش کاملاً متعارف‌سازی (canonicalize) می‌شود (یعنی پیوندهای نمادین حل می‌شوند و اجزای زاید مسیر حذف می‌گردند). اگر نادرست (false - پیش‌فرض) باشد، این کار انجام نمی‌شود و مسیر بدون متعارف‌سازی نشان داده می‌شود.

افزوده شده در نسخه 256.

-h, --help

یک متن راهنمای کوتاه را چاپ کرده و خارج می‌شود.

--version

یک رشته کوتاه نسخه را چاپ کرده و خارج می‌شود.

از دستور زیر برای انتخاب خودکار جدیدترین تصویر خام دیسک از یک دایرکتوری ".v/" استفاده کنید:

$ systemd-vpick --suffix=.raw --type=reg /var/lib/machines/quux.raw.v/

این دستور تمام فایل‌های معمولی مطابق با /var/lib/machines/quux.raw.v/quux*.raw را شمارش کرده، آن‌ها را مطابق با قوانین شرح‌داده‌شده در systemd.v(7) فیلتر و مرتب می‌کند و سپس مسیر جدیدترین فایل (از نظر نسخه) را در خروجی استاندارد می‌نویسد.

از دستور زیر برای انتخاب خودکار جدیدترین درخت دایرکتوری سیستم‌عامل از یک دایرکتوری ".v/" استفاده کنید:

$ systemd-vpick --type=dir /var/lib/machines/waldo.v/

این دستور تمام inodeهای دایرکتوری مطابق با /var/lib/machines/waldo.v/waldo* را شمارش کرده، آن‌ها را مطابق با قوانین شرح‌داده‌شده در systemd.v(7) فیلتر و مرتب می‌کند و سپس مسیر جدیدترین دایرکتوری (از نظر نسخه) را در خروجی استاندارد می‌نویسد.

برای مثال‌های بیشتر به systemd.v(7) مراجعه کنید.

در صورت موفقیت، 0 برگردانده می‌شود؛ در غیر این صورت یک کد خطای غیر صفر برگردانده خواهد شد.

systemd(1), systemd.v(7)

systemd 261.2