From patchwork Fri Jan 5 15:02:48 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Romain Porte X-Patchwork-Id: 856083 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Authentication-Results: ozlabs.org; spf=none (mailfrom) smtp.mailfrom=vger.kernel.org (client-ip=209.132.180.67; helo=vger.kernel.org; envelope-from=linux-i2c-owner@vger.kernel.org; receiver=) Authentication-Results: ozlabs.org; dkim=pass (1024-bit key; unprotected) header.d=nokia.onmicrosoft.com header.i=@nokia.onmicrosoft.com header.b="XatDmqQg"; dkim-atps=neutral Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by ozlabs.org (Postfix) with ESMTP id 3zCnxB3Z5Jz9s7M for ; Sat, 6 Jan 2018 02:03:42 +1100 (AEDT) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1751514AbeAEPDl (ORCPT ); Fri, 5 Jan 2018 10:03:41 -0500 Received: from mail-he1eur01on0131.outbound.protection.outlook.com ([104.47.0.131]:45242 "EHLO EUR01-HE1-obe.outbound.protection.outlook.com" rhost-flags-OK-OK-OK-FAIL) by vger.kernel.org with ESMTP id S1751915AbeAEPDk (ORCPT ); Fri, 5 Jan 2018 10:03:40 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=nokia.onmicrosoft.com; s=selector1-nokia-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version; bh=rTztMo9KDBidRtyTMKLc2IJbrpZIqU4y9PEoSg3vzC4=; b=XatDmqQgYvGAb4ygPcLXvtg1T8+dIApqci6ou2fq0IeiWli4IlhKzbqVFdqmKSjfb+vLJghaNN79+lQKdNiJxxVBWUZ30xkv5Xl1nRL7Kw4Ekk/y7JCT8mjJ7nSQ8hAPOXJhXw+G+cWPAvpTI/Gt5i5BR3rbFiSX6uqINP4yOJg= Received: from AM5PR0701CA0007.eurprd07.prod.outlook.com (2603:10a6:203:51::17) by HE1PR0701MB2892.eurprd07.prod.outlook.com (2603:10a6:3:4b::13) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P256) id 15.20.386.4; Fri, 5 Jan 2018 15:03:37 +0000 Received: from AM5EUR03FT007.eop-EUR03.prod.protection.outlook.com (2a01:111:f400:7e08::205) by AM5PR0701CA0007.outlook.office365.com (2603:10a6:203:51::17) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384) id 15.20.407.1 via Frontend Transport; Fri, 5 Jan 2018 15:03:37 +0000 Received-SPF: Pass (protection.outlook.com: domain of nokia.com designates 131.228.2.240 as permitted sender) receiver=protection.outlook.com; client-ip=131.228.2.240; helo=mailrelay.int.nokia.com; Received: from mailrelay.int.nokia.com (131.228.2.240) by AM5EUR03FT007.mail.protection.outlook.com (10.152.16.145) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P384) id 15.20.345.12 via Frontend Transport; Fri, 5 Jan 2018 15:03:36 +0000 Received: from fihe3nok0734.emea.nsn-net.net (localhost [127.0.0.1]) by fihe3nok0734.emea.nsn-net.net (8.14.9/8.14.5) with ESMTP id w05F3HEC030158 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT); Fri, 5 Jan 2018 17:03:17 +0200 Received: from localhost.localdomain ([172.27.222.186]) by fihe3nok0734.emea.nsn-net.net (8.14.9/8.14.5) with ESMTP id w05F31wX029192; Fri, 5 Jan 2018 17:03:17 +0200 X-HPESVCS-Source-Ip: 172.27.222.186 From: Romain Porte To: CC: , Romain Porte Subject: [PATCH 3/3] Update man pages for risky_addr Date: Fri, 5 Jan 2018 16:02:48 +0100 Message-ID: <20180105150248.3170-4-romain.porte@nokia.com> X-Mailer: git-send-email 2.11.0 In-Reply-To: <20180105150248.3170-1-romain.porte@nokia.com> References: <20180105150248.3170-1-romain.porte@nokia.com> X-EOPAttributedMessage: 0 X-MS-Office365-Filtering-HT: Tenant X-Forefront-Antispam-Report: CIP:131.228.2.240; IPV:CAL; SCL:-1; CTRY:FI; EFV:NLI; SFV:NSPM; SFS:(10019020)(39860400002)(39380400002)(396003)(346002)(376002)(2980300002)(438002)(199004)(189003)(6916009)(22756006)(47776003)(15650500001)(305945005)(2950100002)(106002)(77096006)(6666003)(8676002)(68736007)(86362001)(81156014)(2906002)(97736004)(48376002)(1076002)(50466002)(8936002)(81166006)(49486002)(107886003)(26826003)(36756003)(76176011)(106466001)(4326008)(316002)(16586007)(2351001)(53936002)(50226002)(356003)(478600001)(59450400001)(5660300001)(54906003)(51416003); DIR:OUT; SFP:1102; SCL:1; SRVR:HE1PR0701MB2892; H:mailrelay.int.nokia.com; FPR:; SPF:Pass; PTR:InfoDomainNonexistent; A:1; MX:1; LANG:en; X-Microsoft-Exchange-Diagnostics: 1; AM5EUR03FT007; 1:1aUX6N7Mg26yOzeh5awV4mvzYuPx0JLFs50+sVQYxODFlRjbnclU/RVPJNy2SJHFq8/2ckD4y8tBjv3qeM6/73ce8YNruFV6wy9jIhaeZQ8csAfgdK/1fDATmWFwEsId MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: f50758b7-aad0-443a-d437-08d5544d7f86 X-Microsoft-Antispam: UriScan:; BCL:0; PCL:0; RULEID:(7020020)(5600026)(4604075)(4608076)(4534040)(4602075)(4627136)(201703031133081)(201702281549075)(2017052603307); SRVR:HE1PR0701MB2892; X-Microsoft-Exchange-Diagnostics: 1; HE1PR0701MB2892; 3:wYFzCm9YyNPvlWPh9t893VeiifA2Y9pWoFWG+NR3fIu1I2J/h63Ssn/vS/Cm9/ErEIuQpmbTcFGo31TU2o/tkG6KESC9mw07Dr8o0z0QFmRwvWrblniRJb8prOK+BcnXQYF6kHllcNRFdikPgKb/ZH/5wOdd0TzGTB8th2JtqX7ro+a46BoDWZwXSOH17nLR2XxAdQznUXFJkeGM4z0dQpUBobb5V5H0VUNDwz6X5NBFtZhnGmxVN+NPmMOMcrg1DCy5WbCTab0GE2MFEa9PMV5ZqRh56n4lfdIjmSiKPKqSRS/xCH1BFwKv4tSwS0UFSFPfpUVojtGqM+eCENNicpPTasTZtlKs/9n9bQOZEnc=; 25:NJMGwh069cwag/1oTEnfnU67QyyOw2lY3MbVQMVBytl4AU2XM9rQs/Z05jzo3pDPaCpOAZLxpHuH+raSg50wD7x9/OIiQe+k8IbT8rCNjPB/X6EsVnE2IuuZf9sjNU5pNnJNBQ6Csx2fKbZNwGlxAEzgt73giYMbtHfGjdI5XM+9v5X0l1LxUuyMWO8FOAk+FSVTVCoeBRDHhZA/RHHygautLTuj31zoLDxiI9F3rGQik11zuHRLByFNVGf7ayxV380WewRHUmk2MHDV9C3ZCpo/0E8s95F8B8YwFZuQs7heA3oeRNdIZUSn/7nRftOouGD/cTiTItkcXW1DK3RuAQ== X-MS-TrafficTypeDiagnostic: HE1PR0701MB2892: X-Microsoft-Exchange-Diagnostics: 1; HE1PR0701MB2892; 31:utLqq5cNN3LFWpBJ2OtlW3q93o6LbbgXTWDloWm/HRPJ7Y6Gjno5Iz+fsACV7GPkOQ4TmmTXXNuqd7izFSVLERHvKusVivNT1NdU4yvZnHngmc8pEL6s3J1CukeZRpPTJeV52D/bIJxkp4Z8cpyuJTAWIYW5G8UsACe+8DjGi0RYE1koLZmjTLe7GwxS6sco0CcnX+SE+3/DUIRfdMNZXj0zb28Ja4kk7yWrpNZ0Gmc=; 20:O7++5OvtionGdNuxeFiZROHU9PX9SODE4/cDROLre0bhH4QdM2fI6oEmImUXxWOqO46AChmKYaYnPUT4RS56QPdC+XdhS+Zg3c2COvjIzJ0EVSj4WlZ/jc1TKCXy2DV8uI7txpZ1Y5mv8weEecEFPXdwbtf+CF3T8VyOR8tnge/B2N9MXJ8jgLBQZAkhIIJ8tc5eiWI1BK/Muu+7qFVLhwODFpGVUUXbEVovpWIfIu0dvj0fVikTnkmqAtoAiIhnUOS4/get6K1fgWh6NvqW+gz2zL0mX6vZMJBMZ+sKfnuO5JfR2WJLX2BJTGkYAu4PB764ueTE6nPHbm7ZpBQHX2HgWqxjRkRxL6gni8oqe3vwQLTVzHhunPVSbxM8zrMad9dRYlzMkyJvENNLb6+fY7mBSDQUoowx1Uv1W7yQE3gfVm9f4FnuOvkW3KyNc1USefvCZCcvNZkZaW/cf2Db8QI6k0LBLprgj2SK1d4PCf9O/KhivKhyDqEbwypjg6s8kHxKc7tTRePbl9ve53ysrrQyii830Ny3ftWsLoy8lUk+mqSMTVhKdveINgfh8Fb/TtbCoSAoPWa+7ahqlePMKlNTrFq11+B+am2q5VaAr80= X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-Test: UriScan:(82608151540597); X-Exchange-Antispam-Report-CFA-Test: BCL:0; PCL:0; RULEID:(6040470)(2401047)(8121501046)(5005006)(3231023)(11241501184)(806099)(944501075)(93006095)(93004095)(10201501046)(3002001)(6055026)(6041268)(20161123560045)(20161123558120)(20161123562045)(201703131423095)(201702281528075)(20161123555045)(201703061421075)(201703061406153)(20161123564045)(6072148)(201708071742011); SRVR:HE1PR0701MB2892; BCL:0; PCL:0; RULEID:(100000803101)(100110400095); SRVR:HE1PR0701MB2892; X-Microsoft-Exchange-Diagnostics: 1; HE1PR0701MB2892; 4:i8uEVbCURhgXXvle0ndExYvVakPuvr0QuokBKa9k11cawk/GpGQxMSLLBP2bMnlSct7HdjwGzB0ZCsNrBfyRPQWGqc1agMAaniWTrq6xQWcf8BTe0fgHkq1VuOzZJG2QKT5OEarSx9rfhF1lvcPAbobBz0lirZyzosWWMXNx02dDb2sDCGa5A+tnxV3yiSFMznJI4ys0milnG4v1vxO1LXfj6YBy47UR4ybLf/OCyoaJe0OvxzeGi6hGq9ssYH59qNLUW4lP1p5A27NRHb8mKT/yWChP4sYJpqyhJECSKq23PCdMI2ETZa40UdRVbcVZ X-Forefront-PRVS: 05437568AA X-Microsoft-Exchange-Diagnostics: 1; HE1PR0701MB2892; 23:iF5gxJoqAws7DqNQGjsOuSRNnYXUgkiqPKjQqqa+sxqVezfuel3zu5MG0HcuSzKRxUROX09etNA/mb0qh22W7++kjnJPmyb6ztfbhwaOEDHA59IpiPzN5SfrBIcuHtOH8u1jSmZxEeIweIsWsxqnaBramdNFSQuQW5OFIJvOjrdkZL76lK53vSkiY5gW0hsom+AS/Q17D79yk9KSEaQ9Q0drLQMifwjm7emsiQqsB7duFR2rwcij9WXaPlhr6EkEWcpDs9CBk3ry42ApgxtvfT6JPuHMxm+JpZ6c69CkLshoRtdM8X4KoC5pl2gMEEhABbkry5VfZilrMn1OnJW89qtEoLCM3EOgrAMRV3cButUiRpVXE5b+AlxHuIa6x1SC+uitG+gYZosXMFKHWycKkIAl/+iDwrEB0HKgwo3ZAohKj4TEaRH4FFC6XWIZcdCfifn3OC30tG5l11m25DcP/OKGVyqegk3rF+VTkuadaLodKIQNq9YQikGnJ1Y5t+siqyM/WVGRSUmUBD3dvbkbLyFRrszpPkRvHn5HuWjLxcIe6yEf8l41ClrY5BC20HBBKywyaEtPqubN1tuNf2uGP4W3ZdKKGJ7m0yuYTAOE51JCbjstGtyot3MW91EBki5q6lZkq+GdtNWZH5PcrDNhZVxzUTbBYue8ztGufoMPuDV8f0nHLIc8mbVMxApTiYBZw55WVK9PR1P//EsW7lOeeT+0kkgfmjCE87TobFjKFjUpb9ht4hFYJcnTxWFvN32HlefFAnV574EPYxGkVqGqOaA6U5NaS0Qu0Z5OYGJSLCZXkXHA8+E66RMfeHJmIuqQ67TBaJbKoiebR/RHh7niLYp0pM8KGsBA+uEwwf+UJKzGWXuQ8I9F6U2a2P8efxQA+CUlxGL1Gy02yrQw1Fn9mfqkd0wjXswMyk5QgMa/G8V0BFbdOgpHsO19HsVb/QNRJfIoDH57WkDGdbrnoBfaNcRcxEa8nSEcrlEouSc6VYJpj7Pk6buitXD7g3wUYX85spTC+XS/TWrzJmzV9Wd1bU5l/0SMBpOM7W6UwM1V1MWJ7k3qjeR0/y9Ibrc6wH5GJmX/LWyZY+70XjTapyvIjvjSy6nDdbQmaZ+0ewMomR4= X-Microsoft-Antispam-Message-Info: 3dOMB8iiDE12W+/hbm2AypB9pkQAta4x/2bKv6kVLA8MXic+lIcfBgsB7nxg2+7AZqBmqdVNAIosl3Qs9FJ48QaFHclOHlz26bmz41yzwXb97qhULA+YctUVgeRahyCo X-Microsoft-Exchange-Diagnostics: 1; HE1PR0701MB2892; 6:NY0Tdl3i6gtj/CKqVu7YCdB5bhm36jz3deZP56m/Y7N54B1TdYgVig68VPmDYg5te7DPBNP4McvSDMP3jg2STM4OKn5dJayY/151j73kZ/Sfj7zE1anfqDkCtl0iAk3mGHvitJft5V7whdJxVYmd0Q23ftUFBn7Osjwos2hH6dfnmhAQ+H1SzwbZxK1TTReoo3YANrXcu6LUrgcdNFowR+GAzlk3gm+2grl54QIUEzj5vruryhqUcV+LlMwK6SouhX04KlHcyW0c4i+62abMS/9hE5B7FWR91RbqhGkR35k09aWjYiiV0XDLWVMp48WWlpxLDftoAvPiii09BdTsoMzRpvJwWovthNM34Rf50YBW/PxjvnDIusjNndOTJZMH5la6RhhhzGgfrieBzN759A==; 5:va1Z948mnTehSf9M5pPmA6Iai7YYRKSLIs3zVVyde+zm/VtbE81sKGV5jpCGEKzxveia2nCD6pUiElQEHQ0nRWs6d85Ma34E5sFIhHGflLa5tGQj20K81qWopxNlDh/SWwd2+OJvRjLRYi34bBimB/ozL/sqXoI7NuWeGZkv5QQ=; 24:E9LgOwu3J6fcm0Jbq4FfqJ5mDSakmRuFTQz7ieFPmXjIpqbjUcLPwdEsEf1Ojz7tKrQUu3CWzULBSTyIZRnfwfqiDooQvqag7UINR8zRP4U= SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-Microsoft-Exchange-Diagnostics: 1; HE1PR0701MB2892; 7:hLXe8AA4Q4rVOmufw06SK7i2fOxmB45dV9hTyOkUqn+CgfU+5r5LHoUZ+IJ9NOaQgRK5yG/41CkdqTB854kfcKv1UqRyLz207ISH08FoLL5EQXzCyfT5vZQvUQkLrWZZHWXc5Vp7Dr6bJfl3Uhfaly2Wr8YmuLhOaJka/cGHW17xcZ83Vmtvv7kXTeKYW30V2jwPouZme3liPz5TzzlAE2mVAYLy9MNClsPeHCVeGHI8tOZ47Nl1Onhvu1/rZOt7 X-OriginatorOrg: nokia.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 05 Jan 2018 15:03:36.9831 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: f50758b7-aad0-443a-d437-08d5544d7f86 X-MS-Exchange-CrossTenant-Id: 5d471751-9675-428d-917b-70f44f9630b0 X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=5d471751-9675-428d-917b-70f44f9630b0; Ip=[131.228.2.240]; Helo=[mailrelay.int.nokia.com] X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: HE1PR0701MB2892 Sender: linux-i2c-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-i2c@vger.kernel.org Describe the new -a option in man pages of modified tools. Signed-off-by: Romain Porte --- tools/i2cdump.8 | 4 ++++ tools/i2cget.8 | 4 ++++ tools/i2cset.8 | 4 ++++ tools/i2ctransfer.8 | 4 ++++ 4 files changed, 16 insertions(+) diff --git a/tools/i2cdump.8 b/tools/i2cdump.8 index fb7217e..22b12e3 100644 --- a/tools/i2cdump.8 +++ b/tools/i2cdump.8 @@ -7,6 +7,7 @@ i2cdump \- examine I2C registers .RB [ -f ] .RB [ "-r first-last" ] .RB [ -y ] +.RB [ -a ] .I i2cbus .I address .RI [ "mode " [ "bank " [ bankreg ]]] @@ -40,6 +41,9 @@ Disable interactive mode. By default, i2cdump will wait for a confirmation from the user before messing with the I2C bus. When this flag is used, it will perform the operation directly. This is mainly meant to be used in scripts. +.TP +.B -a +Allow using risky addresses between 0x78 and 0x7f. Not recommended. .PP At least two options must be provided to i2cdump. \fIi2cbus\fR indicates the number or name of the I2C bus to be scanned. This number should correspond to one diff --git a/tools/i2cget.8 b/tools/i2cget.8 index a1a1276..e3117c0 100644 --- a/tools/i2cget.8 +++ b/tools/i2cget.8 @@ -6,6 +6,7 @@ i2cget \- read from I2C/SMBus chip registers .B i2cget .RB [ -f ] .RB [ -y ] +.RB [ -a ] .I i2cbus .I chip-address .RI [ "data-address " [ mode ]] @@ -34,6 +35,9 @@ Disable interactive mode. By default, i2cget will wait for a confirmation from the user before messing with the I2C bus. When this flag is used, it will perform the operation directly. This is mainly meant to be used in scripts. Use with caution. +.TP +.B -a +Allow using risky addresses between 0x78 and 0x7f. Not recommended. .PP There are two required options to i2cget. \fIi2cbus\fR indicates the number or name of the I2C bus to be scanned. This number should correspond to one of diff --git a/tools/i2cset.8 b/tools/i2cset.8 index 19887bd..e3c53dc 100644 --- a/tools/i2cset.8 +++ b/tools/i2cset.8 @@ -8,6 +8,7 @@ i2cset \- set I2C registers .RB [ -y ] .RB [ "-m mask" ] .RB [ -r ] +.RB [ -a ] .I i2cbus .I chip-address .I data-address @@ -54,6 +55,9 @@ be the case, as neither I2C nor SMBus guarantees this. Read back the value right after writing it, and compare the result with the value written. This used to be the default behavior. The same limitations apply as those of option \fB-m\fR. +.TP +.B -a +Allow using risky addresses between 0x78 and 0x7f. Not recommended. .PP There are three required options to i2cset. \fIi2cbus\fR indicates the number or name of the I2C bus to be scanned. This number should correspond to one of diff --git a/tools/i2ctransfer.8 b/tools/i2ctransfer.8 index 0dd43c9..a0727d9 100644 --- a/tools/i2ctransfer.8 +++ b/tools/i2ctransfer.8 @@ -7,6 +7,7 @@ i2ctransfer \- send user-defined I2C messages in one transfer .RB [ -f ] .RB [ -y ] .RB [ -v ] +.RB [ -a ] .I i2cbus desc .RI [ data ] .RI [ desc @@ -61,6 +62,9 @@ It will print infos about all messages sent, i.e. not only for read messages but .TP .B -V Display the version and exit. +.TP +.B -a +Allow using risky addresses between 0x78 and 0x7f. Not recommended. .SH ARGUMENTS .PP