VINYLADM(1) General Commands Manual VINYLADM(1)

vinyladm - کنترل یک نمونه در حال اجرای Vinyl Cache

vinyladm [-h] [-n workdir] [-p] [-S secretfile] [-T [address]:port] [-t timeout] [command [...]]

ابزار vinyladm یک اتصال CLI به vinyld برقرار می‌کند، چه با استفاده از -n workdir و چه با استفاده از آرگومان‌های -T و -S. اگر -n workdir داده شود، مکان فایل رمز (secret file) و address:port در حافظه اشتراکی جستجو می‌شوند. اگر هیچ‌کدام مشخص نشوند، vinyladm از مقادیر پیش‌فرض -n که برای vinyld(1) مستند شده است استفاده می‌کند.

اگر یک دستور داده شود، دستور و آرگومان‌ها از طریق اتصال CLI ارسال شده و نتیجه در stdout بازگردانده می‌شود.

اگر هیچ آرگومان دستوری داده نشود، vinyladm دستورها و پاسخ‌ها را میان سوکت CLI و stdin/stdout رد و بدل می‌کند.

نمایش نحوه استفاده از برنامه و خروج.
مشخص کردن دایرکتوری کاری Vinyl Cache برای نمونه‌ای که باید به آن متصل شد. برای اطلاعات تکمیلی و مقادیر پیش‌فرض، به مستندات گزینهٔ -n در vinyld(1) مراجعه کنید.
اجبار به حالت pass و منطبق ساختن خروجی بر پروتکل VCLI. این کار تاریخچه دستورها/تکمیل خودکار دستورها را غیرفعال کرده و تجزیه پاسخ(ها) را برای برنامه‌ها آسان‌تر می‌سازد.
مشخص کردن فایل رمز احراز هویت. این باید همان آرگومان -S باشد که به vinyld داده شده بود. تنها فرایندهایی که قادر به خواندن محتوای این فایل باشند، می‌توانند اتصال CLI را احراز هویت کنند.
اتصال به واسط مدیریتی در آدرس و درگاه (port) مشخص‌شده.
عدم انتظار بیش از این تعداد ثانیه برای به پایان رسیدن یک عملیات.

ساختار نحوی و نحوه کارکرد واسط واقعی CLI در صفحه راهنمای vinyl-cli(7) شرح داده شده است. پارامترها در صفحه راهنمای vinyld(1) شرح داده شده‌اند.

علاوه بر این، خلاصه‌ای از دستورها را می‌توان با اجرای دستور help، و خلاصه‌ای از پارامترها را با اجرای دستور param.show به دست آورد.

اگر دستوری داده شود، وضعیت خروج ابزار vinyladm در صورت موفقیت‌آمیز بودن دستور برابر صفر و در غیر این صورت غیرصفر خواهد بود.

برخی از روش‌هایی که می‌توانید از vinyladm استفاده کنید:

vinyladm -T localhost:999 -S /var/db/secret vcl.use foo
echo vcl.use foo | vinyladm -T localhost:999 -S /var/db/secret
echo vcl.use foo | ssh vhost vinyladm -T localhost:999 -S /var/db/secret

ابزار vinyladm و این صفحه راهنما توسط Cecilie Fritzvold نوشته شده‌اند. این صفحه راهنما بعداً توسط Per Buer، Federico G. Schwindt و Lasse Karstensen اصلاح شده است.