Patch Detail
get:
Show a patch.
patch:
Update a patch.
put:
Update a patch.
GET /api/patches/1146/?format=api
{ "id": 1146, "url": "http://patchwork.ozlabs.org/api/patches/1146/?format=api", "web_url": "http://patchwork.ozlabs.org/project/netdev/patch/48D9274A.407@hartkopp.net/", "project": { "id": 7, "url": "http://patchwork.ozlabs.org/api/projects/7/?format=api", "name": "Linux network development", "link_name": "netdev", "list_id": "netdev.vger.kernel.org", "list_email": "netdev@vger.kernel.org", "web_url": null, "scm_url": null, "webscm_url": null, "list_archive_url": "", "list_archive_url_format": "", "commit_url_format": "" }, "msgid": "<48D9274A.407@hartkopp.net>", "list_archive_url": null, "date": "2008-09-23T17:28:42", "name": ": can: Add documentation for virtual CAN driver usage", "commit_ref": null, "pull_url": null, "state": "accepted", "archived": true, "hash": "4108ba68177b062221c5148b8779893632eeef50", "submitter": { "id": 454, "url": "http://patchwork.ozlabs.org/api/people/454/?format=api", "name": "Oliver Hartkopp", "email": "oliver@hartkopp.net" }, "delegate": { "id": 34, "url": "http://patchwork.ozlabs.org/api/users/34/?format=api", "username": "davem", "first_name": "David", "last_name": "Miller", "email": "davem@davemloft.net" }, "mbox": "http://patchwork.ozlabs.org/project/netdev/patch/48D9274A.407@hartkopp.net/mbox/", "series": [], "comments": "http://patchwork.ozlabs.org/api/patches/1146/comments/", "check": "pending", "checks": "http://patchwork.ozlabs.org/api/patches/1146/checks/", "tags": {}, "related": [], "headers": { "Return-Path": "<netdev-owner@vger.kernel.org>", "X-Original-To": "patchwork-incoming@ozlabs.org", "Delivered-To": "patchwork-incoming@ozlabs.org", "Received": [ "from vger.kernel.org (vger.kernel.org [209.132.176.167])\n\tby ozlabs.org (Postfix) with ESMTP id 0FE7BDDEFC\n\tfor <patchwork-incoming@ozlabs.org>;\n\tWed, 24 Sep 2008 03:29:18 +1000 (EST)", "(majordomo@vger.kernel.org) by vger.kernel.org via listexpand\n\tid S1751700AbYIWR3N (ORCPT <rfc822;patchwork-incoming@ozlabs.org>);\n\tTue, 23 Sep 2008 13:29:13 -0400", "(majordomo@vger.kernel.org) by vger.kernel.org id S1751517AbYIWR3N\n\t(ORCPT <rfc822; netdev-outgoing>); Tue, 23 Sep 2008 13:29:13 -0400", "from mo-p00-ob.rzone.de ([81.169.146.162]:52598 \"EHLO\n\tmo-p00-ob.rzone.de\" rhost-flags-OK-OK-OK-OK) by vger.kernel.org\n\twith ESMTP id S1751388AbYIWR3M (ORCPT\n\t<rfc822;netdev@vger.kernel.org>); Tue, 23 Sep 2008 13:29:12 -0400", "from [192.168.11.10] (p5B22BBFE.dip.t-dialin.net [91.34.187.254])\n\tby post.webmailer.de (mrclete mo40) (RZmta 17.4)\n\twith ESMTP id L0466ck8NGBGQF ; Tue, 23 Sep 2008 19:28:41 +0200 (MEST)\n\t(envelope-from: <oliver@hartkopp.net>)" ], "X-RZG-CLASS-ID": "mo00", "X-RZG-AUTH": ":I2ANY0W6W/eA95XfH/xfO6gOxLxTty/udEMngcJ/VAKW226lDNJVyuYEIzI8Pb0x", "Message-ID": "<48D9274A.407@hartkopp.net>", "Date": "Tue, 23 Sep 2008 19:28:42 +0200", "From": "Oliver Hartkopp <oliver@hartkopp.net>", "User-Agent": "Mozilla-Thunderbird 2.0.0.16 (X11/20080724)", "MIME-Version": "1.0", "To": "Linux Netdev List <netdev@vger.kernel.org>,\n\tDavid Miller <davem@davemloft.net>", "CC": "Urs Thuermann <urs@isnogud.escape.de>", "Subject": "[PATCH]: can: Add documentation for virtual CAN driver usage", "Content-Type": "multipart/mixed;\n\tboundary=\"------------020809060703090006060500\"", "Sender": "netdev-owner@vger.kernel.org", "Precedence": "bulk", "List-ID": "<netdev.vger.kernel.org>", "X-Mailing-List": "netdev@vger.kernel.org" }, "content": "From: Oliver Hartkopp <oliver@hartkopp.net>\n\nThis patch adds a usage documentation for the virtual CAN driver (vcan).\n\nSigned-off-by: Oliver Hartkopp <oliver@hartkopp.net>\n---\n\nHello Dave,\n\nthe virtual CAN netdevices are created via the netlink interface since \nKerenel 2.6.24.\nThis patch adds some examples how to create and remove vcans via the \nip(8) tool.\nPlease consider for net-next-2.6\n\nThanks,\nOliver", "diff": "diff --git a/Documentation/networking/can.txt b/Documentation/networking/can.txt\nindex 297ba7b..2035bc4 100644\n--- a/Documentation/networking/can.txt\n+++ b/Documentation/networking/can.txt\n@@ -35,8 +35,9 @@ This file contains\n 6.1 general settings\n 6.2 local loopback of sent frames\n 6.3 CAN controller hardware filters\n- 6.4 currently supported CAN hardware\n- 6.5 todo\n+ 6.4 The virtual CAN driver (vcan)\n+ 6.5 currently supported CAN hardware\n+ 6.6 todo\n \n 7 Credits\n \n@@ -584,7 +585,42 @@ solution for a couple of reasons:\n @133MHz with four SJA1000 CAN controllers from 2002 under heavy bus\n load without any problems ...\n \n- 6.4 currently supported CAN hardware (September 2007)\n+ 6.4 The virtual CAN driver (vcan)\n+\n+ Similar to the network loopback devices, vcan offers a virtual local\n+ CAN interface. A full qualified address on CAN consists of\n+\n+ - a unique CAN Identifier (CAN ID)\n+ - the CAN bus this CAN ID is transmitted on (e.g. can0)\n+\n+ so in common use cases more than one virtual CAN interface is needed.\n+\n+ The virtual CAN interfaces allow the transmission and reception of CAN\n+ frames without real CAN controller hardware. Virtual CAN network\n+ devices are usually named 'vcanX', like vcan0 vcan1 vcan2 ...\n+ When compiled as a module the virtual CAN driver module is called vcan.ko\n+\n+ Since Linux Kernel version 2.6.24 the vcan driver supports the Kernel\n+ netlink interface to create vcan network devices. The creation and\n+ removal of vcan network devices can be managed with the ip(8) tool:\n+\n+ - Create a virtual CAN network interface:\n+ ip link add type vcan\n+\n+ - Create a virtual CAN network interface with a specific name 'vcan42':\n+ ip link add dev vcan42 type vcan\n+\n+ - Remove a (virtual CAN) network interface 'vcan42':\n+ ip link del vcan42\n+\n+ The tool 'vcan' from the SocketCAN SVN repository on BerliOS is obsolete.\n+\n+ Virtual CAN network device creation in older Kernels:\n+ In Linux Kernel versions < 2.6.24 the vcan driver creates 4 vcan\n+ netdevices at module load time by default. This value can be changed\n+ with the module parameter 'numdev'. E.g. 'modprobe vcan numdev=8'\n+\n+ 6.5 currently supported CAN hardware\n \n On the project website http://developer.berlios.de/projects/socketcan\n there are different drivers available:\n@@ -603,7 +639,7 @@ solution for a couple of reasons:\n \n Please check the Mailing Lists on the berlios OSS project website.\n \n- 6.5 todo (September 2007)\n+ 6.6 todo\n \n The configuration interface for CAN network drivers is still an open\n issue that has not been finalized in the socketcan project. Also the\n", "prefixes": [] }