From nobody Tue Jul 12 08:40:09 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 7EC301CFAD74; Tue, 12 Jul 2022 08:40:09 +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 4LhvMY3CDNz3N9h; Tue, 12 Jul 2022 08:40:09 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1657615209; 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=j/Pgfs3vWHTnVqcBQqmVagXPKmZt9bhQGDjUx9GbnDk=; b=f08dpXFxz74uoB/D6ZyreGfbUHz5hItTWPzIVy2QSjBT3xwp2G321jLHYTqLiPFmks+dT8 QtSl7xQvndxcwDqCMDqAWYlaoTo3TUhHQRlXJ125sqjDlMBgQb1eaU7+IftIwo1HDF4Urz 04hWkj2RRXYIiy3GDWOwqOvsYtY7yRESt/JzMjuA9xFr4aVBUcekqfORx9kjT5HLhxwrHO +TlnqkzD+ZsswdBwteJaJxqDMdN8UvGUlg4E1Jrt+xcx1P7JKtHJkpg/WazspXUKCZB/J6 zCUT09P1d8bjCZPJlCkt8L9NFwLqcJVocvW+0sc/wMFcP29ZeYfq7V5NlTJHag== 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 4LhvMY2KM3zd9Q; Tue, 12 Jul 2022 08:40:09 +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 26C8e91P039112; Tue, 12 Jul 2022 08:40:09 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 26C8e9Ud039110; Tue, 12 Jul 2022 08:40:09 GMT (envelope-from git) Date: Tue, 12 Jul 2022 08:40:09 GMT Message-Id: <202207120840.26C8e9Ud039110@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: 701020056384 - stable/12 - 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/12 X-Git-Reftype: branch X-Git-Commit: 7010200563840936a2bbb0cec01e44ffc1a0b430 Auto-Submitted: auto-generated ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1657615209; 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=j/Pgfs3vWHTnVqcBQqmVagXPKmZt9bhQGDjUx9GbnDk=; b=Fdea7ULdH8443TGoTTYk9wcqrYYxGpmAXp2kj84lyFNQdoPoxn9SH82sy9jUgK2Hnw9Sw5 8jdDGvQt3Ds3bxvM3q2rodsrlCOxpPeQun4lp43sHlnz99OHnU2bETMeYoDEPh96wvy/5v szyJu5G6ytZEBjiN5/MFesBY74qAjrqHwVarDRtiEy8TjEY6qOLUuAjIwVweiw7GisNfMf bK1c/X55BfIXBuhpQy8psCOzUt0+quZSolrxef3nEK3LbXxGvArpHe2QQva8GW6ODFslEY yskIeSO/FdI63Yg+D8B+mT0G1gOYRJ5c54ow6yDya79KlmStBF5aqDj1kUHGqw== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1657615209; a=rsa-sha256; cv=none; b=AkNR5WMyRwxbjH9t2Fx/GgV+KmoqR4sOkMJEymdT6tNd04yeYlK0yldiJURyHGrD8JUjpY z/wczQVFnGyts8zGFwqEgGyKP485Amg1AR1zXDkScuRuOgGNxSHQKRBs2J0pg/lzwykRzr r8LwQnzkPnm5myALpz4dnjOr0rK5QDtHi9nUBP/PzzSPPRJdPTsJB4ibY4OsOB7GIsKGMO borElP3VAlx5znt+NlQw3K27C01lhNmET1WqxI96P27VfHrwY/LtC847QEtdCsy0MiE7x7 BQqcMYIue002Ml8TKA41WgTW6B9LRYveSJNL+y6zZdmEja7LAkQzwYSJejnoPg== ARC-Authentication-Results: i=1; mx1.freebsd.org; none X-ThisMailContainsUnwantedMimeParts: N The branch stable/12 has been updated by 0mp (doc, ports committer): URL: https://cgit.FreeBSD.org/src/commit/?id=7010200563840936a2bbb0cec01e44ffc1a0b430 commit 7010200563840936a2bbb0cec01e44ffc1a0b430 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:50 +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