.\" --------------------------------------------------------------------
.\"
.\" Copyright (C) 2000-2026 The Octave Project Developers
.\"
.\" See the file COPYRIGHT.md in the top-level directory of this
.\" or <https://octave.org/copyright>.
.\"
.\" This file is part of Octave.
.\"
.\" Octave is free software: you can redistribute it and/or modify it
.\" under the terms of the GNU General Public License as published by
.\" the Free Software Foundation, either version 3 of the License, or
.\" (at your option) any later version.
.\"
.\" Octave is distributed in the hope that it will be useful, but
.\" WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public License
.\" along with Octave; see the file COPYING.  If not, see
.\" <https://www.gnu.org/licenses>.
.\"
.\" --------------------------------------------------------------------
.\"
.de Vb \" (V)erbatim (b)egin.  Use fixed width font and no justification
.ft CW
.nf
..
.de Ve \" (V)erbatim (e)nd.  Return to regular font and justification
.ft R
.fi
..
.\" --------------------------------------------------------------------
.TH mkoctfile 1 "April 2026" "GNU Octave"
.SH "نام (NAME)"
mkoctfile \- کامپایل ماژول‌های بارگذاری پویا برای گنو اکتاو
.SH "خلاصه دستور (SYNOPSIS)"
\fBmkoctfile\fP [\fIoption\fP]\|.\|.\|.\& FILE\|.\|.\|.\&
.SH "توضیحات (DESCRIPTION)"
\fBmkoctfile\fP برای کامپایل کدهای منبع C، C++، یا Fortran به یک فایل با قابلیت بارگذاری پویا \fB.oct\fP برای
.MR octave 1
به کار می‌رود.
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-h\fP, \fB\-\-help\fP
چاپ پیام راهنما.
.TP
.B \-I\fIdir\fP
افزودن دایرکتوری include به نام \fIdir\fP به دستور کامپایل.
.TP
.B \-idirafter \fIdir\fP
افزودن دایرکتوری include به مسیر جستجوی دوم include برای کامپایل، پس از '\fB\-I\fP'.
.TP
.B \-D\fIdef\fP
افزودن تعریف \fIdef\fP به دستور کامپایل.
.TP
.B \-l\fIlib\fP
افزودن کتابخانه \fIlib\fP به دستور پیوند (link).
.TP
.B \-L\fIdir\fP
افزودن دایرکتوری کتابخانه \fIdir\fP به دستور پیوند.
.TP
.B \-M\fR,\fB \-\-depend
تولید فایل‌های وابستگی (\fB.d\fP) برای فایل‌های منبع C و C++.
.TP
.B \-pthread
افزودن \fB\-pthread\fP به دستور پیوند.
.TP
.B \-R\fIdir\fP
ارسال \fB\-R\fP\fIdir\fP به دستور پیوند.
.TP
.B \-Wl,\fIoption\fP
ارسال گزینه به پیونددهنده (linker) مانند \fB\-Wl,\-rpath=...\fP
.TP
.B \-W...
ارسال فلگ‌ها به کامپایلر مانند \fB\-Wa,\fP\fIoption\fP.
.TP
.B \-c\fR,\fB \-\-compile
کامپایل کردن بدون مرحله پیوند (link).
.TP
.B \-o \fIfile\fP\fR,\fB \-\-output \fIfile\fP
نام فایل خروجی. پسوند پیش‌فرض "\fB.oct\fP" است (یا اگر \fB\-\-mex\fP مشخص شده باشد "\fB.mex\fP")، مگر آنکه یک فایل اجرایی مستقل پیوند داده شود.
.TP
.B \-g
فعال‌سازی گزینه اشکال‌زدایی برای تمامی کامپایلرها.
.TP
.B \-p \fIVAR\fP\fR,\fB \-\-print \fIVAR\fP
چاپ متغیر پیکربندی \fIVAR\fP. سه دسته از متغیرها وجود دارند:
.IP
متغیرهای پیکربندی Octave که کاربران می‌توانند آن‌ها را با متغیرهای محیطی بازنویسی کنند. این متغیرها در دستوراتی که توسط \%\fBmkoctfile\fP اجرا می‌شوند به کار می‌روند.

.RS
.Vb
    ALL_CFLAGS                  INCLUDEDIR
    ALL_CXXFLAGS                LAPACK_LIBS
    ALL_FFLAGS                  LDFLAGS
    ALL_LDFLAGS                 LD_STATIC_FLAG
    BLAS_LIBS                   LFLAGS
    CC                          LIBDIR
    CFLAGS                      LIBOCTAVE
    CPICFLAG                    LIBOCTINTERP
    CPPFLAGS                    OCTAVE_LINK_OPTS
    CXX                         OCTINCLUDEDIR
    CXXFLAGS                    OCTAVE_LIBS
    CXXLD                       OCTAVE_LINK_DEPS
    CXXPICFLAG                  OCTLIBDIR
    DL_LDFLAGS                  OCT_LINK_DEPS
    F77                         OCT_LINK_OPTS
    F77_INTEGER8_FLAG           RDYNAMIC_FLAG
    FFLAGS                      SPECIAL_MATH_LIB
    FPICFLAG                    XTRA_CFLAGS
    INCFLAGS                    XTRA_CXXFLAGS
.Ve
.RE
.IP
متغیرهای پیکربندی Octave مشابه بالا، اما در حال حاضر توسط \%\fBmkoctfile\fP استفاده نمی‌شوند.

.RS
.Vb
    AR
    DEPEND_EXTRA_SED_PATTERN
    DEPEND_FLAGS
    FFTW3F_LDFLAGS
    FFTW3F_LIBS
    FFTW3_LDFLAGS
    FFTW3_LIBS
    FFTW_LIBS
    FLIBS
    LIBS
    RANLIB
    READLINE_LIBS
.Ve
.RE
.IP
متغیرهای پیکربندی Octave که صرفاً با هدف اطلاع‌رسانی ارائه شده‌اند. به جز \%\fIOCTAVE_HOME\fP و \%\fIOCTAVE_EXEC_HOME\fP، کاربران نمی‌توانند این متغیرها را بازنویسی کنند.
.IP
اگر \%\fIOCTAVE_HOME\fP یا \%\fIOCTAVE_EXEC_HOME\fP در محیط سیستم تنظیم شده باشند، آن‌گاه سایر متغیرها بر این اساس تنظیم شده و \%\fIOCTAVE_HOME\fP یا \%\fIOCTAVE_EXEC_HOME\fP به جای مقدار اصلی دایرکتوری مشخص‌شده با گزینه‌های \%\-\-\fIprefix\fP یا \%\-\-\fIexec\-prefix\fP که هنگام پیکربندی Octave استفاده شده‌اند، جایگزین می‌شوند.

.RS
.Vb
    API_VERSION                 LOCALARCHLIBDIR
    ARCHLIBDIR                  LOCALFCNFILEDIR
    BINDIR                      LOCALOCTFILEDIR
    CANONICAL_HOST_TYPE         LOCALSTARTUPFILEDIR
    DATADIR                     LOCALVERARCHLIBDIR
    DATAROOTDIR                 LOCALVERFCNFILEDIR
    DEFAULT_PAGER               LOCALVEROCTFILEDIR
    EXEEXT                      MAN1DIR
    FCNFILEDIR                  MAN1EXT
    IMAGEDIR                    MANDIR
    INCLUDEDIR                  OCTAVE_EXEC_HOME
    INFODIR                     OCTAVE_HOME
    INFOFILE                    OCTDATADIR
    LIBDIR                      OCTDOCDIR
    LIBEXECDIR                  OCTFILEDIR
    LOCALAPIARCHLIBDIR          OCTFONTSDIR
    LOCALAPIFCNFILEDIR          OCTINCLUDEDIR
    LOCALAPIOCTFILEDIR          OCTLIBDIR
    LOCALAPIPKGDIR              STARTUPFILEDIR
                                VERSION
.Ve
.RE
.TP
.B \-\-link\-stand\-alone
پیوند دادن یک فایل اجرایی مستقل.
.TP
.B \-\-mex
ایجاد یک فایل MEX. تنظیم پسوند خروجی پیش‌فرض به "\fB.mex\fP". پیوند دادن به \%liboctmex به جای \%liboctinterp و \%liboctave.
.TP
.B \-s\fR,\fB \-\-strip
حذف نمادهای خطایابی و جدول نمادها (strip) از فایل خروجی.
.TP
.B \-n\fR,\fB \-\-dry-run\fR,\fB \-\-just-print
چاپ دستورات بدون اجرای آن‌ها.
.TP
.B \-v\fR,\fB \-\-verbose
نمایش دستورات هم‌زمان با اجرای آن‌ها.
.TP
.B FILE
کامپایل یا پیوند دادن FILE. انواع فایل‌های شناخته‌شده عبارتند از:

.RS
.Vb
   .c    C source
   .cc   C++ source
   .cp   C++ source
   .cpp  C++ source
   .CPP  C++ source
   .cxx  C++ source
   .c++  C++ source
   .C    C++ source
   .f    Fortran source (fixed form)
   .F    Fortran source (fixed form)
   .f90  Fortran source (free form)
   .F90  Fortran source (free form)
   .o    object file
   .a    library file
.Ve
.RE
.SH "نویسنده (AUTHOR)"
جان دابلیو. ایتون (John W. Eaton) و بسیاری دیگر. فهرست مشارکت‌کنندگان در پروژه Octave را می‌توان از داخل \%\fBoctave\fP با اجرای "\fB\%doc \%Acknowledgements\fP" مشاهده نمود. این فهرست به صورت آنلاین نیز در نشانی زیر در دسترس است:
.UR https://\:\%docs.octave.org/\:\%latest/\:\%Acknowledgements\:\%.html
.UE .
.SH "همچنین ببینید (SEE ALSO)"
.MR octave 1 .