الاسم¶

نتلينك - اتصال بين النواة وفضاء المستخدم (AF_NETLINK)

موجز¶

#include <asm/types.h>
#include <sys/socket.h>
#include <linux/netlink.h>

netlink_socket = socket(AF_NETLINK, socket_type, netlink_family);

الوصف¶

يُستخدم نتلينك لنقل المعلومات بين النواة وعمليات فضاء المستخدم. يتكون من واجهة قياسية مبنية على المقابس لعمليات فضاء المستخدم وواجهة برمجة تطبيقات داخلية للنواة لوحدات النواة. واجهة النواة الداخلية غير موثقة في صفحة الدليل هذه. توجد أيضًا واجهة نتلينك قديمة عبر أجهزة حرف نتلينك؛ هذه الواجهة غير موثقة هنا، وهي متاحة فقط للتوافق مع الإصدارات السابقة.

نتلينك هي خدمة موجهة للبيانات. كلا من SOCK_RAW و SOCK_DGRAM قيمتان صالحتان لـ socket_type. ومع ذلك، لا يميز بروتوكول نتلينك بين مقابس البيانات والمقابس الخام.

يختار netlink_family وحدة النواة أو مجموعة نتلينك للتواصل معها. عائلات نتلينك المعينة حاليًا هي:

NETLINK_ROUTE

تستقبل تحديثات التوجيه والارتباط ويمكن استخدامها لتعديل جداول التوجيه (IPv4 و IPv6)، وعناوين IP، ومعلمات الارتباط، وإعدادات الجيران، وتخصصات الطابور، وفئات المرور، ومصنفات الحزم (انظر rtnetlink(7)).

NETLINK_W1 (لينكس 2.6.13 إلى لينكس 2.16.17)

رسائل من النظام الفرعي للسلك الواحد.

NETLINK_USERSOCK

محجوزة لبروتوكولات مقابس وضع المستخدم.

NETLINK_FIREWALL (حتى لينكس 3.4 شاملاً)

تنقل حزم IPv4 من netfilter إلى فضاء المستخدم. تُستخدم بواسطة وحدة النواة ip_queue. بعد فترة طويلة من الإعلان عن تقادمها (لصالح الميزة الأكثر تقدمًا nfnetlink_queue)، أُزيلت NETLINK_FIREWALL في لينكس 3.5.

NETLINK_SOCK_DIAG (منذ لينكس 3.3)

استعلام عن معلومات حول مقابس عائلات بروتوكولات مختلفة من النواة (انظر sock_diag(7)).

NETLINK_INET_DIAG (منذ لينكس 2.6.14)

مرادف قديم لـ NETLINK_SOCK_DIAG.

NETLINK_NFLOG (حتى لينكس 3.16 شاملاً)

ULOG لـ Netfilter/iptables.

NETLINK_XFRM

IPsec.

NETLINK_SELINUX (منذ لينكس 2.6.4)

إشعارات أحداث SELinux.

NETLINK_ISCSI (منذ لينكس 2.6.15)

Open-iSCSI.

NETLINK_AUDIT (منذ لينكس 2.6.6)

التدقيق.

NETLINK_FIB_LOOKUP (منذ لينكس 2.6.13)

الوصول إلى بحث FIB من مساحة المستخدم.

NETLINK_CONNECTOR (منذ لينكس 2.6.14)

موصل النواة. انظر Documentation/driver-api/connector.rst (أو /Documentation/connector/connector.* في لينكس 5.2 والإصدارات الأقدم) في شجرة مصدر نواة لينكس لمزيد من المعلومات.

NETLINK_NETFILTER (منذ لينكس 2.6.14)

النظام الفرعي Netfilter.

NETLINK_SCSITRANSPORT (منذ لينكس 2.6.19)

نقلات SCSI.

NETLINK_RDMA (منذ لينكس 3.0)

RDMA إنفينيباند.

NETLINK_IP6_FW (حتى لينكس 3.4 وما يشمل)

نقل حزم IPv6 من netfilter إلى مساحة المستخدم. يُستخدم بواسطة وحدة النواة ip6_queue.

NETLINK_DNRTMSG

رسائل توجيه DECnet.

NETLINK_KOBJECT_UEVENT (منذ لينكس 2.6.10)

رسائل النواة إلى مساحة المستخدم.

NETLINK_GENERIC (منذ لينكس 2.6.15)

عائلة netlink عامة لاستخدام netlink مبسط.

NETLINK_CRYPTO (منذ لينكس 3.2)

واجهة netlink لطلب معلومات حول الشفرات المسجلة مع واجهة برمجة تطبيقات التشفير للنواة وكذلك السماح بتكوين واجهة برمجة تطبيقات التشفير للنواة.

تتكون رسائل Netlink من تيار بايت مع رأس واحد أو متعدد nlmsghdr وحمولة مرتبطة. يجب الوصول إلى تيار البايت فقط باستخدام وحدات الماكرو القياسية NLMSG_*. انظر netlink(3) لمزيد من المعلومات.

في الرسائل متعددة الأجزاء (رؤوس nlmsghdr متعددة مع حمولة مرتبطة في تيار بايت واحد) يتم تعيين علامة NLM_F_MULTI للرأس الأول وجميع الرؤوس التالية، باستثناء الرأس الأخير الذي له النوع NLMSG_DONE.

بعد كل nlmsghdr تتبع الحمولة.

struct nlmsghdr {


    __u32 nlmsg_len;    /* Size of message including header */


    __u16 nlmsg_type;   /* Type of message content */


    __u16 nlmsg_flags;  /* Additional flags */


    __u32 nlmsg_seq;    /* Sequence number */


    __u32 nlmsg_pid;    /* Sender port ID */
};

يمكن أن يكون nlmsg_type أحد أنواع الرسائل القياسية: رسالة NLMSG_NOOP يجب تجاهلها، رسالة NLMSG_ERROR تشير إلى خطأ وتحتوي الحمولة على بنية nlmsgerr، رسالة NLMSG_DONE تنهي رسالة متعددة الأجزاء. تُلحق رسائل الخطأ بالطلب الأصلي، ما لم يطلب المستخدم تقييد رسالة الخطأ، وتُحصل على بيانات خطأ إضافية إذا طُلب ذلك.

struct nlmsgerr {


    int error;        /* Negative errno or 0 for acknowledgements */


    struct nlmsghdr msg;  /* Message header that caused the error */


    /*


     * followed by the message contents


     * unless NETLINK_CAP_ACK was set


     * or the ACK indicates success (error == 0).


     * For example Generic Netlink message with attributes.


     * message size is aligned with NLMSG_ALIGN()


     */


    /*


     * followed by TLVs defined in enum nlmsgerr_attrs


     * if NETLINK_EXT_ACK was set


     */
};

عادةً ما تحدد عائلة netlink أنواع رسائل إضافية، راجع صفحات الدليل المناسبة لذلك، على سبيل المثال، rtnetlink(7) لـ NETLINK_ROUTE.

لاحظ أن NLM_F_ATOMIC يتطلب صلاحية CAP_NET_ADMIN أو UID فعال بقيمة 0.

يُستخدم nlmsg_seq وnlmsg_pid لتتبع الرسائل. يُظهر nlmsg_pid أصل الرسالة. لاحظ عدم وجود علاقة 1:1 بين nlmsg_pid ومعرف العملية (PID) إذا نشأت الرسالة من مقبس netlink. راجع قسم ADDRESS FORMATS لمزيد من المعلومات.

كلا nlmsg_seq وnlmsg_pid غير شفافين لنواة netlink.

Netlink ليس بروتوكولًا موثوقًا. يبذل قصارى جهده لتوصيل رسالة إلى وجهتها (وجهاتها)، لكنه قد يُسقط الرسائل عند حدوث حالة نفاد الذاكرة أو خطأ آخر. للنقل الموثوق، يمكن للمُرسِل طلب إقرار من المُستقبِل بتعيين العلم NLM_F_ACK. الإقرار هو حزمة NLMSG_ERROR مع تعيين حقل الخطأ إلى 0. يجب على التطبيق توليد إقرارات للرسائل المستلمة بنفسه. تحاول النواة إرسال رسالة NLMSG_ERROR لكل حزمة فاشلة. يجب على عملية المستخدم اتباع هذا الاصطلاح أيضًا.

ومع ذلك، فإن الإرسالات الموثوقة من النواة إلى المستخدم مستحيلة في أي حال. لا تستطيع النواة إرسال رسالة netlink إذا كان مخزن المقبس ممتلئًا: سيتم إسقاط الرسالة ولن يكون للنواة وعملية مساحة المستخدم نفس الرؤية لحالة النواة. يقع على عاتق التطبيق اكتشاف متى يحدث هذا (عبر خطأ ENOBUFS الذي يُرجعه recvmsg(2)) وإعادة المزامنة.

struct sockaddr_nl {


    sa_family_t     nl_family;  /* AF_NETLINK */


    unsigned short  nl_pad;     /* Zero */


    pid_t           nl_pid;     /* Port ID */


    __u32           nl_groups;  /* Multicast groups mask */
};

الإصدارات¶

ظهرت واجهة المقبس لـ netlink لأول مرة في لينكس 2.2.

دعم لينكس 2.0 واجهة netlink بدائية قائمة على الجهاز (والتي لا تزال متاحة كخيار توافق). لا تُوصف هذه الواجهة القديمة هنا.

ملاحظات¶

غالبًا ما يكون استخدام netlink عبر libnetlink أو libnl أفضل من استخدام واجهة النواة منخفضة المستوى.

العلل¶

صفحة الدليل هذه غير كاملة.

أمثلة¶

المثال التالي ينشئ مقبس netlink من نوع NETLINK_ROUTE سيستمع إلى مجموعات البث المتعدد RTMGRP_LINK (أحداث إنشاء/حذف/تشغيل/إيقاف واجهة الشبكة) وRTMGRP_IPV4_IFADDR (أحداث إضافة/حذف عناوين IPv4).

struct sockaddr_nl sa;
memset(&sa, 0, sizeof(sa));
sa.nl_family = AF_NETLINK;
sa.nl_groups = RTMGRP_LINK | RTMGRP_IPV4_IFADDR;
fd = socket(AF_NETLINK, SOCK_RAW, NETLINK_ROUTE);
bind(fd, (struct sockaddr *) &sa, sizeof(sa));

المثال التالي يوضح كيفية إرسال رسالة netlink إلى النواة (pid 0). لاحظ أن التطبيق يجب أن يعتني بأرقام تسلسل الرسائل لتتبع الإقرارات بشكل موثوق.

struct nlmsghdr *nh;    /* The nlmsghdr with payload to send */
struct sockaddr_nl sa;
struct iovec iov = { nh, nh->nlmsg_len };
struct msghdr msg;
msg = { &sa, sizeof(sa), &iov, 1, NULL, 0, 0 };
memset(&sa, 0, sizeof(sa));
sa.nl_family = AF_NETLINK;
nh->nlmsg_pid = 0;
nh->nlmsg_seq = ++sequence_number;
/* Request an ack from kernel by setting NLM_F_ACK */
nh->nlmsg_flags |= NLM_F_ACK;
sendmsg(fd, &msg, 0);

والمثال الأخير يتعلق بقراءة رسالة netlink.

int size;
/* 8192 to avoid message truncation on platforms with


   page size > 4096 */
struct nlmsghdr buf[8192/sizeof(struct nlmsghdr)];
struct iovec iov = { buf, sizeof(buf) };
struct sockaddr_nl sa;
struct msghdr msg;
struct nlmsghdr *nh;
msg = { &sa, sizeof(sa), &iov, 1, NULL, 0, 0 };
size = recvmsg(fd, &msg, 0);
for (nh = (struct nlmsghdr *) buf; NLMSG_OK (nh, size);


     nh = NLMSG_NEXT (nh, size)) {


    /* The end of multipart message */


    if (nh->nlmsg_type == NLMSG_DONE)


        return;


    if (nh->nlmsg_type == NLMSG_ERROR)


        /* Do some error handling */


    ...


    /* Continue with parsing payload */


    ...
}

انظر أيضًا¶

cmsg(3), netlink(3), capabilities(7), rtnetlink(7), sock_diag(7)

معلومات حول libnetlink

معلومات حول libnl

RFC 3549 "Linux Netlink as an IP Services Protocol"

ترجمة¶

تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي <zayed.alsaidi@gmail.com>

هذه الترجمة هي وثيقة مجانية؛ راجع رخصة جنو العامة الإصدار 3 أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: kde-l10n-ar@kde.org.