| UPTERM(1) | Upterm Manual | UPTERM(1) |
نام (NAME)
upterm-session-current - نمایش نشست جاری ترمینال
خلاصه دستور (SYNOPSIS)
upterm session current [flags]
توضیحات (DESCRIPTION)
نشست جاری ترمینال را نمایش میدهد.
بهطور پیشفرض، مسیر سوکت مدیریتی را از متغیر $UPTERM_ADMIN_SOCKET میخواند (که با اجرای دستور 'upterm host' بهصورت خودکار تنظیم میشود).
سوکتها در این مسیر ذخیره میشوند: /build/.upterm
از مشخصات دایرکتوری پایه XDG پیروی میکند و در محیطهای محدود که دایرکتوریهای XDG در دسترس نیستند، از $HOME/.upterm بهعنوان جایگزین پشتیبان استفاده میکند.
قالبهای
خروجی:
-o json خروجی JSON
-o go-template='{{.ClientCount}}' قالب
سفارشی Go
متغیرهای قالب: SessionID، ClientCount، Host، Command، ForceCommand
گزینهها (OPTIONS)
--admin-socket="" مسیر سوکت مدیریتی (الزامی).
-h, --help[=false] راهنمای current
--hide-client-ip[=false] مخفیسازی آدرسهای IP کلاینت از خروجی (بهطور خودکار در محیطهای CI فعال میشود).
-o, --output="" قالب خروجی: json یا go-template='...'
گزینههای به ارث رسیده از دستورات والد (OPTIONS INHERITED FROM PARENT COMMANDS)
--debug[=false] فعالسازی ثبت گزارش در سطح اشکالزدایی (فایل گزارش: /build/.upterm/upterm.log).
مثالها (EXAMPLES)
# نمایش نشست فعال همانطور که در $UPTERM_ADMIN_SOCKET تعریف شده است:
upterm session current
# خروجی در قالب JSON:
upterm session current -o json
# قالب سفارشی برای اعلان خط فرمان (اگر در نشستی نباشد چیزی چاپ نمیشود):
upterm session current -o go-template='🆙 {{.ClientCount}} '
# برای عنوان ترمینال:
upterm session current -o go-template='upterm: {{.ClientCount}} clients | {{.SessionID}}'
همچنین ببینید (SEE ALSO)
تاریخچه (HISTORY)
۶ مه ۲۰۲۶ تولید شده بهصورت خودکار توسط spf13/cobra
| May 2026 | Upterm 0.0.0+dev |