From patchwork Mon Nov 20 21:02:17 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Sven Eckelmann X-Patchwork-Id: 17141 X-Patchwork-Delegate: sven@narfation.org Return-Path: X-Original-To: patchwork@open-mesh.org Delivered-To: patchwork@open-mesh.org Received: from open-mesh.org (localhost [IPv6:::1]) by open-mesh.org (Postfix) with ESMTP id 10B6D82B53; Mon, 20 Nov 2017 22:02:33 +0100 (CET) Authentication-Results: open-mesh.org; dkim=fail reason="signature verification failed" (1024-bit key; unprotected) header.d=narfation.org header.i=@narfation.org header.b="inY5pcXh"; dkim-atps=neutral Received-SPF: Pass (mailfrom) identity=mailfrom; client-ip=2001:4d88:2000:7::2; helo=v3-1039.vlinux.de; envelope-from=sven@narfation.org; receiver= Received: from v3-1039.vlinux.de (narfation.org [IPv6:2001:4d88:2000:7::2]) by open-mesh.org (Postfix) with ESMTPS id AEC9C8029D for ; Mon, 20 Nov 2017 22:02:21 +0100 (CET) Received: from sven-desktop.home.narfation.org (p200300C593C2BCF90000000000004065.dip0.t-ipconnect.de [IPv6:2003:c5:93c2:bcf9::4065]) by v3-1039.vlinux.de (Postfix) with ESMTPSA id 7B20D110114; Mon, 20 Nov 2017 22:02:21 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=narfation.org; s=20121; t=1511211741; bh=E/12Eyv8KwQ6rzWhhyUW5LofTyt0rc/kqpIXSeY/+KQ=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=inY5pcXhGTgiqYaRB6sXy8wBl6psqlO6mkLpSrgHvzqEa5Bakpey0T5/O8R7al/ZT vEOxOEK1oJePBfmIrRAWgmgU9XAcZkFcaCdM58YzXkesdmHoI6swlZJ3OpptM6JO1W /wx/ruPgKLmTRuCyRJx8ZUQDavZ0AWy/hCnWmno0= From: Sven Eckelmann To: b.a.t.m.a.n@lists.open-mesh.org Date: Mon, 20 Nov 2017 22:02:17 +0100 Message-Id: <20171120210217.8941-4-sven@narfation.org> X-Mailer: git-send-email 2.11.0 In-Reply-To: <20171120210217.8941-1-sven@narfation.org> References: <20171120210217.8941-1-sven@narfation.org> Subject: [B.A.T.M.A.N.] [PATCH 3/3] batman-adv: Convert README to reStructuredText X-BeenThere: b.a.t.m.a.n@lists.open-mesh.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: The list for a Better Approach To Mobile Ad-hoc Networking List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Reply-To: The list for a Better Approach To Mobile Ad-hoc Networking Errors-To: b.a.t.m.a.n-bounces@lists.open-mesh.org Sender: "B.A.T.M.A.N" The current format of the file is not well defined. The reStructuredText format (as used by other batman-adv related files) has the benefit that it is similar easy to read and write. And it allows other tools to parse the content of the file and convert it in a sensible way to a different file format. Multiple git repository web-based management software also can directly render these files as properly formatted HTML output. Signed-off-by: Sven Eckelmann --- README.external | 51 ------------------------------------------ README.external.license | 2 -- README.external.rst | 59 +++++++++++++++++++++++++++++++++++++++++++++++++ 3 files changed, 59 insertions(+), 53 deletions(-) delete mode 100644 README.external delete mode 100644 README.external.license create mode 100644 README.external.rst diff --git a/README.external b/README.external deleted file mode 100644 index 03f08ad1..00000000 --- a/README.external +++ /dev/null @@ -1,51 +0,0 @@ -BATMAN-ADV external module --------------------------- - -The batman-adv module is shipped as part of the Linux kernel -and as external module. The external module allows to get -new features without upgrading to a newer kernel version -and to get batman-adv specific bugfixes for kernels that are -not supported anymore. It compiles against and should work -with Linux 3.2 - 4.14. Supporting older versions is not -planned, but it's probably easy to backport it. If you work on a -backport, feel free to contact us. :-) - -COMPILE -------- - -To compile against your currently installed kernel, just type: - -# make - -if you want to compile against some other kernel, use: - -# make KERNELPATH=/path/to/kernel - -if you want to install this module: - -# sudo make install - -CONFIGURATION -------------- - -The in-kernel module can be configured through -menuconfig. When compiling outside of the kernel tree, it is -necessary to configure it using the make options. Each -option can be set to to y (enabled), n (disabled) or m (build as -module). Available options and their possible values are -(default marked with an "*") - - * CONFIG_BATMAN_ADV_DEBUGFS=[y*|n] (B.A.T.M.A.N. debugfs entries) - * CONFIG_BATMAN_ADV_DEBUG=[y|n*] (B.A.T.M.A.N. debugging) - * CONFIG_BATMAN_ADV_BLA=[y*|n] (B.A.T.M.A.N. bridge loop avoidance) - * CONFIG_BATMAN_ADV_DAT=[y*|n] (B.A.T.M.A.N. Distributed ARP Table) - * CONFIG_BATMAN_ADV_MCAST=[y*|n] (B.A.T.M.A.N. multicast optimizations) - * CONFIG_BATMAN_ADV_NC=[y|n*] (B.A.T.M.A.N. Network Coding) - * CONFIG_BATMAN_ADV_BATMAN_V=[y|n*] (B.A.T.M.A.N. V routing algorithm) - -e.g., debugging can be enabled by - -# make CONFIG_BATMAN_ADV_DEBUG=y - -Keep in mind that all options must also be added to "make -install" call. diff --git a/README.external.license b/README.external.license deleted file mode 100644 index a55d70ee..00000000 --- a/README.external.license +++ /dev/null @@ -1,2 +0,0 @@ -SPDX-License-Identifier: GPL-2.0 -License-Filename: LICENSES/preferred/GPL-2.0 diff --git a/README.external.rst b/README.external.rst new file mode 100644 index 00000000..40a00452 --- /dev/null +++ b/README.external.rst @@ -0,0 +1,59 @@ +.. SPDX-License-Identifier: GPL-2.0 + +========================== +BATMAN-ADV external module +========================== + +Introduction +============ + +The batman-adv module is shipped as part of the Linux kernel +and as external module. The external module allows to get +new features without upgrading to a newer kernel version +and to get batman-adv specific bugfixes for kernels that are +not supported anymore. It compiles against and should work +with Linux 3.2 - 4.14. Supporting older versions is not +planned, but it's probably easy to backport it. If you work on a +backport, feel free to contact us. :-) + + +COMPILE +======= + +To compile against your currently installed kernel, just type:: + + # make + +if you want to compile against some other kernel, use:: + + # make KERNELPATH=/path/to/kernel + +if you want to install this module:: + + # sudo make install + + +CONFIGURATION +============= + +The in-kernel module can be configured through +menuconfig. When compiling outside of the kernel tree, it is +necessary to configure it using the make options. Each +option can be set to to y (enabled), n (disabled) or m (build as +module). Available options and their possible values are +(default marked with an "*") + + * ``CONFIG_BATMAN_ADV_DEBUGFS=[y*|n]`` (B.A.T.M.A.N. debugfs entries) + * ``CONFIG_BATMAN_ADV_DEBUG=[y|n*]`` (B.A.T.M.A.N. debugging) + * ``CONFIG_BATMAN_ADV_BLA=[y*|n]`` (B.A.T.M.A.N. bridge loop avoidance) + * ``CONFIG_BATMAN_ADV_DAT=[y*|n]`` (B.A.T.M.A.N. Distributed ARP Table) + * ``CONFIG_BATMAN_ADV_MCAST=[y*|n]`` (B.A.T.M.A.N. multicast optimizations) + * ``CONFIG_BATMAN_ADV_NC=[y|n*]`` (B.A.T.M.A.N. Network Coding) + * ``CONFIG_BATMAN_ADV_BATMAN_V=[y|n*]`` (B.A.T.M.A.N. V routing algorithm) + +e.g., debugging can be enabled by:: + + # make CONFIG_BATMAN_ADV_DEBUG=y + +Keep in mind that all options must also be added to ``make install`` +call.