.\" Copyright 1999-2002 Merlin Hughes .\" sensord is distributed under the GPL .\" .\" Permission is granted to make and distribute verbatim copies of this .\" manual provided the copyright notice and this permission notice are .\" preserved on all copies. .\" .\" Permission is granted to copy and distribute modified versions of this .\" manual under the conditions for verbatim copying, provided that the .\" entire resulting derived work is distributed under the terms of a .\" permission notice identical to this one .\" .\" Since the Linux kernel and libraries are constantly changing, this .\" manual page may be incorrect or out-of-date. The author(s) assume no .\" responsibility for errors or omissions, or for damages resulting from .\" the use of the information contained herein. The author(s) may not .\" have taken the same level of care in the production of this manual, .\" which is licensed free of charge, as they might when working .\" professionally. .\" .\" Formatted or processed versions of this manual, if unaccompanied by .\" the source, must acknowledge the copyright and authors of this work. .\" .TH sensord 8 "October 2007" "lm-sensors 3" "Linux System Administration" .SH "نام (NAME)" sensord \- دیمن ثبت اطلاعات حسگرها .SH "خلاصه دستور (SYNOPSIS)" .B sensord [\fIگزینه‌ها\fR] [\fIتراشه‌ها\fR] .SH "توضیحات (DESCRIPTION)" .B sensord دیمنی است که می‌تواند برای ثبت دوره‌ای خوانش‌های حسگر از تراشه‌های پایش سلامت سخت‌افزار در .BR syslog (3) یا یک پایگاه داده با ساختار چرخشی (RRD) و اعلام هشدار هنگام به‌صدا درآمدن آلارم حسگر (برای نمونه، خرابی فن، فراتر رفتن دما از حد مجاز و غیره) به کار رود\&. .SH "گزینه‌ها (OPTIONS)" .IP "\-i, \-\-interval زمان" تعیین بازه زمانی میان بررسی‌های مربوط به هشدارهای حسگرها؛ پیش‌فرض بررسی در هر دقیقه است\&. .PP زمان باید به‌صورت یک عدد صحیح خام (ثانیه) یا با پسوند .B s برای ثانیه، .B m برای دقیقه، یا .B h برای ساعت مشخص شود؛ برای نمونه، بازه زمانی پیش‌فرض .B 60 یا .B 1m است\&. .PP برای لغو صریح بررسی هشدارها، مقدار بازه زمانی را صفر تعیین کنید\&. .IP "\-l, \-\-log\-interval زمان" تعیین بازه زمانی میان ثبت تمام خوانش‌های حسگرها؛ حالت پیش‌فرض ثبت همه خوانش‌ها در هر نیم‌ساعت است\&. .PP زمان همانند قبل مشخص می‌شود؛ مثلاً .BR 30m \&. .PP برای لغو ثبت دوره‌ای خوانش‌های معمول حسگرها، مقدار بازه زمانی را صفر تعیین کنید\&. .IP "\-1, \-\-oneline" ثبت مقدار حسگر، تراشه و آداپتور در یک خط برای تجزیه (parsing) آسان‌تر\&. .IP "\-t, \-\-rrd\-interval زمان" تعیین بازه زمانی میان ثبت تمام خوانش‌های حسگرها در یک پایگاه داده چرخشی؛ در صورت پیکربندی پایگاه داده چرخشی، پیش‌فرض ثبت تمامی خوانش‌ها در هر پنج دقیقه است\&. .PP زمان همانند قبل مشخص می‌شود؛ مثلاً .BR 5m \&. .IP "\-T, \-\-rrd\-no\-average" مشخص می‌کند که در پایگاه داده چرخشی نباید میانگین‌گیری انجام شود\&. .IP "\-r, \-\-rrd\-file پرونده" تعیین یک پایگاه داده چرخشی که تمامی خوانش‌های حسگرها در آن ثبت شوند؛ مانند .IR /var/log/sensord.rrd \&. در صورت عدم وجود، این پایگاه داده ایجاد خواهد شد\&. به‌طور پیش‌فرض از هیچ پایگاه داده چرخشی استفاده نمی‌شود\&. .PP برای جزئیات بیشتر به بخش .B "پایگاه‌های داده چرخش دوره‌ای (ROUND ROBIN DATABASES)" در زیر مراجعه کنید\&. .IP "\-c, \-\-config\-file پرونده" تعیین یک پرونده پیکربندی برای .BR libsensors (3)\&. در صورت عدم تعیین پرونده، پرونده پیکربندی پیش‌فرض libsensors به کار خواهد رفت\&. .IP "\-p, \-\-pid\-file پرونده" تعیین پرونده PID برای ذخیره شناسه پردازه؛ پیش‌فرض نوشتن در پرونده .I /run/sensord.pid است\&. در اینجا همواره باید یک مسیر مطلق مشخص کنید\&. با خروج دیمن، این پرونده حذف می‌شود\&. .IP "\-f, \-\-syslog\-facility تسهیلات" تعیین تسهیلات (facility) مربوط به .BR syslog (3) هنگام ثبت خوانش‌های حسگرها و هشدارها؛ پیش‌فرض استفاده از .I daemon است\&. .PP سایر مقادیر ممکن شامل .I local0 تا .IR local7 و .I user است\&. .IP "\-g, \-\-rrd\-cgi دایرکتوری" یک اسکریپت نمونه CGI برای .BR rrdcgi (1) را چاپ کرده و خارج می‌شود که می‌تواند برای نمایش نمودارهای اطلاعات اخیر حسگرها در یک صفحه وب استفاده شود\&. باید دایرکتوری قابل نوشتن برای همگان (world-writable) و در دسترس وب را که نمودارها باید در آن ذخیره شوند مشخص کنید؛ اسکریپت CGI فرض می‌کند که این نمودارها در وب‌سرور از مسیر دایرکتوری .I /sensord/ در دسترس خواهند بود\&. برای جزئیات بیشتر به بخش .B "پایگاه‌های داده چرخش دوره‌ای (ROUND ROBIN DATABASES)" در زیر مراجعه کنید\&. .IP "\-a, \-\-load\-average" گنجاندن میانگین بار کاری سیستم (load average) در پایگاه داده RRD\&. هنگام ایجاد اسکریپت CGI نیز باید این فلگ را مشخص کنید\&. .IP "\-d, \-\-debug" چاپ مقدار اندکی اطلاعات اشکال‌زدایی اضافی\&. .IP "\-h, \-\-help" چاپ پیام راهنما و خروج\&. .IP "\-v, \-\-version" نمایش نسخه برنامه و خروج\&. .SH "تراشه‌ها (CHIPS)" برای محدود کردن دستگاه‌هایی که توسط این دیمن پایش می‌شوند، می‌توانید به‌صورت اختیاری فهرستی از نام‌های تراشه‌ها را مشخص کنید\&. به‌طور پیش‌فرض، تمام تراشه‌های موجود بررسی می‌شوند\&. .PP یک نام تراشه معمولی مانند .B w83782d\-* است (شاید لازم باشد نویسه .B * را برای شل خود اسکیپ کنید) که هرگونه تراشه W83782D را روی هر گذرگاهی بررسی می‌کند\&. برای جزئیات بیشتر .BR sensors.conf (5) را ببینید\&. راهکار دیگر این است که به‌سادگی ماژول‌های حسگر مربوط به تراشه‌هایی را که نیازی به آن‌ها ندارید بارگذاری نکنید\&. .SH "سیگنال‌ها (SIGNALS)" به‌محض دریافت سیگنال .B SIGTERM (برای جزئیات .BR signal (7) را ببینید) این دیمن به‌صورت آرام خاموش می‌شود\&. .PP به‌محض دریافت سیگنال .BR SIGHUP ، این دیمن رابط هسته را برای یافتن تراشه‌ها و قابلیت‌ها مجدداً پویش کرده و پرونده پیکربندی libsensors را بازخوانی می‌کند\&. .SH "ثبت گزارش‌ها (LOGGING)" تمام پیام‌های این دیمن در .BR syslog (3) تحت نام برنامه .B sensord و تسهیلات .I daemon (یا هر تسهیلاتی که در خط فرمان تعیین شده باشد) ثبت می‌شوند\&. .PP خوانش‌های عادی حسگرها در سطح .I info ثبت می‌شوند\&. هشدارها در سطح .I alert ثبت می‌گردند\&. پیام‌های وضعیت کم‌اهمیت در صورت فعال بودن حالت اشکال‌زدایی، در کمترین سطح یعنی .I debug ثبت می‌شوند\&. .PP می‌توانید از یک پرونده مناسب .I /etc/syslog.conf برای هدایت کاربردی این پیام‌ها استفاده کنید\&. برای جزئیات کامل .BR syslog.conf (5) را ببینید\&. با فرض اینکه تسهیلات ثبت گزارش را روی .B local4 تنظیم کرده باشید، پیکربندی زیر یک نمونه است: .IP .nf # Sample syslog.conf entries *.info;...;local4.none;local4.warn /var/log/messages local4.info -/var/log/sensors local4.alert /dev/console local4.alert * .fi .PP خط نخست تضمین می‌کند که خوانش‌های عادی حسگرها پرونده .I /var/log/messages را شلوغ نکنند؛ ابتدا عبارت .B local4.none را برای حذف پیام‌های اطلاعاتی و سپس .B local4.warn را برای فعال‌سازی هشدارها و بالاتر قرار می‌دهیم\&. خط دوم مشخص می‌کند که تمام خوانش‌های عادی حسگرها در پرونده .I /var/log/sensors ثبت شوند؛ علامت خط تیره ابتدایی .RB ( \- ) بدین معناست که این پرونده پس از هر پیام با دیسک همگام‌سازی (flush) نمی‌شود\&. دو خط پایانی تضمین می‌کنند که هشدارها علاوه بر .I /var/log/messages و .IR /var/log/sensors ، روی کنسول سیستم و برای تمام کاربران متصل نیز چاپ شوند\&. .SH "چرخش گزارش‌ها (LOG ROTATION)" روی یک سیستم معمولی با یک تراشه حسگر خوب، انتظار می‌رود به ازای هر خوانش حسگر حدود ۲ کیلوبایت در پرونده گزارش نوشته شود\&. این مقدار حدود ۳ مگابایت در ماه خواهد بود\&. در هر صورت شما باید پرونده‌های syslog خود را بچرخانید، اما برای اطمینان می‌توانید از ابزارهایی مانند .BR logrotate (8) یا معادل آن استفاده کنید\&. برای نمونه، ممکن است مدخلی در .I /etc/logrotate.d/syslog حاوی خطوط زیر بخواهید: .IP .nf # Sample logrotate.d entry /var/log/sensors { postrotate /usr/sbin/killall -HUP syslogd endscript } .fi .PP البته توجه داشته باشید که باید .BR syslogd (8) را مجدداً راه‌اندازی کنید، نه .BR sensord (8)\&. .SH "هشدارها (ALARMS)" هشدارها معمولاً نشان‌دهنده یک وضعیت بحرانی هستند؛ برای نمونه خرابی فن یا دما و ولتاژ غیرقابل قبول\&. با این حال، برخی از تراشه‌های حسگر از هشدارها پشتیبانی نمی‌کنند، در حالی که برخی دیگر ممکن است به نادرستی پیکربندی شده و هشدارهای اشتباه ارسال کنند\&. .PP توجه داشته باشید که ممکن است برخی از درایورها از گزارش هشدار پشتیبانی نکنند، حتی اگر تراشه‌های تحت پشتیبانی آن‌ها دارای قابلیت هشدار باشند\&. تا لینوکس ۲\&.۶\&.۲۳، بسیاری از درایورها هنوز هشدارها را در قالبی مناسب برای libsensors 3 گزارش نمی‌کردند\&. .SH "بوق‌های هشدار (BEEPS)" اگر عبارت .B (beep) را کنار خوانش هر حسگری مشاهده کردید، بدین معناست که سیستم شما طوری پیکربندی شده است که در صورت به‌صدا درآمدن هشدار روی آن حسگر، یک هشدار صوتی (بوق) از مادربرد پخش کند\&. .SH "پایگاه‌های داده چرخش دوره‌ای (ROUND ROBIN DATABASES)" .BR sensord (8) از ذخیره‌سازی خوانش‌های حسگر در یک پایگاه داده با ساختار چرخشی (RRD) پشتیبانی می‌کند\&. این قابلیت می‌تواند جایگزین مناسبی برای استفاده از .BR syslog (3) باشد\&. .PP پایگاه‌های داده چرخشی، پایگاه‌های داده‌ای با اندازه ثابت هستند که برای نمونه می‌توانند برای ذخیره داده‌های خوانش حسگر در طول یک هفته استفاده شوند\&. خوانش‌های بعدی که در پایگاه داده ذخیره می‌شوند، خوانش‌های قدیمی‌تر از یک هفته را بازنویسی خواهند کرد\&. این قابلیت بسیار مفید است زیرا امکان نگهداری اطلاعات مفید را به شکلی با دسترسی آسان و برای مدت زمان معین، بدون بار ناشی از رشد بی‌پایان پرونده‌های لاگ فراهم می‌کند\&. .PP ابزار .BR rrdtool (1) و کتابخانه مرتبط با آن، چارچوب پایه پایگاه داده چرخشی زیربنای .BR sensord (8) را فراهم می‌کنند\&. افزون بر این، ابزارهای .BR rrdcgi (1) و .BR rrdgraph (1) امکان تولید نمودار از این داده‌ها را جهت نمایش در صفحات وب مهیا می‌سازند\&. .PP اگر می‌خواهید از پیکربندی پیش‌فرض پایگاه داده چرخشی استفاده کنید (که داده‌های یک هفته خوانش حسگرها را در بازه‌های پنج‌دقیقه‌ای نگهداری می‌کند)، کافی است .BR sensord (8) را اجرا کرده و مسیر ذخیره پایگاه داده را مشخص کنید\&. این پایگاه داده به‌طور خودکار ایجاد شده و با استفاده از این پارامترهای پیش‌فرض پیکربندی می‌شود\&. .PP اگر مایلید خوانش‌ها برای مدت طولانی‌تری ذخیره شوند یا مایلید میانگین چندین خوانش در هر ورودی پایگاه داده ثبت شود، باید پیش از اجرای .BR sensord (8) پایگاه داده را به‌صورت دستی ایجاد و پیکربندی کنید\&. برای جزئیات به صفحه راهنمای .BR rrdcreate (1) مراجعه نمایید\&. توجه داشته باشید که پایگاه داده باید دقیقاً با نام‌ها و ترتیب حسگرهای خوانده‌شده توسط .BR sensord (8) همخوانی داشته باشد\&. توصیه می‌شود پایگاه داده پیش‌فرض را ایجاد کنید و سپس با استفاده از .BR rrdinfo (1) این اطلاعات را به دست آورید و/یا با .BR rrdtune (1) آن را تغییر دهید\&. .PP پس از ایجاد پایگاه داده چرخشی، باید وب‌سرور خود را برای نمایش اطلاعات حسگرها پیکربندی کنید\&. این فرآیند فرض می‌کند که شما یک وب‌سرور از پیش پیکربندی‌شده و فعال روی دستگاه خود دارید\&. .BR sensord (8) گزینه خط فرمان .B \-\-rrd\-cgi را برای ایجاد یک اسکریپت پایه CGI جهت نمایش این نمودارها فراهم می‌کند؛ سپس می‌توانید این اسکریپت را بر اساس نیاز خود سفارشی‌سازی کنید\&. برای جزئیات به راهنمای .BR rrdcgi (1) مراجعه کنید\&. این اسکریپت CGI به یک دایرکتوری در دسترس وب و قابل نوشتن توسط همگان (world-writable) نیاز دارد تا نمودارهای تولیدشده را درون آن بنویسد\&. .PP نمونه‌ای از نحوه راه‌اندازی نمودارهای تحت وب برای خوانش‌های اخیر حسگرها در ادامه آمده است: .IP .nf sensord --log-interval 0 \ --load-average \ --rrd-file /var/log/sensord.rrd .fi .PP در اینجا .BR sensord (8) را اجرا کرده و آن را برای ذخیره خوانش‌ها در یک پایگاه داده چرخشی پیکربندی می‌کنیم؛ توجه داشته باشید که ثبت خوانش‌های حسگر در .BR syslog (3) را غیرفعال کرده و ثبت میانگین بار کاری سیستم را فعال می‌نماییم\&. .IP .nf mkdir /var/www/sensord chown www-data:staff /var/www/sensord chmod a=rwxs /var/www/sensord .fi .PP در اینجا یک دایرکتوری در دسترس وب و قابل نوشتن برای همگان ایجاد می‌کنیم که نمودارها در آن ذخیره شوند؛ مالکیت و مجوزهای دسترسی این دایرکتوری را به‌طور مناسب تنظیم می‌کنیم\&. باید مسیر و مالکیت مناسب سیستم خود را تعیین کنید\&. .IP .nf sensord --load-average \ --rrd-file /var/log/sensord.rrd \ --rrd-cgi /var/www/sensord \ > /usr/lib/cgi-bin/sensord.cgi chmod a+rx /usr/lib/cgi-bin/sensord.cgi .fi .PP در اینجا یک اسکریپت CGI ایجاد می‌کنیم که خوانش‌های حسگر را از پایگاه داده نمایش می‌دهد\&. باید مسیر پایگاه داده چرخشی، مسیر دایرکتوری محل ذخیره تصاویر و تمایل خود به نمایش میانگین بار کاری را مشخص کنید\&. گزینه خط فرمان .B \-\-rrd\-cgi باعث می‌شود .BR sensord (8) یک اسکریپت CGI مناسب را در .B stdout نمایش دهد و سپس خارج شود\&. باید این اسکریپت را در دایرکتوری cgi-bin وب‌سرور خود بنویسید، و اگر دایرکتوری تصاویری که انتخاب کرده‌اید دایرکتوری .I /sensord/ در وب‌سرور شما نیست، اسکریپت را ویرایش کنید\&. .PP در نهایت، باید بتوانید خوانش‌های حسگر خود را از نشانی .B http://localhost/cgi-bin/sensord.cgi مشاهده کنید\&. .SH "پیمانه‌ها (MODULES)" انتظار می‌رود تمام ماژول‌های حسگر مورد نیاز پیش از شروع این دیمن بارگذاری شده باشند\&. این کار می‌تواند از طریق سازوکار بارگذاری ماژول مخصوص سیستم (برای نمونه، فهرست کردن ماژول‌های مورد نیاز در پرونده .I /etc/modules در دبیان) یا با دستورات صریح .BR modprobe (1) در یک اسکریپت init پیش از اجرای دیمن انجام شود\&. .PP برای نمونه، یک اسکریپت راه‌اندازی .B sensord ممکن است شامل دستورات زیر (در میان سایر دستورات) باشد: .IP .nf # Sample init.d scriptlet echo -n "Loading AMD756 module: " modprobe i2c-amd756 || { echo Fail. ; exit 1 ; } echo OK. echo -n "Loading W83781D module: " modprobe w83781d || { echo Fail. ; exit 1 ; } echo OK. echo -n "Starting sensord: " daemon sensord .fi .PP توابع پوسته وابسته به پلتفرم را نادیده بگیرید؛ ایده کلی باید کاملاً روشن باشد\&. .SH "خطاها (ERRORS)" خطاهای رخ‌داده در این دیمن در .BR syslogd (8) ثبت می‌شوند و پس از آن دیمن خارج خواهد شد\&. .SH "اشکالات (BUGS)" پشتیبانی از پایگاه داده چرخشی نمی‌تواند چندین تراشه حسگر با برچسب‌های حسگر تکراری را مدیریت کند\&. .SH "فایل‌ها (FILES)" .I /etc/sensors3.conf .br .I /etc/sensors.conf .RS پرونده پیکربندی سراسری .BR libsensors (3) در سیستم\&. برای جزئیات بیشتر به .BR sensors.conf (5) مراجعه کنید\&. .RE .I /etc/syslog.conf .RS پرونده پیکربندی سراسری .BR syslog (3) / .BR syslogd (8) در سیستم\&. برای جزئیات بیشتر به .BR syslog.conf (5) مراجعه کنید\&. .RE .SH "همچنین ببینید (SEE ALSO)" .BR sensors.conf (5) .SH "نویسندگان (AUTHORS)" .B sensord توسط Merlin Hughes نوشته شده است\&. مبانی پایگاه‌های داده چرخشی از Mark D. Studebaker اقتباس شده است\&.