.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\"
.\" Required to disable full justification in groff 1.23.0.
.if n .ds AD l
.\" ========================================================================
.\"
.IX Title "WINDRES 1"
.TH WINDRES 1 2026-07-30 binutils-2.47 "GNU Development Tools"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "نام (NAME)"
windres \- دستکاری و مدیریت منابع ویندوز
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "خلاصه دستور (SYNOPSIS)"
windres [گزینه‌ها] [input\-file] [output\-file]
.SH "توضیحات (DESCRIPTION)"
.IX Header "توضیحات (DESCRIPTION)"
دستور \&\fBwindres\fR منابع را از یک پرونده ورودی خوانده و آن‌ها را در یک پرونده خروجی کپی می‌کند. هر یک از این پرونده‌ها می‌توانند در یکی از سه قالب زیر باشند:
.ie n .IP """rc""" 4
.el .IP \f(CWrc\fR 4
.IX Item "rc"
یک قالب متنی که توسط کامپایلر منابع (Resource Compiler) خوانده می‌شود.
.ie n .IP """res""" 4
.el .IP \f(CWres\fR 4
.IX Item "res"
یک قالب باینری تولیدشده توسط کامپایلر منابع.
.ie n .IP """coff""" 4
.el .IP \f(CWcoff\fR 4
.IX Item "coff"
یک شیء یا فایل اجرایی COFF.
.PP
شرح دقیق این قالب‌های مختلف در مستندات مایکروسافت موجود است.
.PP
هنگامی که \fBwindres\fR قالبی را از \f(CW\*(C`rc\*(C'\fR به \f(CW\*(C`res\*(C'\fR تبدیل می‌کند، همانند Resource Compiler ویندوز عمل می‌کند. زمانی که \&\fBwindres\fR قالبی را از \f(CW\*(C`res\*(C'\fR به \f(CW\*(C`coff\*(C'\fR تبدیل می‌کند، شبیه به برنامه \f(CW\*(C`CVTRES\*(C'\fR ویندوز عمل می‌نماید.
.PP
هنگامی که \fBwindres\fR یک پرونده \f(CW\*(C`rc\*(C'\fR تولید می‌کند، خروجی شبیه اما نه کاملاً یکسان با قالب مورد انتظار برای ورودی است. هنگامی که یک پرونده ورودی \&\f(CW\*(C`rc\*(C'\fR به یک نام پرونده خارجی ارجاع دهد، پرونده خروجی \f(CW\*(C`rc\*(C'\fR در عوض محتوای آن پرونده را شامل خواهد شد.
.PP
اگر قالب ورودی یا خروجی مشخص نشده باشد، \fBwindres\fR بر اساس نام پرونده یا (برای پرونده ورودی) محتوای آن حدس می‌زند. پرونده‌ای با پسوند \fI.rc\fR به عنوان پرونده \f(CW\*(C`rc\*(C'\fR تلقی خواهد شد، پرونده‌ای با پسوند \fI.res\fR به عنوان \&\f(CW\*(C`res\*(C'\fR و پرونده‌ای با پسوند \fI.o\fR یا \&\fI.exe\fR به عنوان پرونده \f(CW\*(C`coff\*(C'\fR پردازش خواهد شد.
.PP
اگر پرونده خروجی مشخص نشود، \fBwindres\fR منابع را با قالب \f(CW\*(C`rc\*(C'\fR در خروجی استاندارد چاپ می‌کند.
.PP
کاربرد معمول این است که یک پرونده \f(CW\*(C`rc\*(C'\fR بنویسید، از \fBwindres\fR برای تبدیل آن به یک پرونده شیء COFF استفاده کنید، و سپس آن پرونده COFF را در برنامه خود پیوند دهید. این کار باعث می‌شود منابع تعریف‌شده در پرونده \&\f(CW\*(C`rc\*(C'\fR در ویندوز در دسترس قرار گیرند.
.SH "گزینه‌ها (OPTIONS)"
.IX Header "گزینه‌ها (OPTIONS)"
.IP "\fB\-i\fR \fIfilename\fR" 4
.IX Item "-i filename"
.PD 0
.IP "\fB\-\-input\fR \fIfilename\fR" 4
.IX Item "--input filename"
.PD
نام پرونده ورودی. اگر از این گزینه استفاده نشود، \&\fBwindres\fR از اولین آرگومان غیرگزینه‌ای به عنوان نام پرونده ورودی استفاده خواهد کرد. در صورت نبود آرگومان، \&\fBwindres\fR از ورودی استاندارد می‌خواند. دستور \fBwindres\fR نمی‌تواند پرونده COFF را از ورودی استاندارد بخواند.
.IP "\fB\-o\fR \fIfilename\fR" 4
.IX Item "-o filename"
.PD 0
.IP "\fB\-\-output\fR \fIfilename\fR" 4
.IX Item "--output filename"
.PD
نام پرونده خروجی. اگر استفاده نشود، \&\fBwindres\fR از اولین آرگومان غیرگزینه‌ای پس از ورودی به عنوان نام پرونده خروجی استفاده می‌کند. اگر آرگومانی نباشد، در خروجی استاندارد می‌نویسد. \&\fBwindres\fR نمی‌تواند پرونده COFF را در خروجی استاندارد بنویسد. توجه داشته باشید برای سازگاری با \fBrc\fR گزینه \fB\-fo\fR نیز پذیرفته می‌شود، اما استفاده از آن توصیه نمی‌شود.
.IP "\fB\-J\fR \fIformat\fR" 4
.IX Item "-J format"
.PD 0
.IP "\fB\-\-input\-format\fR \fIformat\fR" 4
.IX Item "--input-format format"
.PD
قالب ورودی جهت خواندن. مقدار \fIformat\fR می‌تواند \fBres\fR، \fBrc\fR یا \&\fBcoff\fR باشد. اگر قالب ورودی تعیین نشود، \fBwindres\fR طبق توضیحات بالا حدس می‌زند.
.IP "\fB\-O\fR \fIformat\fR" 4
.IX Item "-O format"
.PD 0
.IP "\fB\-\-output\-format\fR \fIformat\fR" 4
.IX Item "--output-format format"
.PD
قالب خروجی جهت تولید. مقدار \fIformat\fR می‌تواند \fBres\fR، \&\fBrc\fR یا \fBcoff\fR باشد. در صورت عدم تعیین، \&\fBwindres\fR آن را حدس می‌زند.
.IP "\fB\-F\fR \fItarget\fR" 4
.IX Item "-F target"
.PD 0
.IP "\fB\-\-target\fR \fItarget\fR" 4
.IX Item "--target target"
.PD
مشخص کردن قالب BFD مورد استفاده برای یک پرونده COFF به عنوان ورودی یا خروجی. این یک نام هدف BFD است؛ می‌توانید از گزینه \fB\-\-help\fR برای مشاهده فهرست هدف‌های پشتیبانی‌شده استفاده کنید. معمولاً \fBwindres\fR از قالب پیش‌فرض که اولین مورد فهرست‌شده در \fB\-\-help\fR است استفاده می‌کند.
.IP "\fB\-\-preprocessor\fR \fIprogram\fR" 4
.IX Item "--preprocessor program"
هنگامی که \fBwindres\fR یک پرونده \f(CW\*(C`rc\*(C'\fR را می‌خواند، ابتدا آن را از پیش‌پردازنده C عبور می‌دهد. این گزینه برای تعیین پیش‌پردازنده استفاده می‌شود. پیش‌پردازنده پیش‌فرض \f(CW\*(C`gcc\*(C'\fR است.
.IP "\fB\-\-preprocessor\-arg\fR \fIoption\fR" 4
.IX Item "--preprocessor-arg option"
تعیین متن اضافی جهت ارسال به خط فرمان پیش‌پردازنده هنگام خواندن پرونده \f(CW\*(C`rc\*(C'\fR. این گزینه می‌تواند چندین بار تکرار شود. در صورت مشخص نشدن \fB\-\-preprocessor\fR، مجموعه‌ای از آرگومان‌های پیش‌فرض استفاده خواهد شد (\f(CW\*(C`\-E\*(C'\fR، \&\f(CW\*(C`\-xc\-header\*(C'\fR و \f(CW\*(C`\-DRC_INVOKED\*(C'\fR) و گزینه‌های \fB\-\-preprocessor\-arg\fR بعد از آن‌ها قرار می‌گیرند.
.IP "\fB\-I\fR \fIdirectory\fR" 4
.IX Item "-I directory"
.PD 0
.IP "\fB\-\-include\-dir\fR \fIdirectory\fR" 4
.IX Item "--include-dir directory"
.PD
تعیین یک شاخه الحاقی (include) برای استفاده هنگام خواندن پرونده \f(CW\*(C`rc\*(C'\fR. این شاخه به عنوان گزینه \fB\-I\fR به پیش‌پردازنده داده می‌شود و هنگام جستجوی پرونده‌ها نیز بررسی خواهد شد.
.IP "\fB\-D\fR \fItarget\fR" 4
.IX Item "-D target"
.PD 0
.IP "\fB\-\-define\fR \fIsym\fR\fB[=\fR\fIval\fR\fB]\fR" 4
.IX Item "--define sym[=val]"
.PD
تعیین گزینه \fB\-D\fR برای ارسال به پیش‌پردازنده هنگام خواندن پرونده \&\f(CW\*(C`rc\*(C'\fR.
.IP "\fB\-U\fR \fItarget\fR" 4
.IX Item "-U target"
.PD 0
.IP "\fB\-\-undefine\fR \fIsym\fR" 4
.IX Item "--undefine sym"
.PD
تعیین گزینه \fB\-U\fR برای ارسال به پیش‌پردازنده هنگام خواندن پرونده \&\f(CW\*(C`rc\*(C'\fR.
.IP \fB\-r\fR 4
.IX Item "-r"
جهت سازگاری با rc نادیده گرفته می‌شود.
.IP \fB\-v\fR 4
.IX Item "-v"
فعال‌سازی حالت پرگویی (verbose). این گزینه در صورت عدم تعیین پیش‌پردازنده، نام آن را اعلام می‌کند.
.IP "\fB\-c\fR \fIval\fR" 4
.IX Item "-c val"
.PD 0
.IP "\fB\-\-codepage\fR \fIval\fR" 4
.IX Item "--codepage val"
.PD
تعیین کدپیج (codepage) پیش‌فرض برای خواندن پرونده \f(CW\*(C`rc\*(C'\fR. مقدار \fIval\fR باید یک کد هگزادسیمال با پیشوند \fB0x\fR یا عدد ده‌دهی باشد (محدوده مجاز از ۰ تا 0xffff).
.IP "\fB\-l\fR \fIval\fR" 4
.IX Item "-l val"
.PD 0
.IP "\fB\-\-language\fR \fIval\fR" 4
.IX Item "--language val"
.PD
تعیین زبان پیش‌فرض هنگام خواندن پرونده \f(CW\*(C`rc\*(C'\fR. مقدار \fIval\fR باید کد زبان در قالب هگزادسیمال باشد (هشت بیت پایین زبان و هشت بیت بالا زیرزبان).
.IP \fB\-\-use\-temp\-file\fR 4
.IX Item "--use-temp-file"
استفاده از یک پرونده موقت به جای popen برای خواندن خروجی پیش‌پردازنده. در صورتی که پیاده‌سازی popen روی میزبان دارای اشکال باشد از این گزینه استفاده کنید.
.IP \fB\-\-no\-use\-temp\-file\fR 4
.IX Item "--no-use-temp-file"
استفاده از popen و نه پرونده موقت برای خواندن خروجی پیش‌پردازنده (رفتار پیش‌فرض).
.IP \fB\-h\fR 4
.IX Item "-h"
.PD 0
.IP \fB\-\-help\fR 4
.IX Item "--help"
.PD
چاپ خلاصه راهنمای کاربرد.
.IP \fB\-V\fR 4
.IX Item "-V"
.PD 0
.IP \fB\-\-version\fR 4
.IX Item "--version"
.PD
چاپ شماره نگارش \fBwindres\fR.
.IP \fB\-\-yydebug\fR 4
.IX Item "--yydebug"
در صورت کامپایل شدن با تعریف \f(CW\*(C`YYDEBUG\*(C'\fR، اشکال‌زدایی تجزیه‌کننده را فعال می‌کند.
.IP \fB@\fR\fIfile\fR 4
.IX Item "@file"
خواندن گزینه‌های خط فرمان از \fIfile\fR. گزینه‌ها به جای خود گزینه @\fIfile\fR درج می‌شوند. پرونده می‌تواند شامل گزینه‌های @\fIfile\fR بیشتر به صورت بازگشتی باشد.
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "همچنین ببینید (SEE ALSO)"
مدخل‌های Info برای \fIbinutils\fR.
.SH "حق نشر (COPYRIGHT)"
.IX Header "حق نشر (COPYRIGHT)"
حق نشر (c) 1991\-2026 Free Software Foundation, Inc.
.PP
مجوز کپی، توزیع و/یا تغییر این سند تحت شرایط مجوز مستندات آزاد گنو (GNU Free Documentation License)، نگارش 1.3 یا هر نگارش بعدی منتشر شده توسط بنیاد نرم‌افزار آزاد اعطا می‌شود.