.\" $XTermId: resize.man,v 1.41 2025/06/08 22:06:51 tom Exp $
.\" ---------------------------------------------------------------------------
.\" Copyright 1998-2024,2025 by Thomas E. Dickey
.\"
.\"                         All Rights Reserved
.\"
.\" Permission is hereby granted, free of charge, to any person obtaining a
.\" copy of this software and associated documentation files (the
.\" "Software"), to deal in the Software without restriction, including
.\" without limitation the rights to use, copy, modify, merge, publish,
.\" distribute, sublicense, and/or sell copies of the Software, and to
.\" permit persons to whom the Software is furnished to do so, subject to
.\" the following conditions:
.\"
.\" The above copyright notice and this permission notice shall be included
.\" in all copies or substantial portions of the Software.
.\"
.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
.\" OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
.\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
.\" IN NO EVENT SHALL THE ABOVE LISTED COPYRIGHT HOLDER(S) BE LIABLE FOR ANY
.\" CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
.\" TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
.\" SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
.\"
.\" Except as contained in this notice, the name(s) of the above copyright
.\" holders shall not be used in advertising or otherwise to promote the
.\" sale, use or other dealings in this Software without prior written
.\" authorization.
.\" ---------------------------------------------------------------------------
.\" updated by Thomas E. Dickey for XFree86, 1998-2006.
.\"
.ds N Resize
.ds n resize
.
.TH RESIZE 1 "2026-08-24" "Patch #411" "X Window System"
.\"
.ie n .ds CW R
.el   \{
.ie \n(.g .ds CW CR
.el       .ds CW CW
.\}
.
.ie \n(.g \{\
.ds `` \(lq
.ds '' \(rq
.ds '  \(aq
.\}
.el \{\
.ie t .ds `` ``
.el   .ds `` ""
.ie t .ds '' ''
.el   .ds '' ""
.ie t .ds '  \(aq
.el   .ds '  '
.\}
.de bP
.ie n  .IP \(bu 4
.el    .IP \(bu 2
..
.de NE
.fi
.ft R
.ie n  .in -4
.el    .in -2
..
.de NS
.ie n  .sp
.el    .sp .5
.ie n  .in +4
.el    .in +2
.nf
.ft \*(CW
..
.SH "نام (NAME)"
resize \- تنظیم متغیرهای محیطی و تنظیمات ترمینال با اندازهٔ فعلی پنجرهٔ xterm
.SH "خلاصه دستور (SYNOPSIS)"
.B \*n
[ \fB\-v\fP | \fB\-u\fP | \fB\-c\fP ] [ \fB\-s\fP [ \fIrow col\fP ] ]
.SH "توضیحات (DESCRIPTION)"
دستور
.I \*N
یک دستور شل را برای تنظیم متغیرهای محیطی مناسب چاپ می‌کند
تا اندازهٔ فعلی پنجرهٔ \fIxterm\fP را که دستور از داخل آن اجرا شده است،
مشخص سازد.
.PP
.I \*N
این دستور را طی چند مرحله تعیین می‌کند:
.bP
نخست، نام برنامهٔ شل کاربر را پیدا می‌کند.
در صورت تنظیم بودن از متغیر \fBSHELL\fP استفاده می‌کند،
در غیر این صورت از داده‌های کاربر در /etc/passwd بهره می‌برد.
.bP
سپس تصمیم می‌گیرد که آیا از نحو Bourne shell استفاده کند یا نحو C-Shell.
برای این کار از یک جدول داخلی از شل‌های شناخته‌شده استفاده می‌کند،
که می‌توان آن را با گزینه‌های \fB\-u\fP و \fB\-c\fP بازنویسی کرد.
.bP
سپس \fI\*n\fP تنظیمات ترمینال را از سیستم‌عامل درخواست می‌کند.
این همان اطلاعاتی است که می‌توان با استفاده از \fIstty\fP دستکاری کرد.
.bP
سپس \fI\*n\fP اندازهٔ ترمینال را بر حسب نویسه‌ها از آن درخواست می‌کند.
بسته به این‌که گزینهٔ \fB\-s\fP داده شده باشد یا خیر،
\fI\*n\fP از دنبالهٔ گریز متفاوتی برای درخواست این اطلاعات استفاده می‌کند.
.bP
در این مرحله، \fI\*n\fP تلاش می‌کند تنظیمات ترمینال را به‌روزرسانی کند
تا اندازهٔ پنجرهٔ ترمینال بر حسب پیکسل منعکس شود:
.RS
.bP
اگر گزینهٔ \fB\-s\fP استفاده شده باشد،
آنگاه \fI\*n\fP اندازهٔ ترمینال را بر حسب پیکسل از خود ترمینال درخواست می‌کند.
.bP
در غیر این صورت،
\fI\*n\fP اطلاعات را از سیستم‌عامل درخواست کرده
و پس از اطمینان از این‌که ابعاد پنجره مضربی از ارتفاع و عرض نویسه است،
آن را به‌روزرسانی می‌کند.
.bP
در هر دو حالت، به‌روزرسانی تنظیمات ترمینال با استفاده از یک فراخوان سیستمی متفاوت
از آنچه برای \fIstty\fP استفاده می‌شود انجام می‌گیرد.
.RE
.bP
سپس \fI\*n\fP تنظیمات ترمینال را به‌روز می‌کند تا هرگونه مقادیر تغییر‌یافته
مانند اندازهٔ آن در سطرها یا ستون‌ها را منعکس سازد.
این کار بر مقادیر نمایش‌داده‌شده توسط \fIstty\fP تأثیر می‌گذارد.
.bP
در نهایت، \fI\*n\fP دستورات شل را برای تنظیم متغیرهای محیطی تولید کرده
و آن‌ها را در خروجی استاندارد می‌نویسد.
.SH "گزینه‌ها (OPTIONS)"
گزینه‌های زیر را می‌توان با \fI\*n\fP به کار برد:
.TP 8
.B \-c
این گزینه مشخص می‌کند که دستورات C shell باید تولید شوند، حتی اگر به نظر برسد شل فعلی کاربر از نحو C shell استفاده نمی‌کند.
.TP 8
.B \-s \fR[\fIrows columns\fP]
این گزینه مشخص می‌کند که به‌جای کدهای گریز \fIxterm\fP به سبک VT100، از دنباله‌های گریز کنسول Sun استفاده شود.
اگر \fIrows\fP و
\fIcolumns\fP مشخص شوند،
\fI\*n\fP از \fIxterm\fP می‌خواهد که با استفاده از آن مقادیر، اندازهٔ خود را تغییر دهد.
.IP
هر دو دنبالهٔ گریز مورد استفاده برای این گزینه
(نخست برای دریافت اندازهٔ پنجره و دوم برای تغییر دادن آن)
تابع تنظیم منبع \fBallowWindowOps\fP در \fIxterm\fP هستند.
مدیر پنجره نیز ممکن است تصمیم بگیرد که این تغییر را مجاز نداند.
.IP
دنبالهٔ گریز به سبک VT100 که برای تعیین اندازهٔ صفحه استفاده می‌شود،
همیشه برای ترمینال‌های سازگار با VT100 کار می‌کند.
ترمینال‌های VT100 روش متناظری برای تغییر دادن اندازهٔ صفحه ندارند.
.TP 8
.B \-u
این گزینه مشخص می‌کند که دستورات Bourne shell باید تولید شوند، حتی اگر به نظر برسد شل فعلی کاربر از نحو Bourne shell استفاده نمی‌کند.
.TP 8
.B \-v
این گزینه باعث می‌شود \fI\*n\fP شماره نسخه را در خروجی استاندارد چاپ کرده و سپس خارج شود.
.PP
توجه داشته باشید که دنباله‌های گریز کنسول Sun توسط \fIxterm\fP در XFree86 و
توسط \fIdtterm\fP پشتیبانی و شناخته می‌شوند.
ممکن است برنامهٔ \fI\*n\fP با نام \fIsunsize\fP نصب شده باشد،
که باعث می‌شود گزینهٔ \fB\-s\fP به طور خودکار پیش‌فرض فرض شود.
.PP
آرگومان‌های \fIrows\fP و
\fIcolumns\fP باید در انتها بیایند؛ اگرچه معمولاً
به گزینهٔ \fB\-s\fP وابسته‌اند، اما به‌صورت جداگانه تجزیه می‌شوند.
.SH "محیط (ENVIRONMENT)"
.TP 15
SHELL
مگر اینکه توسط گزینهٔ \fB\-c\fP بازنویسی شود،
\fI\*n\fP شل فعلی کاربر را به این شیوه تعیین می‌کند:
.RS
.bP
ابتدا بررسی می‌کند که آیا \fB$SHELL\fP
تنظیم شده است یا خیر و از آن استفاده می‌کند،
.bP
در غیر این صورت \fI\*n\fP فایل گذرواژه
(/etc/passwd) را بررسی می‌کند.
.RE
.IP
به‌طور کلی، گونه‌های مختلف Bourne-shell (از جمله \fIksh\fP)
متغیر \fB$SHELL\fP را تغییر نمی‌دهند،
بنابراین اگر کاربر \fI\*n\fP را از درون یک Bourne shell که از یک C shell اجرا شده اجرا کند، ممکن است \fI\*n\fP دچار سردرگمی شود.
.IP
پس از تعیین شل کاربر، \fI\*n\fP نام شل را با یک جدول از نام‌های شل‌های شناخته‌شده مقایسه می‌کند.
اگر نام را در جدول خود نیابد، \fI\*n\fP برای دستورات تولیدشده جهت تنظیم متغیرهای محیطی از نحو C shell استفاده خواهد کرد.
.TP 15
TERM
دستور شل تولیدشده توسط
.IR \*N ،
در صورتی که این متغیر قبلاً تنظیم نشده باشد، آن را روی "xterm" قرار می‌دهد.
.TP 15
TERMCAP
دستور شل تولیدشده توسط
.IR \*N
این متغیر را در سیستم‌هایی که از termcap استفاده می‌کنند تنظیم می‌نماید،
برای نمونه هنگامی که \fI\*n\fP به‌جای کتابخانهٔ \fIterminfo\fP با کتابخانهٔ \fItermcap\fP پیوند خورده باشد.
کتابخانهٔ اخیر متن کامل مدخل termcap را ارائه نمی‌دهد.
.TP 15
COLUMNS, LINES
دستور شل تولیدشده توسط
.IR \*N
این متغیرها را در سیستم‌هایی که از terminfo استفاده می‌کنند تنظیم می‌کند.
بسیاری از برنامه‌ها (از جمله کتابخانهٔ curses)
در صورت تنظیم بودن این متغیرها، از آن‌ها برای بازنویسی اندازهٔ صفحهٔ خود استفاده می‌کنند.
.SH "فایل‌ها (FILES)"
.TP 15
/etc/termcap
برای مدخل پایهٔ termcap جهت ویرایش.
.TP 15
~/.cshrc
نام مستعار (alias) کاربر برای این دستور.
.SH "مثال‌ها (EXAMPLES)"
برای اینکه خروجی \fI\*n\fP اعمال شود،
\fI\*n\fP باید یا به عنوان بخشی از خط فرمان ارزیابی شود
(که معمولاً با یک alias یا تابع شل انجام می‌شود) یا
به فایلی هدایت شود که سپس بتوان آن را خواند.
از طریق C shell (که معمولاً با نام
\fI/bin/csh\fP شناخته می‌شود)، می‌توان نام مستعار زیر را در فایل \fI.cshrc\fP کاربر تعریف کرد:
.NS
% alias rs \*'set noglob; eval \`\*n\`\*'
.NE
.PP
پس از تغییر اندازهٔ پنجره، کاربر عبارت زیر را وارد می‌کند:
.NS
% rs
.NE
.PP
کاربران نسخه‌هایی از Bourne shell (که معمولاً به نام \fI/bin/sh\fP شناخته می‌شود) که
فاقد توابع دستوری هستند، باید خروجی را به یک فایل موقت هدایت کرده و سپس با دستور \*(``.\*('' آن را مجدداً بخوانند:
.NS
$ \*n > /tmp/out
$ .\0/tmp/out
.NE
.SH "نویسندگان (AUTHORS)"
Mark Vandevoorde (MIT-Athena), Edward Moy (Berkeley)
.br
Thomas Dickey (invisible-island.net).
.br
حق نشر (c) 1984، 1985 متعلق به کنسرسیوم اکس (X Consortium)
.br
برای دیدن اعلامیهٔ کامل کپی‌رایت به
.IR X (1)
مراجعه کنید.
.SH "همچنین ببینید (SEE ALSO)"
use_env(3x)
.br
csh(1), stty(1), tset(1)
.br
xterm(1)