€•e.Œsphinx.addnodes”Œdocument”“”)”}”(Œ rawsource”Œ”Œchildren”]”(Œ translations”Œ LanguagesNode”“”)”}”(hhh]”(hŒ pending_xref”“”)”}”(hhh]”Œdocutils.nodes”ŒText”“”ŒChinese (Simplified)”…””}”Œparent”hsbaŒ attributes”}”(Œids”]”Œclasses”]”Œnames”]”Œdupnames”]”Œbackrefs”]”Œ refdomain”Œstd”Œreftype”Œdoc”Œ reftarget”Œ2/translations/zh_CN/admin-guide/cgroup-v1/net_prio”Œmodname”NŒ classname”NŒ refexplicit”ˆuŒtagname”hhh ubh)”}”(hhh]”hŒChinese (Traditional)”…””}”hh2sbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ2/translations/zh_TW/admin-guide/cgroup-v1/net_prio”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒItalian”…””}”hhFsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ2/translations/it_IT/admin-guide/cgroup-v1/net_prio”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒJapanese”…””}”hhZsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ2/translations/ja_JP/admin-guide/cgroup-v1/net_prio”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒKorean”…””}”hhnsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ2/translations/ko_KR/admin-guide/cgroup-v1/net_prio”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒSpanish”…””}”hh‚sbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ2/translations/sp_SP/admin-guide/cgroup-v1/net_prio”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubeh}”(h]”h ]”h"]”h$]”h&]”Œcurrent_language”ŒEnglish”uh1h hhŒ _document”hŒsource”NŒline”NubhŒsection”“”)”}”(hhh]”(hŒtitle”“”)”}”(hŒNetwork priority cgroup”h]”hŒNetwork priority cgroup”…””}”(hh¨hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hh£hžhhŸŒL/var/lib/git/docbuild/linux/Documentation/admin-guide/cgroup-v1/net_prio.rst”h KubhŒ paragraph”“”)”}”(hŒ The Network priority cgroup provides an interface to allow an administrator to dynamically set the priority of network traffic generated by various applications”h]”hŒ The Network priority cgroup provides an interface to allow an administrator to dynamically set the priority of network traffic generated by various applications”…””}”(hh¹hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Khh£hžhubh¸)”}”(hŒ‘Nominally, an application would set the priority of its traffic via the SO_PRIORITY socket option. This however, is not always possible because:”h]”hŒ‘Nominally, an application would set the priority of its traffic via the SO_PRIORITY socket option. This however, is not always possible because:”…””}”(hhÇhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K hh£hžhubhŒenumerated_list”“”)”}”(hhh]”(hŒ list_item”“”)”}”(hŒ9The application may not have been coded to set this value”h]”h¸)”}”(hhÞh]”hŒ9The application may not have been coded to set this value”…””}”(hhàhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K hhÜubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhh×hžhhŸh¶h NubhÛ)”}”(hŒ}The priority of application traffic is often a site-specific administrative decision rather than an application defined one. ”h]”h¸)”}”(hŒ|The priority of application traffic is often a site-specific administrative decision rather than an application defined one.”h]”hŒ|The priority of application traffic is often a site-specific administrative decision rather than an application defined one.”…””}”(hh÷hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K hhóubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhh×hžhhŸh¶h Nubeh}”(h]”h ]”h"]”h$]”h&]”Œenumtype”Œarabic”Œprefix”hŒsuffix”Œ)”uh1hÕhh£hžhhŸh¶h K ubh¸)”}”(hŒÖThis cgroup allows an administrator to assign a process to a group which defines the priority of egress traffic on a given interface. Network priority groups can be created by first mounting the cgroup filesystem::”h]”hŒÕThis cgroup allows an administrator to assign a process to a group which defines the priority of egress traffic on a given interface. Network priority groups can be created by first mounting the cgroup filesystem:”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Khh£hžhubhŒ literal_block”“”)”}”(hŒ9# mount -t cgroup -onet_prio none /sys/fs/cgroup/net_prio”h]”hŒ9# mount -t cgroup -onet_prio none /sys/fs/cgroup/net_prio”…””}”hj&sbah}”(h]”h ]”h"]”h$]”h&]”Œ xml:space”Œpreserve”uh1j$hŸh¶h Khh£hžhubh¸)”}”(hŒèWith the above step, the initial group acting as the parent accounting group becomes visible at '/sys/fs/cgroup/net_prio'. This group includes all tasks in the system. '/sys/fs/cgroup/net_prio/tasks' lists the tasks in this cgroup.”h]”hŒðWith the above step, the initial group acting as the parent accounting group becomes visible at ‘/sys/fs/cgroup/net_prio’. This group includes all tasks in the system. ‘/sys/fs/cgroup/net_prio/tasks’ lists the tasks in this cgroup.”…””}”(hj6hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Khh£hžhubh¸)”}”(hŒCEach net_prio cgroup contains two files that are subsystem specific”h]”hŒCEach net_prio cgroup contains two files that are subsystem specific”…””}”(hjDhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Khh£hžhubhŒdefinition_list”“”)”}”(hhh]”(hŒdefinition_list_item”“”)”}”(hŒ«net_prio.prioidx This file is read-only, and is simply informative. It contains a unique integer value that the kernel uses as an internal representation of this cgroup. ”h]”(hŒterm”“”)”}”(hŒnet_prio.prioidx”h]”hŒnet_prio.prioidx”…””}”(hj_hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j]hŸh¶h KhjYubhŒ definition”“”)”}”(hhh]”h¸)”}”(hŒ™This file is read-only, and is simply informative. It contains a unique integer value that the kernel uses as an internal representation of this cgroup.”h]”hŒ™This file is read-only, and is simply informative. It contains a unique integer value that the kernel uses as an internal representation of this cgroup.”…””}”(hjrhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Khjoubah}”(h]”h ]”h"]”h$]”h&]”uh1jmhjYubeh}”(h]”h ]”h"]”h$]”h&]”uh1jWhŸh¶h KhjTubjX)”}”(hX¤net_prio.ifpriomap This file contains a map of the priorities assigned to traffic originating from processes in this group and egressing the system on various interfaces. It contains a list of tuples in the form . Contents of this file can be modified by echoing a string into the file using the same tuple format. For example:: echo "eth0 5" > /sys/fs/cgroups/net_prio/iscsi/net_prio.ifpriomap ”h]”(j^)”}”(hŒnet_prio.ifpriomap”h]”hŒnet_prio.ifpriomap”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j]hŸh¶h K(hjŒubjn)”}”(hhh]”(h¸)”}”(hXGThis file contains a map of the priorities assigned to traffic originating from processes in this group and egressing the system on various interfaces. It contains a list of tuples in the form . Contents of this file can be modified by echoing a string into the file using the same tuple format. For example::”h]”hXFThis file contains a map of the priorities assigned to traffic originating from processes in this group and egressing the system on various interfaces. It contains a list of tuples in the form . Contents of this file can be modified by echoing a string into the file using the same tuple format. For example:”…””}”(hj¡hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K"hjžubj%)”}”(hŒAecho "eth0 5" > /sys/fs/cgroups/net_prio/iscsi/net_prio.ifpriomap”h]”hŒAecho "eth0 5" > /sys/fs/cgroups/net_prio/iscsi/net_prio.ifpriomap”…””}”hj¯sbah}”(h]”h ]”h"]”h$]”h&]”j4j5uh1j$hŸh¶h K(hjžubeh}”(h]”h ]”h"]”h$]”h&]”uh1jmhjŒubeh}”(h]”h ]”h"]”h$]”h&]”uh1jWhŸh¶h K(hjThžhubeh}”(h]”h ]”h"]”h$]”h&]”uh1jRhh£hžhhŸh¶h Nubh¸)”}”(hX=This command would force any traffic originating from processes belonging to the iscsi net_prio cgroup and egressing on interface eth0 to have the priority of said traffic set to the value 5. The parent accounting group also has a writeable 'net_prio.ifpriomap' file that can be used to set a system default priority.”h]”hXAThis command would force any traffic originating from processes belonging to the iscsi net_prio cgroup and egressing on interface eth0 to have the priority of said traffic set to the value 5. The parent accounting group also has a writeable ‘net_prio.ifpriomap’ file that can be used to set a system default priority.”…””}”(hjÏhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K*hh£hžhubh¸)”}”(hŒ³Priorities are set immediately prior to queueing a frame to the device queueing discipline (qdisc) so priorities will be assigned prior to the hardware queue selection being made.”h]”hŒ³Priorities are set immediately prior to queueing a frame to the device queueing discipline (qdisc) so priorities will be assigned prior to the hardware queue selection being made.”…””}”(hjÝhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K0hh£hžhubh¸)”}”(hŒìOne usage for the net_prio cgroup is with mqprio qdisc allowing application traffic to be steered to hardware/driver based traffic classes. These mappings can then be managed by administrators or other networking protocols such as DCBX.”h]”hŒìOne usage for the net_prio cgroup is with mqprio qdisc allowing application traffic to be steered to hardware/driver based traffic classes. These mappings can then be managed by administrators or other networking protocols such as DCBX.”…””}”(hjëhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K4hh£hžhubh¸)”}”(hŒ:A new net_prio cgroup inherits the parent's configuration.”h]”hŒ