From nobody Tue Jul 12 08:40:07 2022 X-Original-To: dev-commits-src-all@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 917D51CFADB0; Tue, 12 Jul 2022 08:40:07 +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 4LhvMW3l6vz3NCj; Tue, 12 Jul 2022 08:40:07 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1657615207; 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=TXAhJcJF3hZLrHODibY3oyRdm2nitQDnDTgZ1GqyUwg=; b=CEd0dDS5olMiFlZSuZDPF9MRhppj2aUBuSbAzn5B9Ic49DtSQ/Ufs5wY4jUs2NG7Nwiu0V 8S7LYgYdSqWwyY1e09RrxJCnLZx9RbaCfkyWr7/2n97CjvGrUDpyZQolvjWbzrwuUI2Si8 OMnHg9V4IUpq8wwC5Vs32q/ux6NuTvUi/ob5egkdcmlz6Qkj90ayzboKXzlpSRYsRDKF2/ uKTBBasal99346TuQOflV3jdSs1K7ax/IF8Crbnf1JN+IPQ3ExMkeNNGwzSdFkDR7ZtVbZ HBs8eMffq9yBDbgnj6Ep2jn8Sx0xNCxzBA1oomM4VCIz3anP1pKT2EcUqaIIWA== 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 4LhvMW2hbVzcnW; Tue, 12 Jul 2022 08:40:07 +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 26C8e7J9038660; Tue, 12 Jul 2022 08:40:07 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 26C8e7pc038657; Tue, 12 Jul 2022 08:40:07 GMT (envelope-from git) Date: Tue, 12 Jul 2022 08:40:07 GMT Message-Id: <202207120840.26C8e7pc038657@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-branches@FreeBSD.org From: Mateusz Piotrowski <0mp@FreeBSD.org> Subject: git: 444a6c982f75 - stable/13 - sesutil.8: Polish List-Id: Commit messages for all branches of the src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-src-all@freebsd.org X-BeenThere: dev-commits-src-all@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/stable/13 X-Git-Reftype: branch X-Git-Commit: 444a6c982f7589bf3fa4d3b2fbbc87d9ae699ae6 Auto-Submitted: auto-generated ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1657615207; 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=TXAhJcJF3hZLrHODibY3oyRdm2nitQDnDTgZ1GqyUwg=; b=Qui/yRlLaprk1Fvi2EFYhE8YyNq4vWEudhk8nTlq8AgGK8KTq5GtQupWtkyNQp9qLT51Q1 k4soeVSPNweAdDCR3XMsJBatpJH5WRzFtsICZmcZgfy3VldCEVUYWun4Dx0veb+2xOVTiR zlYErveEUGqqKRXbBcMRbPqCUftIRzEsXevf2yQb++d0y3tX2c2o18gg9zwJ9dV/W4V3JP 7+zj6hJRLt1T7aGal1sYEa5PmAMIZfZhyl0JwxyqwxpcGCWCmKInlP9mXnu6AOSEBV9joX mazPjpNT1LltKuiv75YaMwgGLPyB9vpnVuEwVyNDy76hA5Y/BijRSZaqUkH84g== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1657615207; a=rsa-sha256; cv=none; b=ZdvlPqU62xOUdGGVARyUo+h1RqOOZ3+K9/oOK9bx0GZo1n3CAywf6s8s+45UWKjDk5U0KB szJdPMW8P+3h13CgcuxbQPZXpPRD69dtqKTZ6fjNVIA/zVBjDK4Ns/B4JxQDAMW9dAw5Yr BcrW0jQitAbMXJMbTYFKft2mKHXEk/wb+vF70aBgPKga/myOUhn+g/iZ0nKzqqNC+FmYp7 QfVFoRPtEevUFbXVVoZ4lSXPmLeLM56JhrjV1zhXQd+QrVM8yB1gIj0LF/repyhUzPnifD aRjMPUaVGsEmnWOQGo3N7+KMKa/usbGqe54lneLusXAPBtNrWXdKlufsumRrYg== ARC-Authentication-Results: i=1; mx1.freebsd.org; none X-ThisMailContainsUnwantedMimeParts: N The branch stable/13 has been updated by 0mp (doc, ports committer): URL: https://cgit.FreeBSD.org/src/commit/?id=444a6c982f7589bf3fa4d3b2fbbc87d9ae699ae6 commit 444a6c982f7589bf3fa4d3b2fbbc87d9ae699ae6 Author: Mateusz Piotrowski <0mp@FreeBSD.org> AuthorDate: 2022-07-05 14:37:18 +0000 Commit: Mateusz Piotrowski <0mp@FreeBSD.org> CommitDate: 2022-07-12 08:39:48 +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 (cherry picked from commit 4e3dc91e4c0750cf39c0a1fefe7435b5b5532f67) --- 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