.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43)
.\"
.\" 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
.\" ========================================================================
.\"
.IX Title "GCORE 1"
.TH GCORE 1 2026-05-10 gdb-17.2 "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)"
gcore \- تولید یک فایل core از برنامه در حال اجرا
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
gcore [\-v | \-\-version] [\-h | \-\-help] [\-a] [\-o \fIprefix\fR] [\-d \fIdirectory\fR]
      \fIpid1\fR [\fIpid2\fR...\fIpidN\fR]
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
تولید core dump از یک یا چند برنامه در حال اجرا با شناسه‌های فرایند
\&\fIpid1\fR، \fIpid2\fR و غیره. یک فایل core تولید شده توسط \fBgcore\fR
معادل فایلی است که توسط هسته در زمان فروپاشی (crash) فرایند ایجاد می‌شود
(زمانی که از \f(CW\*(C`ulimit \-c\*(C'\fR برای تنظیم محدودیت مناسب core dump استفاده شده باشد).
با این حال، برعکس شرایط پس از فروپاشی، پس از اینکه \fBgcore\fR کار خود
را به پایان می‌رساند، برنامه بدون هیچ تغییری به اجرای خود ادامه می‌دهد.
.SH "گزینه‌ها (OPTIONS)"
.IX Header "OPTIONS"
.IP \fB\-a\fR 4
.IX Item "-a"
تخلیه تمامی نگاشت‌های حافظه (memory mappings). اثر واقعی این گزینه به سیستم‌عامل
بستگی دارد. در GNU/Linux، این گزینه \f(CW\*(C`use\-coredump\-filter\*(C'\fR را غیرفعال
و \f(CW\*(C`dump\-excluded\-mappings\*(C'\fR را فعال می‌کند.
.IP "\fB\-o\fR \fIprefix\fR" 4
.IX Item "-o prefix"
آرگومان اختیاری \fIprefix\fR پیشوندی را مشخص می‌کند که برای نام‌گذاری
فایل‌های core dump استفاده می‌شود. نام فایل به صورت \fIprefix.pid\fR ساخته می‌شود
که در آن \fIpid\fR شناسه فرایند برنامه در حال اجرایی است که توسط \fBgcore\fR
بررسی می‌شود. در صورت تعیین نشدن، مقدار پیش‌فرض \fIprefix\fR برابر با \fIcore\fR خواهد بود.
.IP "\fB\-d\fR \fIdirectory\fR" 4
.IX Item "-d directory"
استفاده از \fIdirectory\fR به عنوان دایرکتوری داده هنگام فراخوانی GDB برای اجرای
دستور gcore. این آرگومان اختیاری است.
.IP \fB\-\-help\fR 4
.IX Item "--help"
.PD 0
.IP \fB\-h\fR 4
.IX Item "-h"
.PD
فهرست کردن تمام گزینه‌ها همراه با توضیحات کوتاه.
.IP \fB\-\-version\fR 4
.IX Item "--version"
.PD 0
.IP \fB\-v\fR 4
.IX Item "-v"
.PD
چاپ اطلاعات نسخه و سپس خروج.
.SH "محیط (ENVIRONMENT)"
.IX Header "ENVIRONMENT"
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "SEE ALSO"
مستندات کامل GDB به عنوان یک راهنمای Texinfo نگهداری می‌شود.
اگر برنامه‌های \f(CW\*(C`info\*(C'\fR و \f(CW\*(C`gdb\*(C'\fR و مستندات Texinfo مربوط به GDB
به‌درستی روی سیستم شما نصب شده باشند، دستور
.PP
.Vb 1
\&        info gdb
.Ve
.PP
دسترسی شما به راهنمای کامل را فراهم خواهد کرد.
.PP
\&\fIUsing GDB: A Guide to the GNU Source-Level Debugger\fR،
نوشته Richard M. Stallman و Roland H. Pesch، ژوئیه ۱۹۹۱.
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
.IX Header "COPYRIGHT"
حق نشر (c) ۱۹۸۸\-۲۰۲۵ متعلق به Free Software Foundation, Inc.
.PP
اجازه کپی، توزیع و/یا تغییر این سند تحت شرایط مجوز مستندات آزاد گنو (GNU Free Documentation License)،
نسخه ۱.۳ یا هر نسخه جدیدتر منتشر شده توسط بنیاد نرم‌افزارهای آزاد اعطا می‌شود؛
همراه با بخش‌های تغییرناپذیر «Free Software» و «Free Software Needs Free Documentation»،
با متون روی جلد «A GNU Manual»، و متون پشت جلد به شرح بند (الف) زیر.
.PP
(الف) متن پشت جلد FSF عبارت است از: «You are free to copy and modify
this GNU Manual.  Buying copies from GNU Press supports the FSF in
developing GNU and promoting software freedom.»