.TH "CORE" "5" "مه ۲۰۲۵" "man-pages" "فایل‌های پیکربندی"
.SH "نام (NAME)"
core \- پرونده رونوشت هسته حافظه هنگام خرابی فرایند (Core Dump)
.SH "توضیحات (DESCRIPTION)"
رفتار پیش‌فرض برخی از سیگنال‌ها (مانند
.BR SIGSEGV ,
.BR SIGABRT
یا
.BR SIGFPE )
موجب خاتمه یافتن فرایند و ایجاد یک پرونده رونوشت حافظه
(\fIcore dump file\fR)
می‌شود؛ فایلی که حاوی تصویری از حافظه فرایند در لحظه خاتمه آن است.
این تصویر می‌تواند در یک اشکال‌زدا (مانند
.BR gdb (1))
برای بازرسی وضعیت متغیرها، پشته فراخوانی و ساختار برنامه در زمان وقوع خطا مورد استفاده قرار گیرد.
فهرست کامل سیگنال‌هایی که موجب تولید پرونده رونوشت می‌شوند در
.BR signal (7)
آمده است.
.PP
یک فرایند می‌تواند با تنظیم حد نرم منبع
.B RLIMIT_CORE
حداکثر اندازه مجاز فایل رونوشت حافظه را مشخص کند؛ برای جزئیات به
.BR getrlimit (2)
مراجعه نمایید.
.SS "شرایط عدم ایجاد پرونده رونوشت حافظه"
در شرایط زیر پرونده رونوشت تولید نمی‌شود:
.IP \[bu] 2
فرایند دسترسی نوشتن در دایرکتوری جاری را نداشته باشد، یا پرونده‌ای هم‌نام از قبل وجود داشته باشد که قابل نوشتن نباشد.
.IP \[bu] 2
حد منبع
.B RLIMIT_CORE
بر روی صفر تنظیم شده باشد.
.IP \[bu] 2
باینری برنامه دسترسی خواندن نداشته باشد یا برنامه دارای بیت‌های set-user-ID یا set-group-ID باشد و پیکربندی مناسب در sysctl تنظیم نشده باشد.
.IP \[bu] 2
فضای دیسک در سیستم فایل مربوطه پر شده باشد.
.SS "نام‌گذاری پرونده‌های رونوشت حافظه"
به طور پیش‌فرض، پرونده رونوشت با نام
.I core
یا
.I core.pid
در دایرکتوری کاری جاری فرایند ذخیره می‌شود. از هسته لینوکس ۲.۶ به بعد، الگوی نام‌گذاری پرونده‌ها از طریق فایل
.I /proc/sys/kernel/core_pattern
قابل کنترل و سفارشی‌سازی است. در این الگو کاراکترهای اسکیپ زیر پشتیبانی می‌شوند:
.TP
.B %%
یک نویسه تک درصد (%)
.TP
.B %p
شناسه فرایند (PID) مربوط به فرایند خاتمه‌یافته
.TP
.B %u
شناسه عددی کاربر واقعی (UID)
.TP
.B %g
شناسه عددی گروه واقعی (GID)
.TP
.B %s
شماره سیگنالی که موجب ایجاد رونوشت شده است
.TP
.B %t
زمان وقوع رویداد به صورت ثانیه‌های Epoch
.TP
.B %h
نام میزبان سیستم (hostname)
.TP
.B %e
نام فایل اجرایی برنامه (بدون مسیر دایرکتوری)
.TP
.B %E
مسیر کامل نام فایل اجرایی (که در آن اسلش‌ها با علامت ! جایگزین شده‌اند)
.SS "ارسال مستقیم رونوشت حافظه به برنامه (Piping)"
اگر نخستین کاراکتر در
.I /proc/sys/kernel/core_pattern
علامت لوله
.RB ( | )
باشد، داده‌های رونوشت حافظه به ورودی استاندارد (stdin) برنامه‌ای که در ادامه خط مشخص شده هدایت می‌شوند (مانند برنامه‌های جمع‌آوری خودکار خطا نظیر systemd-coredump).
.SS "فیلتر کردن نگاشت‌های حافظه"
از نسخه ۲.۶.۲۳ هسته لینوکس، فایل
.I /proc/[pid]/coredump_filter
به ازای هر فرایند مشخص می‌کند کدام نوع از نواحی حافظه (صفحات ناشناس خصوصی، صفحات ناشناس اشتراکی، نگاشت‌های مبتنی بر فایل و غیره) در فایل رونوشت گنجانده شوند.
.SH "همچنین ببینید (SEE ALSO)"
.BR gdb (1),
.BR getrlimit (2),
.BR prctl (2),
.BR sigaction (2),
.BR elf (5),
.BR proc (5),
.BR signal (7)