2007-09-20 06:52:22 +00:00
|
|
|
.\" Copyright (C) 2007 Michael Kerrisk <mtk.manpages@gmail.com>
|
2008-07-08 14:21:20 +00:00
|
|
|
.\" and Copyright (C) 2007 Justin Pryzby <pryzbyj@justinpryzby.com>
|
2007-05-04 22:21:25 +00:00
|
|
|
.\"
|
2013-03-10 09:29:43 +00:00
|
|
|
.\" %%%LICENSE_START(PERMISSIVE_MISC)
|
2007-05-04 22:21:25 +00:00
|
|
|
.\" Permission is hereby granted, free of charge, to any person obtaining
|
|
|
|
.\" a copy of this software and associated documentation files (the
|
|
|
|
.\" "Software"), to deal in the Software without restriction, including
|
|
|
|
.\" without limitation the rights to use, copy, modify, merge, publish,
|
|
|
|
.\" distribute, sublicense, and/or sell copies of the Software, and to
|
|
|
|
.\" permit persons to whom the Software is furnished to do so, subject to
|
|
|
|
.\" the following conditions:
|
|
|
|
.\"
|
|
|
|
.\" The above copyright notice and this permission notice shall be
|
|
|
|
.\" included in all copies or substantial portions of the Software.
|
|
|
|
.\"
|
|
|
|
.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
|
|
|
|
.\" EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
|
|
|
|
.\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
|
|
|
|
.\" IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
|
|
|
|
.\" CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
|
|
|
|
.\" TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
|
|
|
|
.\" SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
epoll_create.2, epoll_ctl.2, epoll_wait.2, eventfd.2, fallocate.2, futex.2, getcpu.2, getitimer.2, ioctl_list.2, ioprio_set.2, migrate_pages.2, move_pages.2, pciconfig_read.2, sendfile.2, setns.2, signalfd.2, spu_create.2, spu_run.2, sysinfo.2, timerfd_create.2, backtrace.3, cmsg.3, error.3, getpt.3, getrpcent.3, getrpcport.3, getsubopt.3, offsetof.3, program_invocation_name.3, rpc.3, rpmatch.3, rtnetlink.3, xdr.3, cciss.4, hpsa.4, pts.4, charmap.5, dir_colors.5, elf.5, gai.conf.5, locale.5, nscd.conf.5, nss.5, resolv.conf.5, rpc.5, arp.7, cpuset.7, ddp.7, epoll.7, fifo.7, futex.7, icmp.7, ip.7, ipv6.7, mailaddr.7, netdevice.7, packet.7, raw.7, regex.7, rtnetlink.7, socket.7, spufs.7, tcp.7, udp.7, unix.7, x25.7, ldconfig.8, nscd.8: Global fix: s/END_LICENSE/LICENSE_END/
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-03-12 09:26:07 +00:00
|
|
|
.\" %%%LICENSE_END
|
2007-05-04 22:21:25 +00:00
|
|
|
.\"
|
chdir.2, chmod.2, chown.2, gethostname.2, getsid.2, pread.2, setpgid.2, sigaltstack.2, truncate.2, wait.2, dirfd.3, getsubopt.3, mkdtemp.3, mkstemp.3, siginterrupt.3, strdup.3: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-09-26 15:43:00 +00:00
|
|
|
.TH GETSUBOPT 3 2010-09-26 "GNU" "Linux Programmer's Manual"
|
2007-05-04 22:21:25 +00:00
|
|
|
.SH NAME
|
|
|
|
getsubopt \- parse suboption arguments from a string
|
|
|
|
.SH SYNOPSIS
|
|
|
|
.B #include <stdlib.h>
|
|
|
|
|
2008-05-06 07:47:45 +00:00
|
|
|
.BI "int getsubopt(char **"optionp ", char * const *" tokens \
|
|
|
|
", char **" valuep );
|
2010-09-17 16:01:30 +00:00
|
|
|
.sp
|
|
|
|
.in -4n
|
|
|
|
Feature Test Macro Requirements for glibc (see
|
|
|
|
.BR feature_test_macros (7)):
|
|
|
|
.in
|
|
|
|
.sp
|
|
|
|
.BR getsubopt ():
|
|
|
|
.ad l
|
|
|
|
.RS 4
|
2010-09-18 08:29:58 +00:00
|
|
|
.PD 0
|
2010-09-19 05:21:43 +00:00
|
|
|
_XOPEN_SOURCE\ >= 500 ||
|
chdir.2, chmod.2, chown.2, gethostname.2, getsid.2, pread.2, setpgid.2, sigaltstack.2, stat.2, truncate.2, wait.2, dirfd.3, getsubopt.3, mkdtemp.3, mkstemp.3, siginterrupt.3, strdup.3: Simplify feature test macro requirements
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-09-26 15:16:57 +00:00
|
|
|
_XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED
|
|
|
|
.br
|
|
|
|
|| /* Since glibc 2.12: */ _POSIX_C_SOURCE\ >=\ 200809L
|
2010-09-18 08:29:58 +00:00
|
|
|
.PD
|
2010-09-17 16:01:30 +00:00
|
|
|
.RE
|
|
|
|
.ad
|
2007-05-04 22:21:25 +00:00
|
|
|
.SH DESCRIPTION
|
|
|
|
.BR getsubopt ()
|
|
|
|
parses the list of comma-separated suboptions provided in
|
|
|
|
.IR optionp .
|
2007-06-21 22:55:04 +00:00
|
|
|
(Such a suboption list is typically produced when
|
2007-05-04 22:21:25 +00:00
|
|
|
.BR getopt (3)
|
|
|
|
is used to parse a command line;
|
2007-05-04 22:35:31 +00:00
|
|
|
see for example the \fI-o\fP option of
|
2007-05-04 22:21:25 +00:00
|
|
|
.BR mount (8).)
|
|
|
|
Each suboption may include an associated value,
|
|
|
|
which is separated from the suboption name by an equal sign.
|
2007-06-21 22:55:04 +00:00
|
|
|
The following is an example of the kind of string
|
|
|
|
that might be passed in
|
2007-05-04 22:21:25 +00:00
|
|
|
.IR optionp :
|
|
|
|
.sp
|
2007-12-19 07:19:23 +00:00
|
|
|
.in +4n
|
2007-05-04 22:21:25 +00:00
|
|
|
.B ro,name=xyz
|
2007-12-19 07:19:23 +00:00
|
|
|
.in
|
2007-05-04 22:21:25 +00:00
|
|
|
|
2007-06-21 22:55:04 +00:00
|
|
|
The
|
2007-05-04 22:21:25 +00:00
|
|
|
.I tokens
|
2011-09-28 04:36:36 +00:00
|
|
|
argument is a pointer to a NULL-terminated array of pointers to the tokens that
|
2007-05-12 00:30:29 +00:00
|
|
|
.BR getsubopt ()
|
2007-06-21 22:55:04 +00:00
|
|
|
will look for in
|
2007-05-04 22:21:25 +00:00
|
|
|
.IR optionp .
|
|
|
|
The tokens should be distinct, null-terminated strings containing at
|
|
|
|
least one character, with no embedded equal signs or commas.
|
|
|
|
|
|
|
|
Each call to
|
|
|
|
.BR getsubopt ()
|
|
|
|
returns information about the next unprocessed suboption in
|
|
|
|
.IR optionp .
|
|
|
|
The first equal sign in a suboption (if any) is interpreted as a
|
|
|
|
separator between the name and the value of that suboption.
|
|
|
|
The value extends to the next comma,
|
|
|
|
or (for the last suboption) to the end of the string.
|
|
|
|
If the name of the suboption matches a known name from
|
|
|
|
.IR tokens ,
|
|
|
|
and a value string was found,
|
|
|
|
.BR getsubopt ()
|
|
|
|
sets
|
2007-12-22 22:10:40 +00:00
|
|
|
.I *valuep
|
2007-05-04 22:21:25 +00:00
|
|
|
to the address of that string.
|
|
|
|
The first comma in
|
|
|
|
.I optionp
|
|
|
|
is overwritten with a null byte, so
|
2007-12-22 22:10:40 +00:00
|
|
|
.I *valuep
|
2007-05-04 22:21:25 +00:00
|
|
|
is precisely the "value string" for that suboption.
|
|
|
|
|
2007-06-08 09:56:56 +00:00
|
|
|
If the suboption is recognized, but no value string was found,
|
2007-12-22 22:10:40 +00:00
|
|
|
.I *valuep
|
2007-05-04 22:21:25 +00:00
|
|
|
is set to NULL.
|
|
|
|
|
|
|
|
When
|
|
|
|
.BR getsubopt ()
|
|
|
|
returns,
|
|
|
|
.I optionp
|
2010-08-29 06:57:21 +00:00
|
|
|
points to the next suboption,
|
2011-09-28 02:52:42 +00:00
|
|
|
or to the null byte (\(aq\\0\(aq) at the end of the
|
2007-05-04 22:21:25 +00:00
|
|
|
string if the last suboption was just processed.
|
|
|
|
.SH RETURN VALUE
|
|
|
|
If the first suboption in
|
|
|
|
.I optionp
|
2007-06-08 09:56:56 +00:00
|
|
|
is recognized,
|
2007-05-04 22:21:25 +00:00
|
|
|
.BR getsubopt ()
|
|
|
|
returns the index of the matching suboption element in
|
2007-11-18 07:28:32 +00:00
|
|
|
.IR tokens .
|
2007-05-04 22:21:25 +00:00
|
|
|
Otherwise, \-1 is returned and
|
2007-12-22 22:10:40 +00:00
|
|
|
.I *valuep
|
2007-05-04 22:21:25 +00:00
|
|
|
is the entire
|
|
|
|
.IB name [= value ]
|
|
|
|
string.
|
|
|
|
|
|
|
|
Since
|
2007-12-22 22:10:40 +00:00
|
|
|
.I *optionp
|
2007-05-04 22:21:25 +00:00
|
|
|
is changed, the first suboption before the call to
|
|
|
|
.BR getsubopt ()
|
|
|
|
is not (necessarily) the same as the first suboption after
|
|
|
|
.BR getsubopt ().
|
|
|
|
.SH CONFORMING TO
|
|
|
|
POSIX.1-2001.
|
|
|
|
.SH NOTES
|
|
|
|
|
|
|
|
Since
|
|
|
|
.BR getsubopt ()
|
|
|
|
overwrites any commas it finds in the string
|
2007-12-22 22:10:40 +00:00
|
|
|
.IR *optionp ,
|
2007-05-04 22:21:25 +00:00
|
|
|
that string must be writable; it cannot be a string constant.
|
2007-05-16 17:35:34 +00:00
|
|
|
.SH EXAMPLE
|
2007-11-17 04:27:41 +00:00
|
|
|
The following program expects suboptions following a "\-o" option.
|
2007-05-04 22:21:25 +00:00
|
|
|
|
|
|
|
.nf
|
|
|
|
#define _XOPEN_SOURCE 500
|
|
|
|
#include <stdlib.h>
|
|
|
|
#include <assert.h>
|
|
|
|
#include <stdio.h>
|
|
|
|
|
|
|
|
int main(int argc, char **argv)
|
|
|
|
{
|
|
|
|
enum {
|
|
|
|
RO_OPT = 0,
|
|
|
|
RW_OPT,
|
|
|
|
NAME_OPT
|
|
|
|
};
|
|
|
|
char *const token[] = {
|
|
|
|
[RO_OPT] = "ro",
|
|
|
|
[RW_OPT] = "rw",
|
|
|
|
[NAME_OPT] = "name",
|
|
|
|
NULL
|
|
|
|
};
|
|
|
|
char *subopts;
|
|
|
|
char *value;
|
|
|
|
int opt;
|
|
|
|
|
|
|
|
int readonly = 0;
|
|
|
|
int readwrite = 0;
|
|
|
|
char *name = NULL;
|
|
|
|
int errfnd = 0;
|
|
|
|
|
2007-06-20 21:39:45 +00:00
|
|
|
while ((opt = getopt(argc, argv, "o:")) != \-1) {
|
2007-06-20 20:52:14 +00:00
|
|
|
switch (opt) {
|
2008-06-09 15:49:35 +00:00
|
|
|
case \(aqo\(aq:
|
2007-05-04 22:21:25 +00:00
|
|
|
subopts = optarg;
|
2008-06-09 15:49:35 +00:00
|
|
|
while (*subopts != \(aq\\0\(aq && !errfnd) {
|
2007-05-04 22:21:25 +00:00
|
|
|
|
|
|
|
switch (getsubopt(&subopts, token, &value)) {
|
2007-06-22 04:59:15 +00:00
|
|
|
case RO_OPT:
|
|
|
|
readonly = 1;
|
|
|
|
break;
|
|
|
|
|
|
|
|
case RW_OPT:
|
|
|
|
readwrite = 1;
|
|
|
|
break;
|
|
|
|
|
|
|
|
case NAME_OPT:
|
|
|
|
if (value == NULL) {
|
|
|
|
fprintf(stderr, "Missing value for "
|
2008-06-09 15:49:35 +00:00
|
|
|
"suboption \(aq%s\(aq\\n", token[NAME_OPT]);
|
2007-05-04 22:21:25 +00:00
|
|
|
errfnd = 1;
|
2007-06-22 04:59:15 +00:00
|
|
|
continue;
|
2007-05-04 22:21:25 +00:00
|
|
|
}
|
2007-06-22 04:59:15 +00:00
|
|
|
|
|
|
|
name = value;
|
|
|
|
break;
|
|
|
|
|
|
|
|
default:
|
|
|
|
fprintf(stderr, "No match found "
|
|
|
|
"for token: /%s/\\n", value);
|
2007-05-04 22:21:25 +00:00
|
|
|
errfnd = 1;
|
2007-06-22 04:59:15 +00:00
|
|
|
break;
|
2007-05-04 22:21:25 +00:00
|
|
|
}
|
2007-06-22 04:59:15 +00:00
|
|
|
}
|
|
|
|
if (readwrite && readonly) {
|
2008-06-09 15:49:35 +00:00
|
|
|
fprintf(stderr, "Only one of \(aq%s\(aq and \(aq%s\(aq can be "
|
2007-06-22 04:59:15 +00:00
|
|
|
"specified\\n", token[RO_OPT], token[RW_OPT]);
|
|
|
|
errfnd = 1;
|
|
|
|
}
|
|
|
|
break;
|
2007-05-04 22:21:25 +00:00
|
|
|
|
|
|
|
default:
|
|
|
|
errfnd = 1;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
if (errfnd || argc == 1) {
|
2007-06-20 21:39:45 +00:00
|
|
|
fprintf(stderr, "\\nUsage: %s \-o <suboptstring>\\n", argv[0]);
|
2008-06-09 15:49:35 +00:00
|
|
|
fprintf(stderr, "suboptions are \(aqro\(aq, \(aqrw\(aq, "
|
|
|
|
"and \(aqname=<value>\(aq\\n");
|
2007-05-04 22:21:25 +00:00
|
|
|
exit(EXIT_FAILURE);
|
|
|
|
}
|
|
|
|
|
|
|
|
/* Remainder of program... */
|
|
|
|
|
|
|
|
exit(EXIT_SUCCESS);
|
|
|
|
}
|
|
|
|
.fi
|
|
|
|
.SH SEE ALSO
|
getresuid.2, intro.2, mremap.2, open.2, poll.2, posix_fadvise.2, pread.2, remap_file_pages.2, setresuid.2, signal.2, splice.2, sync_file_range.2, tee.2, vmsplice.2, INFINITY.3, asprintf.3, assert_perror.3, basename.3, bsd_signal.3, canonicalize_file_name.3, clog10.3, crypt.3, dl_iterate_phdr.3, dlopen.3, dprintf.3, encrypt.3, exp10.3, fcloseall.3, fenv.3, ffs.3, fmemopen.3, fopencookie.3, ftw.3, getdate.3, getline.3, getloadavg.3, getopt.3, getsubopt.3, getutent.3, grantpt.3, hsearch.3, intro.3, lseek64.3, memmem.3, mempcpy.3, mq_receive.3, mq_send.3, posix_fallocate.3, pow10.3, program_invocation_name.3, ptsname.3, putgrent.3, readdir.3, sigset.3, sincos.3, stpcpy.3, stpncpy.3, strchr.3, strfry.3, strnlen.3, strptime.3, strsignal.3, strstr.3, strverscmp.3, swab.3, sysv_signal.3, tsearch.3, unlocked_stdio.3, unlockpt.3, wcpcpy.3, wcpncpy.3, wcsdup.3, wcwidth.3: SEE ALSO: Remove redundant reference to feature_test_macros(7)
Reported-by: Florian Lehmann <flo.lehmann@googlemail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-10-31 05:05:22 +00:00
|
|
|
.BR getopt (3)
|