38 lines
975 B
Groff
38 lines
975 B
Groff
.TH PSCAT 1
|
|
|
|
.SH NAME
|
|
|
|
pscat \- concatenate the output of processes
|
|
|
|
.SH SYNOPSIS
|
|
|
|
pscat
|
|
"["
|
|
.RB [ utility
|
|
.RB [ argument... ]]
|
|
"]" ...
|
|
|
|
.SH DESCRIPTION
|
|
|
|
Pscat executes multiple commands, one after the other.
|
|
This allows multiple processes to be piped as one to another program.
|
|
|
|
.SH DIAGNOSTICS
|
|
|
|
Pscat will print an error message and exit with the appropriate status from sysexits(3) if executed improperly.
|
|
Pscat will exit with the sum of the child processes' exit statuses if run correctly.
|
|
|
|
.SH BUGS
|
|
|
|
Pscat's exit status isn't useful when run correctly; there's no way to tell which process failed if one did.
|
|
This issue of ergonomics isn't obviously mendable as processes' standard outputs and standard errors are meant to both be conveyed.
|
|
If either could be ignored the individual exit statuses could simply be printed.
|
|
.PP
|
|
Pscat's function is redundant to the sh(1) construct
|
|
.RB { utility ; utility ;}
|
|
- this is a feature, not a bug.
|
|
|
|
.SH COPYRIGHT
|
|
|
|
Public domain.
|