.\" -*- coding: UTF-8 -*- '\" t .\" Copyright 1993, Giorgio Ciucci .\" Copyright, the authors of the Linux man-pages project .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH ftok 3 "8 فبراير 2026" "صفحات دليل لينكس 6.18" .SH الاسم ftok \- تحويل اسم مسار ومعرف مشروع إلى مفتاح IPC من نوع System V .SH المكتبة مكتبة سي المعيارية (\fIlibc\fP،\ \fI\-lc\fP) .SH موجز .nf \fB#include \fP .fi .P \fBkey_t ftok(const char *\fP\fIpath\fP\fB, int \fP\fIproj_id\fP\fB);\fP .SH الوصف تستخدم الدالة \fBftok\fP() هوية الملف المسمى بالمسار \fIpath\fP (الذي يجب أن يشير إلى ملف موجود وقابل للوصول) وأقل 8 بتات أهمية من \fIproj_id\fP (التي يجب أن تكون غير صفرية) لتوليد مفتاح IPC من نوع \fIkey_t\fP لنظام System V، مناسب للاستخدام مع \fBmsgget\fP(2) أو \fBsemget\fP(2) أو \fBshmget\fP(2). .P تكون القيمة الناتجة نفسها لجميع أسماء المسارات التي تسمي نفس الملف، عند استخدام نفس قيمة \fIproj_id\fP. يجب أن تكون القيمة المعادة مختلفة عندما تختلف الملفات (الموجودة في نفس الوقت) أو معرفات المشاريع. .SH "قيمة الإرجاع" عند النجاح، تُعاد القيمة المولدة \fIkey_t\fP. عند الفشل، تُعاد \-1، مع \fIerrno\fP الذي يشير إلى الخطأ كما في استدعاء النظام \fBstat\fP(2). .SH السمات للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر \fBattributes\fP(7). .TS allbox; lbx lb lb l l l. الواجهة السمة القيمة T{ .na .nh \fBftok\fP() T} سلامة الخيوط MT\-Safe .TE .SH المعايير POSIX.1\-2008. .SH التاريخ POSIX.1\-2001. .SH ملاحظات في بعض الأنظمة القديمة، كان النموذج الأولي: .P .in +4n .EX \fBkey_t ftok(char *\fP\fIpath\fP\fB, char \fP\fIproj_id\fP\fB);\fP .EE .in .P اليوم، \fIproj_id\fP هو \fIint\fP، ولكن ما زالت تُستخدم 8 بتات فقط. الاستخدام النموذجي يحتوي على حرف ASCII \fIproj_id\fP، ولهذا يُقال إن السلوك غير محدد عندما يكون \fIproj_id\fP صفرًا. .P بالطبع، لا يمكن تقديم ضمان بأن \fIkey_t\fP الناتج فريد. عادةً، تجمع محاولة بأقصى جهد بين بايت \fIproj_id\fP المعطى، وأقل 16 بتًا من رقم inode، وأقل 8 بتات من رقم الجهاز في نتيجة 32 بت. قد تحدث تصادمات بسهولة، على سبيل المثال بين الملفات على \fI/dev/hda1\fP والملفات على \fI/dev/sda1\fP. .SH أمثلة انظر \fBsemget\fP(2). .SH "انظر أيضًا" \fBmsgget\fP(2), \fBsemget\fP(2), \fBshmget\fP(2), \fBstat\fP(2), \fBsysvipc\fP(7) .PP .SH ترجمة تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي . .PP هذه الترجمة هي وثيقة مجانية؛ راجع .UR https://www.gnu.org/licenses/gpl-3.0.html رخصة جنو العامة الإصدار 3 .UE أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات. .PP إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: .MT kde-l10n-ar@kde.org .ME .