Page MenuHomeFreeBSD
Files F177384986

D14142.1794259577.diff
No OneTemporary
Actions

Authored By
Unknown
Size
1 KB
Referenced Files
None
Subscribers
None

D14142.1794259577.diff
View Options

Index: lib/libc/stdlib/getopt_long.3
===================================================================
--- lib/libc/stdlib/getopt_long.3
+++ lib/libc/stdlib/getopt_long.3
@@ -31,7 +31,7 @@
.\" @(#)getopt.3 8.5 (Berkeley) 4/27/95
.\" $FreeBSD$
.\"
-.Dd December 25, 2011
+.Dd May 2, 2018
.Dt GETOPT_LONG 3
.Os
.Sh NAME
@@ -207,12 +207,53 @@
.Fa val
in the location pointed to by
.Fa flag .
+.Pp
These functions return
.Ql \&:
-if there was a missing option argument,
+if there was a missing option argument and error messages are suppressed,
.Ql \&?
if the user specified an unknown or ambiguous option, and
\-1 when the argument list has been exhausted.
+The default behavior when a missing option argument is encountered is to write
+an error and return
+.Ql \&? .
+Specifying
+.Ql \&:
+in
+.Fa optstr
+will cause the error message to be suppressed and
+.Ql \&:
+to be returned instead.
+.Pp
+In addition to
+.Ql \&: ,
+a leading
+.Ql \&+
+or
+.Ql \&-
+in
+.Fa optstr
+also has special meaning.
+If either of these are specified, they must appear before
+.Ql \&: .
+.Pp
+A leading
+.Ql \&+
+indicates that processing should be halted at the first non-option argument,
+matching the default behavior of
+.Xr getopt 3 .
+The default behavior without
+.Ql \&+
+is to permute non-option argments to the end of
+.Fa argv .
+.Pp
+A leading
+.Ql \&-
+indicates that all non-option arguments should be treated as if they are
+arguments to a literal
+.Ql \&1
+flag (i.e., the function call will return the value 1, rather than the char
+literal '1').
.Sh ENVIRONMENT
.Bl -tag -width ".Ev POSIXLY_CORRECT"
.It Ev POSIXLY_CORRECT

File Metadata

Mime Type
text/plain
Expires
Mon, Nov 9, 9:26 PM (54 m, 33 s)
Storage Engine
blob
Storage Format
Raw Data
Storage Handle
41611701
Default Alt Text
D14142.1794259577.diff (1 KB)

Event Timeline