From nobody Tue Jul 5 14:40:05 2022 X-Original-To: dev-commits-src-main@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 3C24C1CFDBF9; Tue, 5 Jul 2022 14:40:06 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4Lclh60DPxz3pYy; Tue, 5 Jul 2022 14:40:06 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1657032006; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=kouoPVMFQ9K46vHu1BpBcIA2KBdIEFVJtkUbUYUgM/E=; b=nuguNsdyHRkR0U3hnNQENoUHoYp97t+o8xCWFVc2chICvbDaVa7GEit/w1ZsxFS38sGfCu SVl7QVgombZoRx6y2+ENwSLe8D3Dpq5XOc3lsWRZ0L24QXQd+dTumOiW07HdBy4a1i9ccg MLLYTEkJK3jMk0ATXlU9lnnd0l5eSaFZgJtXCU4E7iSgmeT5MNg61iKN8B/Opqp7oBMGsz +BUbZGAW8GIZRvtPWQ9rj40QNkcO+H+3kWzJ8Mpo///gS1iUNzaMDFTgMshSbuqrll4JSK 8beLR6Ce6k/cY4kZP8t7TpXMNmVgKoJ4Amg+AyX94LEV7d/TEY/Ylvzz//00eQ== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id D56EE271F9; Tue, 5 Jul 2022 14:40:05 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 265Ee5uw031269; Tue, 5 Jul 2022 14:40:05 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 265Ee5am031267; Tue, 5 Jul 2022 14:40:05 GMT (envelope-from git) Date: Tue, 5 Jul 2022 14:40:05 GMT Message-Id: <202207051440.265Ee5am031267@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org From: Mateusz Piotrowski <0mp@FreeBSD.org> Subject: git: 4e3dc91e4c07 - main - sesutil.8: Polish List-Id: Commit messages for the main branch of the src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-main List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-src-main@freebsd.org X-BeenThere: dev-commits-src-main@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: 0mp X-Git-Repository: src X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 4e3dc91e4c0750cf39c0a1fefe7435b5b5532f67 Auto-Submitted: auto-generated ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1657032006; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=kouoPVMFQ9K46vHu1BpBcIA2KBdIEFVJtkUbUYUgM/E=; b=rHrcOqvafl1VsNBaQjHokWdE3G+86s2t9QcMaVtZSOiTgmSqZeYH641fjGLlfQaTsETHbI qKoI7Irl9mR7zrxlFCr2AKS1LSDEvHrAWaIknb2NBGYtsuuhK9CbxJtOcVVRW9QMOXutwE /ffMx6TBeqUaRuL9ied67lUWTaLbJVH3wz87MjqlfzFXrK+h0sAtJR6WPoMNkBzxi+bCmg qkKGVyXKjAHFb1Hb4ar/DctJ91KUAfCGZv4CuIG02tkzyrzjh3WgVJ1QrfWWazyPv8bpit d1T5bqbNeJwEofPTTXGf/G84oapjmsz3TY+8KnSvMWqBxUo2SbEyxIhXBN2PAQ== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1657032006; a=rsa-sha256; cv=none; b=lftxhN5X5WwOg6nI+zldO4Bf2gtL+c5/IoJ4xQ2TbpVs5OdXhduGUFoJRsIXrpRTQgc4sA 0Pu5Gc2tqd4acdJKo1ASYMV+dvqWD4A/wqNrarZmE6UaF30InNImqu3TsQon5/orDxOYZU i87F6eVNF2s/vgZnn+Jl5M7s+cp3u4TSKg50wU1gGl6LrV1ZsuaSI3G0J1xq/HbHpijmVJ GnatvQ45jOl+LBdrgZ34Q4wgzYY04JoPF02ncRri5JwMY09ZC+PiJRh3E7yIWzlsumVXsO 6g8+HLfoIZ1VBJYMiG4JuDaYCL2yumq7vAF93J8rDnSjer/R82eFY6vdfNoxEw== ARC-Authentication-Results: i=1; mx1.freebsd.org; none X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by 0mp (doc, ports committer): URL: https://cgit.FreeBSD.org/src/commit/?id=4e3dc91e4c0750cf39c0a1fefe7435b5b5532f67 commit 4e3dc91e4c0750cf39c0a1fefe7435b5b5532f67 Author: Mateusz Piotrowski <0mp@FreeBSD.org> AuthorDate: 2022-07-05 14:37:18 +0000 Commit: Mateusz Piotrowski <0mp@FreeBSD.org> CommitDate: 2022-07-05 14:39:01 +0000 sesutil.8: Polish - Use right mdoc macros - Fix synopsis. Some of the optional command modifiers were not optional after all. - Sort options MFC after: 1 week --- usr.sbin/sesutil/sesutil.8 | 64 +++++++++++++++++++++++++++++----------------- 1 file changed, 40 insertions(+), 24 deletions(-) diff --git a/usr.sbin/sesutil/sesutil.8 b/usr.sbin/sesutil/sesutil.8 index 101c93ae40ee..80f3686e0671 100644 --- a/usr.sbin/sesutil/sesutil.8 +++ b/usr.sbin/sesutil/sesutil.8 @@ -24,7 +24,7 @@ .\" .\" $FreeBSD$ .\" -.Dd December 12, 2019 +.Dd July 5, 2022 .Dt SESUTIL 8 .Os .Sh NAME @@ -34,13 +34,25 @@ .Nm .Cm fault .Op Fl u Ar /dev/sesN -.Aq Ar disk | Ar sesid | Li all -.Op on | off +.Ar disk Ns | Ns Cm all +.Cm on Ns | Ns Cm off +.Nm +.Cm fault +.Fl u Ar /dev/sesN +.Sm off +.Ar sesid +.Sm on +.Cm on Ns | Ns Cm off .Nm .Cm locate .Op Fl u Ar /dev/sesN -.Aq Ar disk | Ar sesid | Li all -.Op on | off +.Ar disk Ns | Ns Cm all +.Cm on Ns | Ns Cm off +.Nm +.Cm locate +.Fl u Ar /dev/sesN +.Ar sesid +.Cm on Ns | Ns Cm off .Nm .Cm map .Op Fl -libxo Ar options @@ -61,22 +73,16 @@ Services (SES) devices. .Pp List of supported commands: .Bl -tag -width indent -.It Fl -libxo -Generate output via -.Xr libxo 3 -in a selection of different human and machine readable formats. -See -.Xr xo_parse_args 3 -.It Cm fault Oo Fl u Ar /dev/sesN Oc Ao Ar disk | Li all Ac Op on | off +.It Cm fault Oo Fl u Ar /dev/sesN Oc Ar disk Ns | Ns Cm all Cm on Ns | Ns Cm off Change the state of the external fault LED associated with .Ar disk . .Ar disk can be the device name of the disk, like -.Cm da12 , +.Ql da12 , or -.Ql all . +.Cm all to indicate all disks attached to SES controllers. -.It Cm fault Fl u Ar /dev/sesN Ar sesid Op on | off +.It Cm fault Fl u Ar /dev/sesN Ar sesid Cm on Ns | Ns Cm off Change the state of the external fault LED associated with an element connected to the SES controller. .Ar sesid @@ -84,16 +90,16 @@ must be the element ID of a valid item attached to the controller. Use the .Cm map command to list the elements attached to a controller. -.It Cm locate Oo Fl u Ar /dev/sesN Oc Ao Ar disk | Li all Ac Op on | off +.It Cm locate Oo Fl u Ar /dev/sesN Oc Ar disk Ns | Ns Cm all Cm on Ns | Ns Cm off Change the state of the external locate LED associated with .Ar disk . .Ar disk can be the device name of the disk, like -.Cm da12 , +.Ql da12 , or -.Ql all . +.Cm all to indicate all disks attached to SES controllers. -.It Cm locate Fl u Ar /dev/sesN Ar sesid Op on | off +.It Cm locate Fl u Ar /dev/sesN Ar sesid Cm on Ns | Ns Cm off Change the state of the external locate LED associated with an element connected to the SES controller. .Ar sesid @@ -101,22 +107,32 @@ must be the element ID of a valid item attached to the controller. Use the .Cm map command to list the elements attached to a controller. -.It Cm show Op Fl u Ar /dev/sesN -Display user-friendly summary of specified +.It Cm map Oo Fl -libxo Ar options Oc Op Fl u Ar /dev/sesN +Display a map of all elements connected to the specified .Xr ses 4 controller. If no controller is specified, all controllers are mapped. -.It Cm map Op Fl u Ar /dev/sesN -Display a map of all elements connected to the specified +.It Cm show Oo Fl -libxo Ar options Oc Op Fl u Ar /dev/sesN +Display user-friendly summary of specified .Xr ses 4 controller. If no controller is specified, all controllers are mapped. -.It Cm status Op Fl u Ar /dev/sesN +.It Cm status Oo Fl -libxo Ar options Oc Op Fl u Ar /dev/sesN Display the status of the specified .Xr ses 4 controller. If no controller is specified, the status of each controller is returned. .El +.Pp +Common options: +.Bl -tag -width indent +.It Fl -libxo Ar options +Generate output via +.Xr libxo 3 +in a selection of different human and machine readable formats. +See +.Xr xo_parse_args 3 +.El .Sh EXAMPLES Turn off all locate LEDs: .Pp