PSENSOR-SERVER(1) User Commands PSENSOR-SERVER(1) نام (NAME) psensor-server - وب‌سرور پایش دما و سیستم خلاصه دستور (SYNOPSIS) psensor-server [OPTION]... توضیحات (DESCRIPTION) برنامهٔ psensor-server یک کارگزار HTTP برای پایش حسگرهای سخت‌افزاری از راه دور است. این برنامه یک وب‌سرویس JSON ارائه می‌دهد که می‌تواند توسط psensor(1) برای پایش حسگرهای سخت‌افزاری یک رایانه از راه دور استفاده شود. این ابزار می‌تواند اطلاعات زیر را ارائه دهد: * دمای حسگرهای مادربرد و CPU (با استفاده از lm-sensors). * دمای دیسک‌های سخت (با استفاده از hddtemp). * سرعت چرخش فن‌ها (با استفاده از lm-sensors). همچنین اتصال به psensor-server با یک مرورگر امکان‌پذیر است؛ یک صفحهٔ وب ساده، اطلاعات حسگرها و میزان مصرف CPU را نمایش می‌دهد. نشانی اینترنتی http://hostname:3131/api/1.0/sensors/[id] یک شیء JSON شامل تمام اطلاعات مربوط به یک حسگر را برمی‌گرداند. [id] شناسهٔ یکتای حسگر است. در اینجا نمونه‌ای از شیء JSON از نوع 'sensor' آورده شده است: { "id": "lmsensor acpitz-virtual-0 temp1", "name": "temp1", "type": 257, "min": 47.800000, "max": 60.800000, "measures": [ { "value": 47.800000, "time": 1311374873 }, { "value": 49.800000, "time": 1311374878 }, { "value": 49.800000, "time": 1311374883 } ], "last_measure": { "value": 49.800000, "time": 1311374883 } } فیلدهای نوع 'sensor': * id: شناسهٔ یکتای حسگر. * name: یک نام خوانا برای انسان از حسگر (ممکن است یکتا نباشد). * type: نوع حسگر. برای انواع مختلف، به src/lib/psensor.h مراجعه کنید. * min: کمینهٔ مقدار حسگر. * max: بیشینهٔ مقدار حسگر. * measures: تمام اندازه‌گیری‌های حسگر. * last_measure: آخرین مقدار حسگر. * time: زمان اندازه‌گیری بر حسب تعداد ثانیه‌های گذشته از 1970/01/01. نشانی اینترنتی http://hostname:3131/api/1.0/sensors یک آرایهٔ JSON شامل تمامی اشیاء JSON از نوع 'sensor' را برمی‌گرداند. برنامهٔ psensor-server می‌تواند با ارسال یک درخواست HTTP با نشانی 'http://hostname:port/api/1.0/server/stop' متوقف شود. گزینه‌ها (OPTIONS) -h, --help نمایش این راهنما و خروج -v, --version نمایش اطلاعات نگارش و خروج -p,--port=PORT درگاه وب‌سرور -w,--wdir=DIR دایرکتوری حاوی صفحات وب‌سرور -d, --debug=LEVEL تنظیم سطح اشکال‌زدایی، عدد صحیحی بین 0 و 3 -l, --log-file=PATH تنظیم فایل لاگ به PATH --sensor-log-file=PATH تنظیم فایل لاگ حسگر به PATH --sensor-log-interval=S تنظیم بازهٔ لاگ حسگر به S (ثانیه) فایل لاگ حسگر (SENSOR LOG FILE) اطلاعات حسگرها با استفاده از گزینهٔ --sensor-log-file قابل ثبت هستند. این قابلیت از یک قالب متنی استفاده می‌کند، و هر خط با نویسهٔ NEWLINE پایان می‌یابد. خط نخست عبارت است از: I,%D,%V %D زمان آغاز ثبت لاگ است که بر حسب تعداد ثانیه‌ها از زمان مبدأ (EPOC) بیان می‌شود. %V نگارش psensor-server است. خطوط بعدی فهرست مرتب‌شده‌ای از حسگرها را ارائه می‌دهند: S,%I,%T %I شناسهٔ یکتای حسگر است. %T نمایش هگزادسیمال (شانزده‌شانزدهی) نوع حسگر است. سپس، مقادیر تمامی حسگرها نوشته می‌شود: %D,%V... %D تعداد ثانیه‌های سپری‌شده از زمان آغاز ثبت لاگ است. %V... فهرستی جداشده با ویرگول از مقادیر کنونی تمام حسگرها است. ترتیب آن با فهرست شناسه‌های حسگر یکسان است. مقدار به عنوان یک عدد ممیز شناور با دقت یک رقم اعشار بیان می‌شود. دماها بر حسب سلسیوس هستند. مقدار فقط در صورتی نوشته می‌شود که تغییر کرده باشد. مثال: I,1345974927,0.7.0.4 S,lmsensor coretemp-isa-0000 Physical id 0,101 S,lmsensor coretemp-isa-0000 Core 0,101 S,lmsensor coretemp- isa-0000 Core 1,101 0,37.0,37.0,36.0 5,36.0,,36.0 پنج ثانیه پس از آغاز ثبت لاگ، دمای حسگر دوم (Core 0) همچنان 37C است. هشدار (WARNING) برنامهٔ psensor-server هیچ روشی برای محدودسازی اتصال به وب‌سرور HTTP ارائه نمی‌دهد، و بدتر اینکه هیچ تدبیری در برابر حملات مخرب HTTP اندیشیده نشده است. شما باید درگاه psensor-server را تنها با استفاده از ابزارهای معمول امنیت شبکه در سیستم (به عنوان مثال iptables(8))، صرفاً در دسترس شبکه یا رایانه‌ای قرار دهید که به آن اطمینان دارید. گزارش باگ‌ها (BUGS) گزارش باگ‌ها به: jeanfi@gmail.com صفحهٔ خانگی psensor: کپی‌رایت و تکثیر (COPYRIGHT) حق نشر © 2010-2012 jeanfi@gmail.com اجازه‌نامهٔ GPLv2: گنو GPL نسخهٔ ۲ یا بالاتر این نرم‌افزار آزاد است: شما برای تغییر و توزیع مجدد آن آزاد هستید. هیچ ضمانتی وجود ندارد، تا حدی که قانون اجازه می‌دهد. همچنین ببینید (SEE ALSO) psensor(1), sensors(1), sensors-detect(8) psensor-server 1.2.1 August 2026 PSENSOR-SERVER(1)