'\" t
.\"     Title: copyfilerange
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-05-18
.\"    Manual: أوامر المستخدم
.\"    Source: util-linux 2.42.1
.\"  Language: English
.\"
.TH "COPYFILERANGE" "1" "2026-05-18" "util\-linux 2.42.1" "أوامر المستخدم"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "الاسم"
copyfilerange \- نسخ نطاق (أو نطاقات) من المصدر إلى ملف الوجهة
.SH "موجز"
.sp
\fBcopyfilerange\fP [خيارات] \fIsource\fP \fIdestination\fP \fIrange\fP.\|.\|.
.SH "الوصف"
.sp
ينسخ الأمر \fBcopyfilerange\fP نطاقات البايت من المصدر إلى ملف الوجهة. وهو عبارة عن غلاف حول استدعاء النظام ‎\fBcopy_file_range\fP(2)‎.
.sp
يمكن استخدام الأمر لإنشاء ملفات ذات فجوات غير مخصصة (ملفات متفرقة) و/أو بكتل مشتركة بين ملفات متعددة (reflinks).
.sp
كل نطاق \fIrange\fP يكون على الشكل التالي: \fIsource_offset\fP\fB:\fP\fIdestination_offset\fP\fB:\fP\fIlength\fP، مع التعبير عن كافة القيم بالبايت. إذا كان الطول \fIlength\fP هو 0، تُنسخ أكبر قدر ممكن من البيانات المتاحة. يمكن تقديم نطاقات متعددة.
.sp
عند حذف إزاحة واحدة أو كلتيهما، تستخدم العملية موقع الملف المستخدم آخراً، بدءاً من 0.
.SH "الخيارات"
.sp
\fB\-r\fP, \fB\-\-ranges\fP \fIfile\fP
.RS 4
يقرأ النطاق (أو النطاقات) المفصولة بأسطر جديدة من هذا الملف \fIfile\fP.
.RE
.sp
\fB\-v\fP، \fB\-\-verbose\fP
.RS 4
مخرجات مسهبة للنطاقات المنسوخة.
.RE
.sp
\fB\-h\fP، \fB\-\-help\fP
.RS 4
اعرض نص المساعدة ثم اخرج.
.RE
.sp
\fB\-V\fP، \fB\-\-version\fP
.RS 4
اعرض الإصدار واخرج.
.RE
.SH "حالة الخروج"
.sp
\fB0\fP
.RS 4
نجاح
.RE
.sp
\fB1\fP
.RS 4
فشل غير محدد
.RE
.SH "ملاحظات"
.sp
يحتوي استدعاء النظام ‎\fBcopy_file_range\fP(2)‎ على بعض المحاذير الجدية: يجب أن يستخدم ملف المصدر والوجهة نفس نوع نظام الملفات، وبعض أنظمة الملفات الافتراضية (مثل procfs) لن تعمل. سيستخدم ‎\fBcopy_file_range\fP(2)‎ روابط المراجع (reflinks) عندما يدعم نظام الملفات ذلك. لاستخدام روابط المراجع، يحتاج نطاق الملف في الغالب إلى المحاذاة مع حجم كتلة نظام الملفات في كل من ملف المصدر والوجهة.
.SH "المؤلفين"
.sp
.MTO "dick\(atmrns.nl" "Dick Marinus" ""
.SH "أمثلة"
.sp
.if n .RS 4
.nf
.fam C
copyfilerange original\-file reflink ::

copyfilerange original\-file first\-block ::4096

copyfilerange original\-file even\-blocks \-r <(seq 0 8192 40960|awk \*(Aq{print $1"::4096"}\*(Aq)

copyfilerange original\-file sparse\-file 0:1M:1

copyfilerange original\-file split\-first\-mb ::1M

copyfilerange original\-file split\-remainder 1M::

copyfilerange split\-first\-mb join ::

copyfilerange split\-remainder join :1M:
.fam
.fi
.if n .RE
.SH "انظر أيضاً"
.sp
\fBcopy_file_range\fP(2)
.SH "التبليغ عن الأخطاء"
.sp
لتقارير العِلل، استخدم \c
.URL "https://github.com/util\-linux/util\-linux/issues" "مُتتبع المشكلات" "."
.SH "التوفر"
.sp
الأمر \fBcopyfilerange\fP جزء من حزمة util\-linux التي يمكن تنزيلها من \c
.URL "https://www.kernel.org/pub/linux/utils/util\-linux/" "أرشيف نواة لينكس" "."