Skip to contentSkip to conversation

packet.7: document PACKET_QDISC_BYPASS

PATCH In review Daniel Borkmann 2 participants 6 messages Dec 10, 2013 – Jan 28, 2014 3 messages not in the archive Man-pages: manual pages for Linux -- Sections 2, 3, 4, 5, and 7

lore
Share & tools
lore
#0 lore raw

PATCH 1/1 packet.7: document PACKET_QDISC_BYPASS

Add a comment about PACKET_QDISC_BYPASS' socket option to the kernel.

---
Michael, this patch is on top of Willem's resend for packet.7:
http://www.spinics.net/lists/linux-man/msg04576.html

Kernel part of this man page update:
https://git.kernel.org/cgit/linux/kernel/git/davem/net-next.git/commit/?id=d346a3fae3ff1d99f5d0c819bf86edf9094a26a1

Thanks!

 man7/packet.7 | 5 +++++
 1 file changed, 5 insertions(+)
man7/packet.7 +5 -0
index e0993d2..100f876 100644
@@ -426,6 +426,11 @@ creates a packet receive ring of variant
 .BR TPACKET_V1 .
 To create another variant, configure the desired variant by setting this
 integer option before creating the ring.
+.TP
+.BR PACKET_QDISC_BYPASS " (since Linux 3.14)"
+By default, packets sent through packet sockets pass through the kernel's
+qdisc (traffic control) layer. This can be bypassed by setting this integer
+option to one for usage scenarios similar to pktgen.
 
 .SS Ioctls
 .B SIOCGSTAMP
Signature · 6 lines
1.8.3.1

--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to [email protected]
More majordomo info at  http://vger.kernel.org/majordomo-info.html

A message that is not in the archive (sent off-list or not yet received): 1386689485-18833-1-git-send-email-dborkman-H+wXaHxf7aLQT0dZR+AlfA@public.gmane.org

#2 lore raw
Quoted 1 line · Daniel Borkmann

Add a comment about PACKET_QDISC_BYPASS' socket option to the kernel.

Daniel, could you ping me again when this goes into the mainline kernel?

Cheers,

Michael

Quoted 32 lines

---
Michael, this patch is on top of Willem's resend for packet.7:
http://www.spinics.net/lists/linux-man/msg04576.html

Kernel part of this man page update:
https://git.kernel.org/cgit/linux/kernel/git/davem/net-next.git/commit/?id=d346a3fae3ff1d99f5d0c819bf86edf9094a26a1

Thanks!

 man7/packet.7 | 5 +++++
 1 file changed, 5 insertions(+)
man7/packet.7 +5 -1
index e0993d2..100f876 100644
@@ -426,6 +426,11 @@ creates a packet receive ring of variant
 .BR TPACKET_V1 .
 To create another variant, configure the desired variant by setting this
 integer option before creating the ring.
+.TP
+.BR PACKET_QDISC_BYPASS " (since Linux 3.14)"
+By default, packets sent through packet sockets pass through the kernel's
+qdisc (traffic control) layer. This can be bypassed by setting this integer
+option to one for usage scenarios similar to pktgen.
 
 .SS Ioctls
 .B SIOCGSTAMP
--

1.8.3.1

Signature · 7 lines
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to [email protected]
More majordomo info at  http://vger.kernel.org/majordomo-info.html

A message that is not in the archive (sent off-list or not yet received): CAKgNAkiW5hnYZqUYQv_mWeGyVNgN+Edu5uViX2PxVwhrrGnOQg-JsoAwUIsXosN+BqQ9rBEUg@public.gmane.org

#4 lore raw
Quoted 4 lines · Michael Kerrisk (man-pages)
Quoted 1 line · Daniel Borkmann

Add a comment about PACKET_QDISC_BYPASS' socket option to the kernel.

Daniel, could you ping me again when this goes into the mainline kernel?

Sure, will do. It's sitting in net-next and will be pulled in with the upcoming merge window in ~ 1 week or so.

I can ping you again for the PACKET_QDISC_BYPASS sockopt.

Thanks,

Daniel

Quoted 32 lines

Cheers,

Michael

Quoted 27 lines

---
Michael, this patch is on top of Willem's resend for packet.7:
http://www.spinics.net/lists/linux-man/msg04576.html

Kernel part of this man page update:
https://git.kernel.org/cgit/linux/kernel/git/davem/net-next.git/commit/?id=d346a3fae3ff1d99f5d0c819bf86edf9094a26a1

Thanks!

  man7/packet.7 | 5 +++++
  1 file changed, 5 insertions(+)
man7/packet.7 +5 -0
index e0993d2..100f876 100644
@@ -426,6 +426,11 @@ creates a packet receive ring of variant
  .BR TPACKET_V1 .
  To create another variant, configure the desired variant by setting this
  integer option before creating the ring.
+.TP
+.BR PACKET_QDISC_BYPASS " (since Linux 3.14)"
+By default, packets sent through packet sockets pass through the kernel's
+qdisc (traffic control) layer. This can be bypassed by setting this integer
+option to one for usage scenarios similar to pktgen.
 
Quoted 8 lines
Quoted 5 lines
man7/packet.7 +0 -1
  .SS Ioctls
  .B SIOCGSTAMP
--

1.8.3.1

--
To unsubscribe from this list: send the line "unsubscribe linux-man" in the body of a message to [email protected] More majordomo info at http://vger.kernel.org/majordomo-info.html

#5 lore raw
In reply to a message not in the archive
Quoted 4 lines · Michael Kerrisk (man-pages)
Quoted 1 line · Daniel Borkmann

Add a comment about PACKET_QDISC_BYPASS' socket option to the kernel.

Daniel, could you ping me again when this goes into the mainline kernel?

Ping. ;)

Quoted 32 lines

Cheers,

Michael

Quoted 27 lines

---
Michael, this patch is on top of Willem's resend for packet.7:
http://www.spinics.net/lists/linux-man/msg04576.html

Kernel part of this man page update:
https://git.kernel.org/cgit/linux/kernel/git/davem/net-next.git/commit/?id=d346a3fae3ff1d99f5d0c819bf86edf9094a26a1

Thanks!

  man7/packet.7 | 5 +++++
  1 file changed, 5 insertions(+)
man7/packet.7 +5 -0
index e0993d2..100f876 100644
@@ -426,6 +426,11 @@ creates a packet receive ring of variant
  .BR TPACKET_V1 .
  To create another variant, configure the desired variant by setting this
  integer option before creating the ring.
+.TP
+.BR PACKET_QDISC_BYPASS " (since Linux 3.14)"
+By default, packets sent through packet sockets pass through the kernel's
+qdisc (traffic control) layer. This can be bypassed by setting this integer
+option to one for usage scenarios similar to pktgen.
 
Quoted 8 lines
Quoted 5 lines
man7/packet.7 +0 -1
  .SS Ioctls
  .B SIOCGSTAMP
--

1.8.3.1

--
To unsubscribe from this list: send the line "unsubscribe linux-man" in the body of a message to [email protected] More majordomo info at http://vger.kernel.org/majordomo-info.html

#6 lore raw
In reply to a message not in the archive

Daniel,

I've applied this patch. I have a question below.

Quoted 20 lines · Daniel Borkmann

Add a comment about PACKET_QDISC_BYPASS' socket option to the kernel.

---
Michael, this patch is on top of Willem's resend for packet.7:
http://www.spinics.net/lists/linux-man/msg04576.html

Kernel part of this man page update:
https://git.kernel.org/cgit/linux/kernel/git/davem/net-next.git/commit/?id=d346a3fae3ff1d99f5d0c819bf86edf9094a26a1

Thanks!

 man7/packet.7 | 5 +++++
 1 file changed, 5 insertions(+)
man7/packet.7 +0 -0
index e0993d2..100f876 100644

man7/packet.7 creates a packet receive ring of variant · line 433

Quoted 8 lines
man7/packet.7 +5 -0
@@ -426,6 +426,11 @@ creates a packet receive ring of variant
 .BR TPACKET_V1 .
 To create another variant, configure the desired variant by setting this
 integer option before creating the ring.
+.TP
+.BR PACKET_QDISC_BYPASS " (since Linux 3.14)"
+By default, packets sent through packet sockets pass through the kernel's
+qdisc (traffic control) layer. This can be bypassed by setting this integer
+option to one for usage scenarios similar to pktgen.

This last sentence is a little unclear. Would it be better as:

This can be bypassed by setting this integer
option to one; this is useful for usage scenarios similar to pktgen.

Or something like that. Also, can you elaborate a little on what pktgen is please.

Thanks,

Michael

Quoted 3 lines
man7/packet.7 +0 -0
 .SS Ioctls
 .B SIOCGSTAMP
 
Signature · 7 lines
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to [email protected]
More majordomo info at  http://vger.kernel.org/majordomo-info.html

A message that is not in the archive (sent off-list or not yet received): [email protected]

#8 lore raw
Quoted 36 lines · Michael Kerrisk (man-pages)

Daniel,

I've applied this patch. I have a question below.

Quoted 20 lines · Daniel Borkmann

Add a comment about PACKET_QDISC_BYPASS' socket option to the kernel.

---
Michael, this patch is on top of Willem's resend for packet.7:
http://www.spinics.net/lists/linux-man/msg04576.html

Kernel part of this man page update:
https://git.kernel.org/cgit/linux/kernel/git/davem/net-next.git/commit/?id=d346a3fae3ff1d99f5d0c819bf86edf9094a26a1

Thanks!

  man7/packet.7 | 5 +++++
  1 file changed, 5 insertions(+)
man7/packet.7 +0 -0
index e0993d2..100f876 100644

man7/packet.7 creates a packet receive ring of variant · line 433

Quoted 8 lines
man7/packet.7 +5 -0
@@ -426,6 +426,11 @@ creates a packet receive ring of variant
  .BR TPACKET_V1 .
  To create another variant, configure the desired variant by setting this
  integer option before creating the ring.
+.TP
+.BR PACKET_QDISC_BYPASS " (since Linux 3.14)"
+By default, packets sent through packet sockets pass through the kernel's
+qdisc (traffic control) layer. This can be bypassed by setting this integer
+option to one for usage scenarios similar to pktgen.

This last sentence is a little unclear. Would it be better as:

Quoted 2 lines

This can be bypassed by setting this integer
option to one; this is useful for usage scenarios similar to pktgen.

Yes, sounds good to me, thanks Michael.

Quoted 14 lines

Or something like that. Also, can you elaborate a little on what pktgen is please.

Thanks,

Michael

Quoted 3 lines
man7/packet.7 +0 -0
  .SS Ioctls
  .B SIOCGSTAMP
 

--
To unsubscribe from this list: send the line "unsubscribe linux-man" in the body of a message to [email protected] More majordomo info at http://vger.kernel.org/majordomo-info.html