From patchwork Mon Jan 29 13:57:28 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Romain Porte X-Patchwork-Id: 867133 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="HRWaAmih"; dkim-atps=neutral Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by ozlabs.org (Postfix) with ESMTP id 3zVWLk3JWYz9s74 for ; Tue, 30 Jan 2018 00:58:22 +1100 (AEDT) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1751387AbeA2N6S (ORCPT ); Mon, 29 Jan 2018 08:58:18 -0500 Received: from mail-he1eur01on0101.outbound.protection.outlook.com ([104.47.0.101]:29206 "EHLO EUR01-HE1-obe.outbound.protection.outlook.com" rhost-flags-OK-OK-OK-FAIL) by vger.kernel.org with ESMTP id S1751547AbeA2N6P (ORCPT ); Mon, 29 Jan 2018 08:58:15 -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=+0HhZII+90auatHL6HfkC4J0wIiQPsoou9Kd/iOXqCM=; b=HRWaAmihjzNo2bE5nOddF2GQ14ymgbVBe9tVcD/nWXzdLLp5TP65fD4rtuyW9JEJ01Nbe+UZETfiwcg4nc5vIz4xlwYmmhv1Wn20rAHcptcDYOofKHQToEVdX+lxSVMEdZMPa529FE6h9nlqX6k/1Un1pnWPPG6vq4/jfj6gxIk= Received: from DB6PR07CA0019.eurprd07.prod.outlook.com (2603:10a6:6:2d::29) 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.464.6; Mon, 29 Jan 2018 13:58:12 +0000 Received: from VE1EUR03FT039.eop-EUR03.prod.protection.outlook.com (2a01:111:f400:7e09::208) by DB6PR07CA0019.outlook.office365.com (2603:10a6:6:2d::29) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384) id 15.20.464.6 via Frontend Transport; Mon, 29 Jan 2018 13:58:12 +0000 Received-SPF: Pass (protection.outlook.com: domain of nokia.com designates 131.228.2.241 as permitted sender) receiver=protection.outlook.com; client-ip=131.228.2.241; helo=mailrelay.int.nokia.com; Received: from mailrelay.int.nokia.com (131.228.2.241) by VE1EUR03FT039.mail.protection.outlook.com (10.152.19.196) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P384) id 15.20.444.13 via Frontend Transport; Mon, 29 Jan 2018 13:58:12 +0000 Received: from fihe3nok0735.emea.nsn-net.net (localhost [127.0.0.1]) by fihe3nok0735.emea.nsn-net.net (8.14.9/8.14.5) with ESMTP id w0TDvfaG014637 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT); Mon, 29 Jan 2018 15:57:41 +0200 Received: from localhost.localdomain ([172.27.203.39]) by fihe3nok0735.emea.nsn-net.net (8.14.9/8.14.5) with ESMTP id w0TDvdOW014590; Mon, 29 Jan 2018 15:57:40 +0200 X-HPESVCS-Source-Ip: 172.27.203.39 From: Romain Porte To: CC: , , , Romain Porte Subject: [PATCH v3 3/3] Update man pages for risky_addr Date: Mon, 29 Jan 2018 14:57:28 +0100 Message-ID: <20180129135728.2313-4-romain.porte@nokia.com> X-Mailer: git-send-email 2.11.0 In-Reply-To: <20180129135728.2313-1-romain.porte@nokia.com> References: <20180105150248.3170-1-romain.porte@nokia.com> <20180129135728.2313-1-romain.porte@nokia.com> X-EOPAttributedMessage: 0 X-MS-Office365-Filtering-HT: Tenant X-Forefront-Antispam-Report: CIP:131.228.2.241; IPV:CAL; SCL:-1; CTRY:FI; EFV:NLI; SFV:NSPM; SFS:(10019020)(396003)(39380400002)(39860400002)(376002)(346002)(2980300002)(438002)(199004)(189003)(68736007)(76176011)(51416003)(5660300001)(81156014)(8676002)(81166006)(106466001)(36756003)(305945005)(2351001)(1076002)(26826003)(86362001)(575784001)(49486002)(15650500001)(356003)(478600001)(6916009)(26005)(77096007)(53936002)(22756006)(47776003)(106002)(316002)(54906003)(59450400001)(4326008)(6666003)(336011)(2950100002)(2906002)(6346003)(97736004)(8936002)(50226002)(50466002)(16586007)(107886003)(48376002); 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; VE1EUR03FT039; 1:X+lcBB6th1FfcdK+fTvt3hwWDCun7gEC/S1KdOYAu6K+CId78F3oqCcU1fQwgEKuZCZJJMPu6URMEtAf6mxGR0CPMjP3V49FhJSRTonF1WDzGKSrL1eJFDRsKoqeLdC5 MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: d0412343-fc20-4e89-80f4-08d567205638 X-Microsoft-Antispam: UriScan:; BCL:0; PCL:0; RULEID:(7020095)(4652020)(5600026)(4604075)(4608076)(2017052603307); SRVR:HE1PR0701MB2892; X-Microsoft-Exchange-Diagnostics: 1; HE1PR0701MB2892; 3:VR6QYi2WH+t80E383CDfjJBW/AVkaTTqLKtFO+6SgmLXoM5J3vKio6v8n6VZb96C4hSJEcDoR60R+5waVOp7gkIUcc0tAgBjA8Ubl1RrGVikwfS+ksFw1GZoK28xlhvtIk+B2UbEsyKlcuHL9MxxECgkEur1PdZr9i2QS5jF+zJvxkIxxHV4WZtKrn6/hOpughsrjSi2X1+XYIiKetdwSF1wY7xaUMBylfu0h3o9QK2g0AN6wEQdV434+/EQz6/P+2DV5RxR65qvp/x7pab1bfAADbN5TyqAHTgrzR2uOcCgPNtFwtb4xA9TLJKAQPUMynI3BZvJen2r+7rSWc/vhmdISip8Bx0D9Wfs4kukgt4=; 25:X5niXcCn0dLgfFNVYpG+H1S7GeIkYEuCicIOVu5gmMjtLcwzlTvoIpzlqZj/rs+0oGHC/YsUHxsvf7q9YV0ddM/g8Vawy1Ru2C3FO69AyAsx9caGw8Grj28LJZPRNEk/ug5ZnvtogUxcHqTXZ4XCWAnXAhKC79ZSHmfLlsIpGZJPmdFqQqq0eSRWiqzkZ1Bz8QiRzNqRSD8DqSta62tdcuC6KwT/kTGi55lPzJyxtJaPoif9UTC3j0kpEOSmGiPJFjtc2Z1mCbDZncBEWvITPLIQUMQLxEBs0dxxox03YiaAB+Cnk2yqh2WOlVHAMwI8TkionGKiIKglnOXlQ0pPEQ== X-MS-TrafficTypeDiagnostic: HE1PR0701MB2892: X-Microsoft-Exchange-Diagnostics: 1; HE1PR0701MB2892; 31:UJiYQVnMFuHVoRdCdKRClDV7Cg76gaEPrHLNC7w2dKiOMPEcjjWXbdAOblh0Ne/6pQ1ckU62b1fKIW+y9cdkhOS0EXF456IbU2a+6pBhD7VsO1TZjbVH+fOttRc98YlSDhfzwicHMh5abTNxJh9OETLtx9Bp7Z18pXWoZk7Aqre7b2H00A5dkwK49kJury5p4R3Q/klq3tcwUqbmLLJ/eTLkRUIrGJipWXqnQrh177Q=; 20:quM8m/k0gB1UbGmZISw0cwRhttkM8MR9xba/d4fFRG4S71M9tMoA9WJbk4bvrBqtCiWPB6rSei+GptIJIfqsF5ZDrnCXsA9TW9iMLpDluUShthftGEcoISvJQKoqD3MFaQHw2bTGoMhNIeN3i2qUziWSTuQTVW8U9zezcRWBYBgxmm4rBN3Lh903xJ0DWG201sfXX96DJvN4Yfbu97hXhN+b0Txhv0etobwhaEpi2DYNSRHm1LaZv1AXshRvwLgkFrWMsnPLMXE/rfe2gZzI1pi4bdT1IsG9MB4PWnDjpFWtlFBT5iG/KfkF4+CwcYrqrs0ASbHgKhoemHOOubD9MOsM7ZTEwtu02hYV88IVOpW/vssz9jn0crTtSuvUHjfSPgxvlgzHU+okSTFpjxSa9yxttjIoPLNfMMtGbrv56mhiV6UFq9i+VPSasxP7vUnWRXLL/8GG2U3AWNBB38Sx0lP9PsoHeaMwxrIY+Q92lOVCRbhIAUqcOdzWbkH8GJEZhEDeXs+oVynRw3mIfmUqL0sHXUIz0jrnw4QUnbifvSM1SlrbooKkJzj7b2ohgGoUuAZe7Dd2pM352q9K1S8uHB5UxpR+SN2lVeHU6g5wvYU= X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-Test: UriScan:(82608151540597); X-Exchange-Antispam-Report-CFA-Test: BCL:0; PCL:0; RULEID:(6040501)(2401047)(8121501046)(5005006)(93006095)(93004095)(3002001)(3231101)(11241501184)(806099)(944501161)(10201501046)(6055026)(6041288)(201703131423095)(201702281528075)(20161123555045)(201703061421075)(201703061406153)(20161123564045)(20161123560045)(20161123558120)(20161123562045)(6072148)(201708071742011); SRVR:HE1PR0701MB2892; BCL:0; PCL:0; RULEID:; SRVR:HE1PR0701MB2892; X-Microsoft-Exchange-Diagnostics: 1; HE1PR0701MB2892; 4:1WaGSamH74eQ3wHcBQp8R8QhaDzx6idJETWKMAnXh3qybYHbZcyBfxTRKsS9bxMvxgTwm6FXEc5SZUEPfvyIRx1FXuZGTAc+cnrKqtNTHkCsmO2um+PlPEP1/ZOCh5rUa45velG9aLz4EsHoH5LVpUxdqGeNlkblppPmKRnIPd9TmpvEtIwsLY/IYQfK5Tkblh8kd7AiPimpOa42hOAlQs3ufL5BgRd/kGuCo9E1fq5AcJh7SNcyFu8X2k/sNfVz4KH1GAwpYNN13niErBjysh7OViL04TlOvLG2TS0NRZmgS3nk+r0XAcJQDina8hLY X-Forefront-PRVS: 0567A15835 X-Microsoft-Exchange-Diagnostics: 1; HE1PR0701MB2892; 23:2F6pXp9IwjAek4Q/Zs1YGvJilvPl1QvrGEV6YVWO8fWzNkc4r/F5ZsGyKwmYF8+MRb+9dnDuQouJ9m9iXjJaZhi2tMKloIQ4iRQDyUEe4FV667puSRpM1IhV3c6qFHrcjx6CmVHJmy62tTQRBkB9MjBZtyLKIAolryf6QsFEj/CmVCXRZ3C1ajtrcwSPqG02KMlOqj5tcLdNkDoUx3zk1vUO/TQ0m2f4RgaxKQE575XYQWMBIcaCijHnWopqoKXdb24t3Tvw3OYlZHf+2xqRFkQoVUZCA0IAK/+4YYkMdD8WFCNGtwbF+DgWofBxG8izGHfWZXy9JNX5HR87wnw0uGDZ76mkFcs2VqTATfkDDhcHoWmPYElyTfZcy7HFoZx/Z0Gz10cqHmuy1aYD36Dv4seGPgaJXzmfqWvv2gqFErdbBoE0Irj3SqrFW6y6crNd26wTmx6Jqt95WeacZOVzWBIhBDuayWw76yrhuXvrDFAgPiUwxjGItq/b2MIEfrMDaBoaKn2/zqXLMqLVqSw/FFelJAlNqXhtCGI2tiMHfG1H8pxuoUtQVP3c9xqTFioJ/C2npQypQrDhIy7rRFdkgy0+mNWklanLXgEkP+qjLorqVYLlG4IJ3jjyAY9OAEx/WU412P02lcurKcyvta4LI9MMDFk/v6y6R8sBNt1OfkaS26aE1N5yHstVp1gxkXLK6qoWijwEgwc7B9+C4vWUHEmZW2Ie0SiG4bTeAm0W7INo9GwasHr6vGQn/HChuGHgSfzB0Z2oeFv60WY2DGkS7NTrr4j8dhHLW1NLnPSl+AcYcKYvqA0z+9ZAP3zDy2Cr+U3nWLZF8nNl2FKhzAmP0FP05Wnrqnk6yhDTldNCa5+s7r+9C27TXYyVDkLjAepXyHacKYzlI7KB4T6knut5XC869M05HHhgKivVVXAC0g2otsb3HYqc9nUUy03uC7tqiaazd3dg26TSzSv0zpe8QyHegFHAlisSrxorqBIZgn0qd/6iXZNrszNOELLwMUJYoopgEj9wk22bj8cHTtA/Wi+l3MgIW8qx0EDbFuo9HgsBdW0PoY7FmnXKY0pKyY2lYPXvMYqrLE3f5uMor5PkSp3ifbOi311lEd7w2g5UWsLM4KogYaYRHpo9m6ogTq4G/nu+0D44MQxsfAvHZURYo5+UPcX55o7SBZSnMse45os= X-Microsoft-Antispam-Message-Info: x0mTlnyrzwcC0GlIMiN/yE5DyzyAmiun1lf4RKVmPIij4KpWJMCMUrMhy+KDEk60n7X2wCAqgOJSshO6HnBmAef1EIAGuaOYrMuJBI9AklaeiHLuc/Qy+oQdSpsevoZ2 X-Microsoft-Exchange-Diagnostics: 1; HE1PR0701MB2892; 6:4CdXgUUtK6+dRlbu/jVv5df6mfYjNFDHh1TBDKZPxBfxQ5qkHIrtlFZQQsrBLBFx8NKLSgRUpBVtZQQ4TnerOYrDzlr9Lk57MEt5JPFM9xTOpA2dan8GaYOTLSavUGLPJrlVCQhwYOLyfqm7OUqRdQltbXJjICT4ikz20Z47jm42QPybzKGQxjDAKd6sWo8d2gNNXEy/u0opmm+AtIxKZRUn7pEL6+SQwFTmfWrsqmkP+TrvCKowY0S3D04ySvw4nSgHIwvImOmdowTnmwNwhHr6gKTfVwpEE0TSCmf8C3OousTebUPVHco+3ZPa+1D4Ad3aBAez7cN+WXy6F0b/N82TKBHYftBOI8FTQpvrWFifh15UBa7XXKoEHYxooQOd81UrVo2sqFGXBQCDmz9mAg==; 5:/FLMChOFEgu7hXnfDhiBjrX0TAkhWSz+C+kh0vYskgn3dA1zkeqNw5eUdoaR5rYaYTqP3QteZejvQabwXDMg6fbPS/V6BDooDnoPKJXTVamU/atDjt8YW1mHouxgFFCbbCupwgQlUK3l5VZMs8TRtTR4kG4b0C8mPhVrnOtUmJg=; 24:+RcrMFSLaymG3wWr0xZPSHMA7fn6TpjNMErk0shiCQU8w5P3yM/aCxC1jYfFTdbSC2SIVs/U8e+tYEmqwNeazT8Ue1gaVe2z+CmeonixBOc= SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-Microsoft-Exchange-Diagnostics: 1; HE1PR0701MB2892; 7:MwQ9Z2FPdxisupVtktPsRMQN1AlUFn7S16lI6hJ2Xpi/yYxDdc5Li8W/t/3T0L9hvrMZC53y3P74tNn1yLY/MJBMJa9De6aIhGzuMdOBm2Ee1yCY3Z/vsq617+hKzY+xuqSvly4lVT7bY2SNxQ51m1tL1qYIUc2SyGJVmGhlaQ7blrgxHh7a3CuSQjqD9qfkgEEp9G2GUNnFKPTtUvtk2nq8t3xOAnS/5jcGvL0YH6ymBYdo9x8pXcjxjhKSx3tF X-OriginatorOrg: nokia.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 29 Jan 2018 13:58:12.3919 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: d0412343-fc20-4e89-80f4-08d567205638 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.241]; 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..1b98b64 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 0x00 - 0x02 and 0x78 - 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..26a0ea0 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 0x00 - 0x02 and 0x78 - 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..4faa061 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 0x00 - 0x02 and 0x78 - 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..cf8dae7 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 0x00 - 0x02 and 0x78 - 0x7f. Not recommended. .SH ARGUMENTS .PP