This is not wrong, but perhaps some details about different types of errors may be helpful, such as that nonexistent usernames in -U are immediately fatal while an empty result (such as from only nonexistent process IDs in -p or only existing users that do not currently run any process in -U) still writes the header line (if not disabled) and also returns a non-zero exit status.

Closed by commit rS339957: ps(1): Add a standard exit status section (authored by 0mp). · Explain WhyOct 31 2018, 4:10 PM

This revision was automatically updated to reflect the committed changes.

@jilles do you think we could open another PR for your suggestions?

In D17146#366362, @jilles wrote:

This is not wrong, but perhaps some details about different types of errors may be helpful, such as that nonexistent usernames in -U are immediately fatal while an empty result (such as from only nonexistent process IDs in -p or only existing users that do not currently run any process in -U) still writes the header line (if not disabled) and also returns a non-zero exit status.

I've created a PR for this: https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=232852

0mp mentioned this in rS358942: MFC r339957:.Mar 13 2020, 9:07 AM

0mp mentioned this in rS358943: MFC r339957:.

Revision Contents
Changeset List

Path

Size

head/

bin/

ps/

ps.1

4 lines

Diff 49830

View Options

head/bin/ps/ps.1

Show All 38 Lines

.Dt NVMECONTROL 8

.Os

.Sh NAME

.Nm nvmecontrol

.Nd NVM Express control utility

.Sh SYNOPSIS

.Nm

.Ic devlist

.Op Fl h

.Nm

.Ic identify

.Op Fl v

.Op Fl x

.Op Fl n Ar nsid

.Aq Ar device-id | Ar namespace-id

.Nm

.Ic perftest

▲ Show 20 Lines • Show All 149 Lines • ▼ Show 20 Lines

.Aq Ar device-id

.Nm

.Ic io-passthru

.Op args

.Aq Ar namespace-id

.Sh DESCRIPTION

NVM Express (NVMe) is a storage protocol standard, for SSDs and other

high-speed storage devices over PCI Express.

.Ss devlist

List all NVMe controllers and namespaces along with their device nodes.

With the

.Fl h

argument, use unit suffixes: Byte, Kibibyte, Mebibyte, Gibibyte, Tebibyte

and Pebibyte (based on powers of 1024) when showing the disk space.

By default, uses Mebibyte.

pauamma_gundo.comUnsubmitted

Not Done

and Pebibyte (based on powers of 1024) when showing the disk space.

- By default, shows in Mebityte.

+ By default, shows in Mebibyte.

.Ss identify

Maybe also s/shows in/uses/ for consistency with the previous sentence, but that's a matter of taste. The typo itself is the important thing.

pauamma_gundo.com: Maybe also s/shows in/uses/ for consistency with the previous sentence, but that's a matter of…

.Ss identify

The identify commands reports information from the drive's

.Dv IDENTIFY_CONTROLLER

if a

.Ar device-id

is specified.

It reports

.Dv IDENTIFY_NAMESPACE

▲ Show 20 Lines • Show All 530 Lines • Show Last 20 Lines

ps(1): Add a standard exit status section.ClosedPublicActions

Details

Diff Detail

Event Timeline

Revision ContentsChangeset List

Diff 49830

head/bin/ps/ps.1

ps(1): Add a standard exit status section.
ClosedPublic
Actions

Revision Contents
Changeset List