نام (NAME)

clubak - قالب‌بندی و تجمیع خروجی دستورات خوشه‌ای ClusterShell

خلاصه دستور (SYNOPSIS)

clubak [ OPTIONS ]

توضیحات (DESCRIPTION)

دستور clubak متن دریافتی از ورودی استاندارد را که شامل خطوطی به قالب "node:output" است، قالب‌بندی می‌کند. این ابزار سازگاری عقبروی کاملی با dshbak(1) دارد اما امکانات بیشتری ارائه می‌دهد؛ برای نمونه، clubak همواره نتایج خود را به‌صورت مرتب‌شده بر اساس گره/مجموعه‌گره نمایش می‌دهد.

هنگام استفاده از clush(1) نیازی به استفاده از clubak ندارید، چرا که تمامی قابلیت‌های قالب‌بندی خروجی پیشاپیش درون آن گنجانده شده‌اند. این ابزار برای کاربردهای دیگر، مانند پس‌پردازش نتایجی به شکل "node:output" ارائه شده است.

همانند clush(1)، دستور clubak نیز از ماژول ClusterShell.MsgTree از کتابخانه ClusterShell استفاده می‌کند (ببینید: pydoc ClusterShell.MsgTree).

نحوه فراخوانی (INVOCATION)

دستور clubak باید به همراه ورودی استاندارد متصل (پیوند داده‌شده) اجرا شود.

گزینه‌ها (OPTIONS)

--version: نمایش شماره نسخه clubak و خروج
-b, -c, --dshbak: تجمیع گره‌های دارای خروجی یکسان (گزینه‌های -c و --dshbak جهت سازگاری با dshbak(1) ارائه شده‌اند)
-B: مشابه -b؛ جهت سازگاری با clush(1) پذیرفته می‌شود، جایی که -B خروجی خطای استاندارد را نیز تجمیع می‌کند
-q, --quiet: حالت بی‌صدا، تنها خروجی‌های ضروری چاپ می‌شوند (مثلاً شمارش گره‌ها که در کنار سرآیند مجموعه‌گره‌های تجمیع‌شده نمایش داده می‌شود، حذف می‌گردد)
-v, --verbose: حالت پرگو، چاپ پیام‌های اطلاعاتی؛ همچنین بازتاب هر خط ورودی در خروجی استاندارد با پیشوند INPUT
-d, --debug: چاپ پیام‌های بیشتر برای مقاصد اشکال‌زدایی
-L: غیرفعال کردن بلوک سرآیند و مرتب‌سازی خروجی بر اساس گره‌ها
-N: غیرفعال کردن برچسب‌گذاری روی خروجی دستور
-r, --regroup: جمع‌کردن و خلاصه‌سازی مجموعه‌گره با استفاده از گروه‌های گره
--axis=RANGESET: برای مجموعه‌گره‌های nبعدی (nD)، مجموعه‌گره نمایش‌داده‌شده (مثلاً در سرآیند خروجی‌های تجمیع‌شده) را تنها در راستای محور ارائه‌شده جمع می‌کند. محورها از ۱ تا n شماره‌گذاری شده‌اند و می‌توان آن‌ها را در اینجا با نحو rangeset (مانند '1'، '1-2'، '1,3') یا با یک عدد منفی مشخص کرد که به معنای شمارش شاخص از انتها است. از آنجا که برخی مجموعه‌گره‌ها ممکن است دارای چندین بعد مختلف باشند، شاخص‌های محور بدون نمایش خطا کوتاه می‌شوند تا در محدوده مجاز قرار گیرند. این گزینه معادل هر بار فراخوانی برای مقدار پیش‌فرض کتابخانه fold_axis است.
-s GROUPSOURCE, --groupsource=GROUPSOURCE: منبع گروه اختیاری در groups.conf(5) برای استفاده
--groupsconf=FILE: استفاده از فایل پیکربندی جایگزین برای groups.conf(5)
-G, --groupbase: عدم نمایش پیشوند منبع گروه (همیشه @groupname)
-S SEPARATOR, --separator=SEPARATOR: رشته جداکننده محتوای خط / گره (پیش‌فرض: :)
-F, --fast: حالت سریع‌تر اما با مصرف حافظه بیشتر (پیش‌بارگذاری تمامی پیام‌ها به ازای هر گره)
-T, --tree: حالت ردگیری درخت پیام؛ سوییچی برای فعال‌سازی حالت ردگیری ClusterShell.MsgTree، که در آن تمامی کلیدها/گره‌ها برای هر عنصر پیام از درخت نگه داشته می‌شوند و امکان نمایش ویژه خروجی را فراهم می‌سازد
--interpret-keys=INTERPRET_KEYS: تعیین اینکه آیا کلیدها (فیلد قبل از جداکننده در هر خط ورودی) به عنوان مجموعه‌گره تفسیر شوند یا خیر. مقدار INTERPRET_KEYS می‌تواند never، always یا auto (پیش‌فرض) باشد. با never، هر کلید به عنوان یک رشته متنی ساده نگه‌داشته می‌شود؛ با always، هر کلید باید یک مجموعه‌گره معتبر باشد؛ با auto، کلیدها به عنوان مجموعه‌گره تفسیر می‌شوند، اما در صورت عدم امکان تجزیه هر یک از کلیدها، clubak بدون هشدار تمام کلیدها را به عنوان رشته‌های متنی ساده در نظر می‌گیرد.
--color=WHENCOLOR: دستور clubak می‌تواند از متغیرهای محیطی NO_COLOR، CLICOLOR و CLICOLOR_FORCE استفاده کند. گزینه خط فرمان --color همیشه نسبت به متغیرهای محیطی اولویت دارد. متغیر NO_COLOR بر CLICOLOR_FORCE و آن نیز بر CLICOLOR اولویت دارد. گزینه --color مشخص می‌کند که آیا از رنگ‌های ANSI برای احاطه کردن پیشوند/سرآیند گره یا مجموعه‌گره با دنباله‌های گریز جهت نمایش رنگی در ترمینال استفاده شود یا خیر. مقدار WHENCOLOR می‌تواند never، always یا auto (که در صورت اشاره خروجی استاندارد به ترمینال از رنگ استفاده می‌کند) باشد. رنگ روی [34m (متن پیش‌زمینه آبی) تنظیم شده است و قابل تغییر نیست.
--diff: نمایش تفاضل (diff) میان خروجی‌های تجمیع‌شده

وضعیت خروج (EXIT STATUS)

وضعیت خروج صفر بیانگر موفقیت‌آمیز بودن اجرای دستور clubak است.

مثال‌ها (EXAMPLES)

1.: می‌توان از clubak برای تجمیع برخی نتایج ثبت‌شده دستور clush(1) استفاده کرد:

ثبت نتایج clush(1) در یک فایل:

# clush -w node[1-7] uname -r >/tmp/clush_output
# clush -w node[32-159] uname -r >>/tmp/clush_output

نمایش نتایج تجمیع‌شده فایل (در حالت خطی):

# clubak -bL </tmp/clush_output

2.: مثالی دیگر؛ پیمایش روی فایل‌های متنی node* در دایرکتوری جاری و تجمیع تعداد کاراکترهای تمامی آن‌ها:

# find -name "node*" -exec wc -c {} ; | awk '{ gsub("./","",$2); print $2": "$1 }' | clubak -bL
node[1,3]: 7
node2: 9

همچنین ببینید (SEE ALSO)

cluset(1), clush(1), nodeset(1), groups.conf(5).

https://clustershell.readthedocs.io

گزارش اشکالات (BUG REPORTS)

برای ثبت گزارش اشکال یا بازخورد از نشانی اینترنتی زیر استفاده کنید:: https://github.com/clustershell/clustershell/issues

نویسنده (AUTHOR)

Stephane Thiell

حق نشر (COPYRIGHT)

GNU Lesser General Public License version 2.1 or later (LGPLv2.1+)