diff options
author | itchyny <itchyny@cybozu.co.jp> | 2023-07-10 07:30:50 +0900 |
---|---|---|
committer | Nico Williams <nico@cryptonector.com> | 2023-07-26 23:55:00 -0500 |
commit | a1e791acf894722b766eceb9e3c0b6eac209f0a8 (patch) | |
tree | 299787ef96ed6acf408e95ff16cdad8089975ab8 /jq.1.prebuilt | |
parent | 13fbe98dff927dbe6a3eddd89e4487af3f009185 (diff) |
Rename --nul-output to --raw-output0, abort on string containing NUL
The option naming --nul-output was confusing, especially when we have a
similar option for input stream in the future (--nul-input vs --null-input).
Based on the observation of other command line tools, we rename the option
to --raw-output0. We also drop the short option -0 to avoid confusion on
introducing the NUL-delimited input option.
Unlike the other command line tools outputting file names with NUL delimiter,
jq deals with JSON, and its strings may contain NUL character. To protect
users from the risk of injection attacks, we abort the program and print an
error message before outputting strings including NUL character. Closes #2683.
Diffstat (limited to 'jq.1.prebuilt')
-rw-r--r-- | jq.1.prebuilt | 8 |
1 files changed, 4 insertions, 4 deletions
diff --git a/jq.1.prebuilt b/jq.1.prebuilt index 02518f54..4273110c 100644 --- a/jq.1.prebuilt +++ b/jq.1.prebuilt @@ -82,16 +82,16 @@ By default, jq pretty\-prints JSON output\. Using this option will result in mor With this option, if the filter\'s result is a string then it will be written directly to standard output rather than being formatted as a JSON string with quotes\. This can be useful for making jq filters talk to non\-JSON\-based systems\. . .TP -\fB\-\-join\-output\fR / \fB\-j\fR: +\fB\-\-raw\-output0\fR: . .IP -Like \fB\-r\fR but jq won\'t print a newline after each output\. +Like \fB\-r\fR but jq will print NUL instead of newline after each output\. This can be useful when the values being output can contain newlines\. When the output value contains NUL, jq exits with non\-zero code\. . .TP -\fB\-\-nul\-output\fR / \fB\-0\fR: +\fB\-\-join\-output\fR / \fB\-j\fR: . .IP -Like \fB\-r\fR but jq will print NUL instead of newline after each output\. This can be useful when the values being output can contain newlines\. +Like \fB\-r\fR but jq won\'t print a newline after each output\. . .TP \fB\-\-ascii\-output\fR / \fB\-a\fR: |