GPSDCTL(8)                    GPSD Documentation                    GPSDCTL(8)

نام (NAME)
       gpsdctl - ابزاری برای ارسال دستورات به gpsd از طریق سوکت کنترلی آن

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

گزینه‌ها (OPTIONS)
       action
           می‌تواند add یا remove باشد. اگر هنگام درخواست add هیچ نمونه‌ای از
           دیمن در حال اجرا نباشد، این برنامه یک نمونه را اجرا خواهد کرد.

       device
           این آرگومان باید مسیر پروندهٔ یک دستگاه باشد. این دستگاه توسط gpsd
           برای خواندن داده‌های حسگر باز خواهد شد.

توضیحات (DESCRIPTION)
       این ابزاری برای ارسال دستورات به یک نمونه از gpsd از طریق سوکت کنترلی
       آن، به منظور افزودن یا حذف دستگاه‌ها از فهرست دستگاه‌های دیمن است. این
       برنامه برای فراخوانی مستقیم توسط کاربران در نظر گرفته نشده است، بلکه
       برای استفاده توسط سامانهٔ hotplug لینوکس و سازوکارهای مشابه طراحی شده
       است.

متغیرهای محیطی (ENVIRONMENT)
       دو متغیر محیطی تفسیر می‌شوند.

       GPSD_SOCKET
           مکان سوکت کنترلی را تعیین می‌کند. اگر شناسهٔ کاربر مؤثر این برنامه
           کاربر ریشه (root) باشد، مقدار پیش‌فرض معمولاً /run/gpsd.sock است،
           هرچند برخی سیستم‌ها ممکن است در عوض از مسیر منسوخ‌شدهٔ
           /var/run/gpsd.sock استفاده کنند. کاربران غیر ریشه از /tmp/gpsd.sock
           استفاده خواهند کرد.

       GPSD_OPTIONS
           می‌تواند فهرستی از گزینه‌ها باشد که هنگام راه‌اندازی gpsd توسط این
           ابزار، به آن ارسال می‌شود. مقدار پیش‌فرض آن یک رشتهٔ خالی است.

مقادیر بازگشتی (RETURN VALUES)
       0
           در صورت موفقیت.

       1
           اگر عملیات ناشناخته باشد یا نوشتن در سوکت کنترلی با شکست مواجه شود.

همچنین ببینید (SEE ALSO)
       gpsd(8), gpsctl(1), gps(1), libgps(3), libgpsmm(3), gpsprof(1),
       gpsfake(1).

منابع (RESOURCES)
       وب‌سایت پروژه:  <https://gpsd.io>

حق نشر (COPYING)
       حق نشر این پرونده متعلق به پروژهٔ GPSD در سال 2013 است (Copyright 2013
       by the GPSD project)
       SPDX-License-Identifier: BSD-2-clause

نویسنده (AUTHOR)
       Eric S. Raymond

GPSD, Version 3.27.5              2025-11-04                        GPSDCTL(8)