getopt_long.3 (126440) | getopt_long.3 (126452) |
---|---|
1.\" $OpenBSD: getopt_long.3,v 1.10 2004/01/06 23:44:28 fgsch Exp $ 2.\" $NetBSD: getopt_long.3,v 1.14 2003/08/07 16:43:40 agc Exp $ 3.\" 4.\" Copyright (c) 1988, 1991, 1993 5.\" The Regents of the University of California. All rights reserved. 6.\" 7.\" Redistribution and use in source and binary forms, with or without 8.\" modification, are permitted provided that the following conditions --- 15 unchanged lines hidden (view full) --- 24.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 25.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 26.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 27.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 28.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 29.\" SUCH DAMAGE. 30.\" 31.\" @(#)getopt.3 8.5 (Berkeley) 4/27/95 | 1.\" $OpenBSD: getopt_long.3,v 1.10 2004/01/06 23:44:28 fgsch Exp $ 2.\" $NetBSD: getopt_long.3,v 1.14 2003/08/07 16:43:40 agc Exp $ 3.\" 4.\" Copyright (c) 1988, 1991, 1993 5.\" The Regents of the University of California. All rights reserved. 6.\" 7.\" Redistribution and use in source and binary forms, with or without 8.\" modification, are permitted provided that the following conditions --- 15 unchanged lines hidden (view full) --- 24.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 25.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 26.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 27.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 28.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 29.\" SUCH DAMAGE. 30.\" 31.\" @(#)getopt.3 8.5 (Berkeley) 4/27/95 |
32.\" $FreeBSD: head/lib/libc/stdlib/getopt_long.3 126440 2004-03-01 10:59:23Z ache $ | 32.\" $FreeBSD: head/lib/libc/stdlib/getopt_long.3 126452 2004-03-01 17:57:05Z ache $ |
33.\" 34.Dd April 1, 2000 35.Dt GETOPT_LONG 3 36.Os 37.Sh NAME 38.Nm getopt_long , 39.Nm getopt_long_only 40.Nd get long options from command line argument list --- 248 unchanged lines hidden (view full) --- 289This functionality is provided for backward compatibility with 290programs, such as 291.Xr su 1 , 292that use 293.Ql - 294as an option flag. 295This practice is wrong, and should not be used in any current development. 296.El | 33.\" 34.Dd April 1, 2000 35.Dt GETOPT_LONG 3 36.Os 37.Sh NAME 38.Nm getopt_long , 39.Nm getopt_long_only 40.Nd get long options from command line argument list --- 248 unchanged lines hidden (view full) --- 289This functionality is provided for backward compatibility with 290programs, such as 291.Xr su 1 , 292that use 293.Ql - 294as an option flag. 295This practice is wrong, and should not be used in any current development. 296.El |
297.\" .It 298.\" Handling of 299.\" .Ql :: 300.\" in options string in presence of 301.\" .Ev POSIXLY_CORRECT : 302.\" .Bl -tag -width ".Bx" 303.\" .It Both 304.\" .Tn GNU 305.\" and 306.\" .Bx 307.\" ignore 308.\" .Ev POSIXLY_CORRECT 309.\" here and take 310.\" .Ql :: 311.\" to 312.\" mean the preceding option takes an optional argument. 313.\" .El |
|
297.It | 314.It |
298Handling of 299.Ql :: 300in options string in presence of 301.Ev POSIXLY_CORRECT : 302.Bl -tag -width ".Bx" 303.It Both 304.Tn GNU 305and 306.Bx 307ignore 308.Ev POSIXLY_CORRECT 309here and take 310.Ql :: 311to 312mean the preceding option takes an optional argument. 313.El 314.It | |
315Return value in case of missing argument if first character 316(after 317.Ql + 318or 319.Ql - ) 320in option string is not 321.Ql \&: : 322.Bl -tag -width ".Bx" --- 107 unchanged lines hidden (view full) --- 430set to 0 and 431.Va optarg 432set to 433.Dv NULL 434(as 435.Tn GNU Ns 's 436man page documents). 437.El | 315Return value in case of missing argument if first character 316(after 317.Ql + 318or 319.Ql - ) 320in option string is not 321.Ql \&: : 322.Bl -tag -width ".Bx" --- 107 unchanged lines hidden (view full) --- 430set to 0 and 431.Va optarg 432set to 433.Dv NULL 434(as 435.Tn GNU Ns 's 436man page documents). 437.El |
438.\" .It 439.\" The error messages are different. |
|
438.It | 440.It |
439The error messages are different. 440.It | |
441.Bx 442does not permute the argument vector at the same points in 443the calling sequence as 444.Tn GNU 445does. 446The aspects normally used by 447the caller (ordering after \-1 is returned, value of 448.Va optind --- 58 unchanged lines hidden --- | 441.Bx 442does not permute the argument vector at the same points in 443the calling sequence as 444.Tn GNU 445does. 446The aspects normally used by 447the caller (ordering after \-1 is returned, value of 448.Va optind --- 58 unchanged lines hidden --- |