'\" t
.\"     Title: gpsdctl
.\"    Author: Eric S. Raymond
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2025-11-04
.\"    Manual: GPSD Documentation
.\"    Source: GPSD, Version 3.27.5
.\"  Language: Persian
.\"
.TH "GPSDCTL" "8" "2025-11-04" "GPSD, Version 3.27.5" "GPSD Documentation"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "نام (NAME)"
gpsdctl \- ابزاری برای ارسال دستورات به gpsd از طریق سوکت کنترلی آن
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBgpsdctl\fP \fIaction\fP \fIdevice\fP
.SH "گزینه‌ها (OPTIONS)"
.sp
\fBaction\fP
.RS 4
می‌تواند \fIadd\fP یا \fIremove\fP باشد. اگر هنگام درخواست \fIadd\fP هیچ نمونه‌ای از دیمن در حال اجرا نباشد، این برنامه یک نمونه را اجرا خواهد کرد.
.RE
.sp
\fBdevice\fP
.RS 4
این آرگومان باید مسیر پروندهٔ یک دستگاه باشد. این دستگاه توسط \fBgpsd\fP برای خواندن داده‌های حسگر باز خواهد شد.
.RE
.SH "توضیحات (DESCRIPTION)"
.sp
این ابزاری برای ارسال دستورات به یک نمونه از \fBgpsd\fP از طریق سوکت کنترلی آن، به منظور افزودن یا حذف دستگاه‌ها از فهرست دستگاه‌های دیمن است. این برنامه برای فراخوانی مستقیم توسط کاربران در نظر گرفته نشده است، بلکه برای استفاده توسط سامانهٔ hotplug لینوکس و سازوکارهای مشابه طراحی شده است.
.SH "متغیرهای محیطی (ENVIRONMENT)"
.sp
دو متغیر محیطی تفسیر می‌شوند.
.sp
\fBGPSD_SOCKET\fP
.RS 4
مکان سوکت کنترلی را تعیین می‌کند. اگر شناسهٔ کاربر مؤثر این برنامه کاربر ریشه (root) باشد، مقدار پیش‌فرض معمولاً \fI/run/gpsd.sock\fP است، هرچند برخی سیستم‌ها ممکن است در عوض از مسیر منسوخ‌شدهٔ \fI/var/run/gpsd.sock\fP استفاده کنند. کاربران غیر ریشه از \fI/tmp/gpsd.sock\fP استفاده خواهند کرد.
.RE
.sp
\fBGPSD_OPTIONS\fP
.RS 4
می‌تواند فهرستی از گزینه‌ها باشد که هنگام راه‌اندازی gpsd توسط این ابزار، به آن ارسال می‌شود. مقدار پیش‌فرض آن یک رشتهٔ خالی است.
.RE
.SH "مقادیر بازگشتی (RETURN VALUES)"
.sp
\fB0\fP
.RS 4
در صورت موفقیت.
.RE
.sp
\fB1\fP
.RS 4
اگر عملیات ناشناخته باشد یا نوشتن در سوکت کنترلی با شکست مواجه شود.
.RE
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBgpsd\fP(8), \fBgpsctl\fP(1), \fBgps\fP(1), \fBlibgps\fP(3), \fBlibgpsmm\fP(3), \fBgpsprof\fP(1),
\fBgpsfake\fP(1).
.SH "منابع (RESOURCES)"
.sp
\fBوب‌سایت پروژه:\fP \c
.URL "https://gpsd.io" "" ""
.SH "حق نشر (COPYING)"
.sp
حق نشر این پرونده متعلق به پروژهٔ GPSD در سال 2013 است (Copyright 2013 by the GPSD project)
.br
SPDX\-License\-Identifier: BSD\-2\-clause
.SH "نویسنده (AUTHOR)"
.sp
Eric S. Raymond