Auto sync2gitlab import of gflags-2.2.2-1.el8.src.rpm
This commit is contained in:
James Antill
parent
1ece907ff7
commit
928d27e6b7
1
.gitignore
vendored
Normal file
1
.gitignore
vendored
Normal file
@ -0,0 +1 @@
|
|||||||
|
/gflags-2.2.2.tar.gz
|
||||||
115
designstyle.css
Normal file
115
designstyle.css
Normal file
@ -0,0 +1,115 @@
|
|||||||
|
body {
|
||||||
|
background-color: #ffffff;
|
||||||
|
color: black;
|
||||||
|
margin-right: 1in;
|
||||||
|
margin-left: 1in;
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
h1, h2, h3, h4, h5, h6 {
|
||||||
|
color: #3366ff;
|
||||||
|
font-family: sans-serif;
|
||||||
|
}
|
||||||
|
@media print {
|
||||||
|
/* Darker version for printing */
|
||||||
|
h1, h2, h3, h4, h5, h6 {
|
||||||
|
color: #000080;
|
||||||
|
font-family: helvetica, sans-serif;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
h1 {
|
||||||
|
text-align: center;
|
||||||
|
font-size: 18pt;
|
||||||
|
}
|
||||||
|
h2 {
|
||||||
|
margin-left: -0.5in;
|
||||||
|
}
|
||||||
|
h3 {
|
||||||
|
margin-left: -0.25in;
|
||||||
|
}
|
||||||
|
h4 {
|
||||||
|
margin-left: -0.125in;
|
||||||
|
}
|
||||||
|
hr {
|
||||||
|
margin-left: -1in;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Definition lists: definition term bold */
|
||||||
|
dt {
|
||||||
|
font-weight: bold;
|
||||||
|
}
|
||||||
|
|
||||||
|
address {
|
||||||
|
text-align: right;
|
||||||
|
}
|
||||||
|
/* Use the <code> tag for bits of code and <var> for variables and objects. */
|
||||||
|
code,pre,samp,var {
|
||||||
|
color: #006000;
|
||||||
|
}
|
||||||
|
/* Use the <file> tag for file and directory paths and names. */
|
||||||
|
file {
|
||||||
|
color: #905050;
|
||||||
|
font-family: monospace;
|
||||||
|
}
|
||||||
|
/* Use the <kbd> tag for stuff the user should type. */
|
||||||
|
kbd {
|
||||||
|
color: #600000;
|
||||||
|
}
|
||||||
|
div.note p {
|
||||||
|
float: right;
|
||||||
|
width: 3in;
|
||||||
|
margin-right: 0%;
|
||||||
|
padding: 1px;
|
||||||
|
border: 2px solid #6060a0;
|
||||||
|
background-color: #fffff0;
|
||||||
|
}
|
||||||
|
|
||||||
|
UL.nobullets {
|
||||||
|
list-style-type: none;
|
||||||
|
list-style-image: none;
|
||||||
|
margin-left: -1em;
|
||||||
|
}
|
||||||
|
|
||||||
|
/*
|
||||||
|
body:after {
|
||||||
|
content: "Google Confidential";
|
||||||
|
}
|
||||||
|
*/
|
||||||
|
|
||||||
|
/* pretty printing styles. See prettify.js */
|
||||||
|
.str { color: #080; }
|
||||||
|
.kwd { color: #008; }
|
||||||
|
.com { color: #800; }
|
||||||
|
.typ { color: #606; }
|
||||||
|
.lit { color: #066; }
|
||||||
|
.pun { color: #660; }
|
||||||
|
.pln { color: #000; }
|
||||||
|
.tag { color: #008; }
|
||||||
|
.atn { color: #606; }
|
||||||
|
.atv { color: #080; }
|
||||||
|
pre.prettyprint { padding: 2px; border: 1px solid #888; }
|
||||||
|
|
||||||
|
.embsrc { background: #eee; }
|
||||||
|
|
||||||
|
@media print {
|
||||||
|
.str { color: #060; }
|
||||||
|
.kwd { color: #006; font-weight: bold; }
|
||||||
|
.com { color: #600; font-style: italic; }
|
||||||
|
.typ { color: #404; font-weight: bold; }
|
||||||
|
.lit { color: #044; }
|
||||||
|
.pun { color: #440; }
|
||||||
|
.pln { color: #000; }
|
||||||
|
.tag { color: #006; font-weight: bold; }
|
||||||
|
.atn { color: #404; }
|
||||||
|
.atv { color: #060; }
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Table Column Headers */
|
||||||
|
.hdr {
|
||||||
|
color: #006;
|
||||||
|
font-weight: bold;
|
||||||
|
background-color: #dddddd; }
|
||||||
|
.hdr2 {
|
||||||
|
color: #006;
|
||||||
|
background-color: #eeeeee; }
|
||||||
12
gflags-fix_pkgconfig.patch
Normal file
12
gflags-fix_pkgconfig.patch
Normal file
@ -0,0 +1,12 @@
|
|||||||
|
diff -up gflags-2.2.2/cmake/package.pc.in.orig gflags-2.2.2/cmake/package.pc.in
|
||||||
|
--- gflags-2.2.2/cmake/package.pc.in.orig 2018-11-11 22:21:00.000000000 +0100
|
||||||
|
+++ gflags-2.2.2/cmake/package.pc.in 2020-03-09 13:54:40.797884193 +0100
|
||||||
|
@@ -1,7 +1,7 @@
|
||||||
|
prefix=@CMAKE_INSTALL_PREFIX@
|
||||||
|
exec_prefix=${prefix}
|
||||||
|
bindir=${prefix}/@RUNTIME_INSTALL_DIR@
|
||||||
|
-libdir=${prefix}/@LIBRARY_INSTALL_DIR@
|
||||||
|
+libdir=@LIBRARY_INSTALL_DIR@
|
||||||
|
includedir=${prefix}/@INCLUDE_INSTALL_DIR@
|
||||||
|
|
||||||
|
Name: @PACKAGE_NAME@
|
||||||
191
gflags.spec
Normal file
191
gflags.spec
Normal file
@ -0,0 +1,191 @@
|
|||||||
|
Name: gflags
|
||||||
|
Version: 2.2.2
|
||||||
|
Release: 1%{?dist}
|
||||||
|
Summary: Library for commandline flag processing
|
||||||
|
|
||||||
|
Group: Development/Tools
|
||||||
|
License: BSD
|
||||||
|
URL: https://gflags.github.io/gflags/
|
||||||
|
Source0: https://github.com/%{name}/%{name}/archive/v%{version}/%{name}-%{version}.tar.gz
|
||||||
|
# These two are refered from a submodule in 2.2.2 tree, hence they
|
||||||
|
# are not picked by git archive command so thats why we must put
|
||||||
|
# them here:
|
||||||
|
Source1: index.html
|
||||||
|
Source2: designstyle.css
|
||||||
|
Patch0: gflags-fix_pkgconfig.patch
|
||||||
|
BuildRequires: gcc-c++
|
||||||
|
BuildRequires: cmake
|
||||||
|
|
||||||
|
%description
|
||||||
|
The gflags package contains a library that implements commandline
|
||||||
|
flags processing. As such it's a replacement for getopt(). It has
|
||||||
|
increased flexibility, including built-in support for C++ types like
|
||||||
|
string, and the ability to define flags in the source file in which
|
||||||
|
they're used.
|
||||||
|
|
||||||
|
%package devel
|
||||||
|
Summary: Development files for %{name}
|
||||||
|
Group: Development/Libraries
|
||||||
|
|
||||||
|
Requires: %{name}%{?_isa} = %{version}-%{release}
|
||||||
|
|
||||||
|
%description devel
|
||||||
|
This package contains development files for %{name}.
|
||||||
|
|
||||||
|
%prep
|
||||||
|
%autosetup -p1
|
||||||
|
|
||||||
|
cp -v %{SOURCE1} ./doc
|
||||||
|
cp -v %{SOURCE2} ./doc
|
||||||
|
|
||||||
|
%build
|
||||||
|
%cmake -DBUILD_TESTING:BOOL=ON \
|
||||||
|
-DINSTALL_HEADERS:BOOL=ON \
|
||||||
|
-DREGISTER_BUILD_DIR:BOOL=OFF \
|
||||||
|
-DREGISTER_INSTALL_PREFIX:BOOL=OFF
|
||||||
|
%cmake_build
|
||||||
|
|
||||||
|
%install
|
||||||
|
%cmake_install
|
||||||
|
|
||||||
|
%check
|
||||||
|
%ctest
|
||||||
|
|
||||||
|
%ldconfig_scriptlets
|
||||||
|
|
||||||
|
%files
|
||||||
|
%license COPYING.txt
|
||||||
|
%doc AUTHORS.txt ChangeLog.txt README.md
|
||||||
|
%{_bindir}/gflags_completions.sh
|
||||||
|
%{_libdir}/libgflags.so.*
|
||||||
|
%{_libdir}/libgflags_nothreads.so.*
|
||||||
|
|
||||||
|
%files devel
|
||||||
|
%doc doc/designstyle.css doc/index.html
|
||||||
|
%dir %{_includedir}/%{name}
|
||||||
|
%{_includedir}/%{name}/*.h
|
||||||
|
%{_libdir}/libgflags.so
|
||||||
|
%{_libdir}/pkgconfig/gflags.pc
|
||||||
|
%{_libdir}/libgflags_nothreads.so
|
||||||
|
%{_libdir}/cmake/%{name}
|
||||||
|
|
||||||
|
%changelog
|
||||||
|
* Fri Jan 21 2022 Jiri Kucera <jkucera@redhat.com> - 2.2.2-1
|
||||||
|
- Rebase to gflags v2.2.2
|
||||||
|
Resolves: #2035143
|
||||||
|
|
||||||
|
* Wed Feb 07 2018 Fedora Release Engineering <releng@fedoraproject.org> - 2.1.2-6
|
||||||
|
- Rebuilt for https://fedoraproject.org/wiki/Fedora_28_Mass_Rebuild
|
||||||
|
|
||||||
|
* Mon Aug 07 2017 Björn Esser <besser82@fedoraproject.org> - 2.1.2-5
|
||||||
|
- Rebuilt for AutoReq cmake-filesystem
|
||||||
|
|
||||||
|
* Wed Aug 02 2017 Fedora Release Engineering <releng@fedoraproject.org> - 2.1.2-4
|
||||||
|
- Rebuilt for https://fedoraproject.org/wiki/Fedora_27_Binutils_Mass_Rebuild
|
||||||
|
|
||||||
|
* Wed Jul 26 2017 Fedora Release Engineering <releng@fedoraproject.org> - 2.1.2-3
|
||||||
|
- Rebuilt for https://fedoraproject.org/wiki/Fedora_27_Mass_Rebuild
|
||||||
|
|
||||||
|
* Fri Feb 10 2017 Fedora Release Engineering <releng@fedoraproject.org> - 2.1.2-2
|
||||||
|
- Rebuilt for https://fedoraproject.org/wiki/Fedora_26_Mass_Rebuild
|
||||||
|
|
||||||
|
* Sat Feb 27 2016 Evan Klitzke - 2.1.2-1
|
||||||
|
- Upgrade to the latest upstream release, 2.1.2
|
||||||
|
|
||||||
|
* Wed Feb 03 2016 Fedora Release Engineering <releng@fedoraproject.org> - 2.1.1-9
|
||||||
|
- Rebuilt for https://fedoraproject.org/wiki/Fedora_24_Mass_Rebuild
|
||||||
|
|
||||||
|
* Wed Jun 17 2015 Fedora Release Engineering <rel-eng@lists.fedoraproject.org> - 2.1.1-8
|
||||||
|
- Rebuilt for https://fedoraproject.org/wiki/Fedora_23_Mass_Rebuild
|
||||||
|
|
||||||
|
* Sat May 02 2015 Kalev Lember <kalevlember@gmail.com> - 2.1.1-7
|
||||||
|
- Rebuilt for GCC 5 C++11 ABI change
|
||||||
|
|
||||||
|
* Sat Aug 16 2014 Fedora Release Engineering <rel-eng@lists.fedoraproject.org> - 2.1.1-6
|
||||||
|
- Rebuilt for https://fedoraproject.org/wiki/Fedora_21_22_Mass_Rebuild
|
||||||
|
|
||||||
|
* Mon Jun 30 2014 Toshio Kuratomi <toshio@fedoraproject.org> - 2.1.1-5
|
||||||
|
- Replace python-setuptools-devel BR with python-setuptools
|
||||||
|
|
||||||
|
* Sat Jun 07 2014 Fedora Release Engineering <rel-eng@lists.fedoraproject.org> - 2.1.1-4
|
||||||
|
- Rebuilt for https://fedoraproject.org/wiki/Fedora_21_Mass_Rebuild
|
||||||
|
|
||||||
|
* Thu May 01 2014 John Khvatov <ivaxer@fedoraproject.org> - 2.1.1-3
|
||||||
|
- Add patch (from upstream) for shared library versining.
|
||||||
|
|
||||||
|
* Wed Apr 30 2014 John Khvatov <ivaxer@fedoraproject.org> - 2.1.1-2
|
||||||
|
- Enable test suite
|
||||||
|
- Update SourceURL (upstream moved to github)
|
||||||
|
- Add patch to use LIB_SUFFIX in cmake configs
|
||||||
|
- Spec cleanup
|
||||||
|
|
||||||
|
* Wed Apr 23 2014 Dan Fuhry <dfuhry@dattobackup.com> - 2.1.1-1
|
||||||
|
- Updated to 2.1.1
|
||||||
|
|
||||||
|
* Sat Aug 31 2013 Peter Lemenkov <lemenkov@gmail.com> - 1.3-8
|
||||||
|
- Use system-wide libtool
|
||||||
|
- Autoregen everything
|
||||||
|
|
||||||
|
* Tue Aug 06 2013 Peter Lemenkov <lemenkov@gmail.com> - 1.3-7
|
||||||
|
- Cleanup spec-file (removed EL6/FC6 stuff)
|
||||||
|
- Fix doc-files installation
|
||||||
|
|
||||||
|
* Sat Aug 03 2013 Fedora Release Engineering <rel-eng@lists.fedoraproject.org> - 1.3-6
|
||||||
|
- Rebuilt for https://fedoraproject.org/wiki/Fedora_20_Mass_Rebuild
|
||||||
|
|
||||||
|
* Wed Feb 13 2013 Fedora Release Engineering <rel-eng@lists.fedoraproject.org> - 1.3-5
|
||||||
|
- Rebuilt for https://fedoraproject.org/wiki/Fedora_19_Mass_Rebuild
|
||||||
|
|
||||||
|
* Thu Jul 19 2012 Fedora Release Engineering <rel-eng@lists.fedoraproject.org> - 1.3-4
|
||||||
|
- Rebuilt for https://fedoraproject.org/wiki/Fedora_18_Mass_Rebuild
|
||||||
|
|
||||||
|
* Fri Jan 13 2012 Fedora Release Engineering <rel-eng@lists.fedoraproject.org> - 1.3-3
|
||||||
|
- Rebuilt for https://fedoraproject.org/wiki/Fedora_17_Mass_Rebuild
|
||||||
|
|
||||||
|
* Tue Feb 08 2011 Fedora Release Engineering <rel-eng@lists.fedoraproject.org> - 1.3-2
|
||||||
|
- Rebuilt for https://fedoraproject.org/wiki/Fedora_15_Mass_Rebuild
|
||||||
|
|
||||||
|
* Sat Jan 30 2010 Rakesh Pandit <rakesh@fedoraproject.org> - 1.3-1
|
||||||
|
- Updated to 1.3
|
||||||
|
- Removed python bindings (they are separate project now)
|
||||||
|
|
||||||
|
* Fri Dec 04 2009 Rakesh Pandit <rakesh@fedoraproject.org> - 1.2-1
|
||||||
|
- Updated to 1.2
|
||||||
|
|
||||||
|
* Wed Aug 05 2009 Rakesh Pandit <rakesh@fedoraproject.org> - 1.1-1
|
||||||
|
- removed extra files included in %%files section and updated to 1.1
|
||||||
|
|
||||||
|
* Fri Jul 24 2009 Fedora Release Engineering <rel-eng@lists.fedoraproject.org> - 1.0-4
|
||||||
|
- Rebuilt for https://fedoraproject.org/wiki/Fedora_12_Mass_Rebuild
|
||||||
|
|
||||||
|
* Fri Feb 27 2009 Debarshi Ray <rishi@fedoraproject.org> - 1.0-3
|
||||||
|
- Fixed build failure with gcc-4.4.
|
||||||
|
|
||||||
|
* Tue Feb 24 2009 Fedora Release Engineering <rel-eng@lists.fedoraproject.org> - 1.0-2
|
||||||
|
- Rebuilt for https://fedoraproject.org/wiki/Fedora_11_Mass_Rebuild
|
||||||
|
|
||||||
|
* Fri Jan 16 2009 Rakesh Pandit <rakesh@fedoraproject.org> - 1.0-1
|
||||||
|
- Updated to 1.0.
|
||||||
|
|
||||||
|
* Sat Nov 29 2008 Ignacio Vazquez-Abrams <ivazqueznet+rpm@gmail.com> - 0.9-7
|
||||||
|
- Rebuild for Python 2.6
|
||||||
|
|
||||||
|
* Thu Sep 04 2008 Rakesh Pandit <rakesh@fedoraproject.org> 0.9-6
|
||||||
|
- fixed for F-8 provide eggs for non setuptools package
|
||||||
|
|
||||||
|
* Thu Sep 04 2008 Rakesh Pandit <rakesh@fedoraproject.org> 0.9-5
|
||||||
|
- disable test suite because it failed on x86_64 (2/17)
|
||||||
|
|
||||||
|
* Tue Aug 26 2008 Rakesh Pandit <rakesh@fedoraproject.org> 0.9-4
|
||||||
|
- fixed %%{includedir}
|
||||||
|
|
||||||
|
* Thu Aug 14 2008 Rakesh Pandit <rakesh@fedoraproject.org> 0.9-3
|
||||||
|
- fixed documentation, timestamp saving
|
||||||
|
- removed chrpath & cleaned some unwanted commands
|
||||||
|
- included python module
|
||||||
|
|
||||||
|
* Sat Aug 09 2008 Rakesh Pandit <rakesh@fedoraproject.org> 0.9-2
|
||||||
|
- remove automake and corrected configure option
|
||||||
|
|
||||||
|
* Thu Aug 07 2008 Rakesh Pandit <rakesh@fedoraproject.org> 0.9-1
|
||||||
|
- Initial build
|
||||||
638
index.html
Normal file
638
index.html
Normal file
@ -0,0 +1,638 @@
|
|||||||
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
|
||||||
|
|
||||||
|
<html>
|
||||||
|
<head>
|
||||||
|
<title>How To Use Gflags (formerly Google Commandline Flags)</title>
|
||||||
|
|
||||||
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
|
||||||
|
<link href="designstyle.css" type="text/css" rel="stylesheet">
|
||||||
|
<style type="text/css">
|
||||||
|
<!--
|
||||||
|
ol.bluelist li {
|
||||||
|
color: #3366ff;
|
||||||
|
font-family: sans-serif;
|
||||||
|
}
|
||||||
|
ol.bluelist li p {
|
||||||
|
color: #000;
|
||||||
|
font-family: "Times Roman", times, serif;
|
||||||
|
}
|
||||||
|
ul.blacklist li {
|
||||||
|
color: #000;
|
||||||
|
font-family: "Times Roman", times, serif;
|
||||||
|
}
|
||||||
|
//-->
|
||||||
|
</style>
|
||||||
|
</head>
|
||||||
|
|
||||||
|
<body>
|
||||||
|
|
||||||
|
<h1>How To Use gflags (formerly Google Commandline Flags)</h1>
|
||||||
|
<small>(as of
|
||||||
|
<script type=text/javascript>
|
||||||
|
var lm = new Date(document.lastModified);
|
||||||
|
document.write(lm.toDateString());
|
||||||
|
</script>)
|
||||||
|
</small>
|
||||||
|
<br>
|
||||||
|
|
||||||
|
<blockquote><dl>
|
||||||
|
<dt> Table of contents </dt>
|
||||||
|
<dd> <a href="#intro">Introduction</a> </dd>
|
||||||
|
<dd> <a href="#download">Download and Installation</a> </dd>
|
||||||
|
<dd> <a href="#cmake">Declare dependency on gflags with CMake</a></dd>
|
||||||
|
<dd> <a href="#bazel">Declare dependency on gflags with Bazel</a></dd>
|
||||||
|
<dd> <a href="#define">DEFINE: Defining Flags In Program</A> </dd>
|
||||||
|
<dd> <a href="#using">Accessing the Flag</A> </dd>
|
||||||
|
<dd> <a href="#declare">DECLARE: Using the Flag in a Different File</a> </dd>
|
||||||
|
<dd> <a href="#validate">RegisterFlagValidator: Sanity-checking Flag Values</a> </dd>
|
||||||
|
<dd> <a href="#together">Putting It Together: How to Set Up Flags</a> </dd>
|
||||||
|
<dd> <a href="#commandline">Setting Flags on the Command Line</a> </dd>
|
||||||
|
<dd> <a href="#default">Changing the Default Flag Value</a> </dd>
|
||||||
|
<dd> <a href="#special">Special Flags</a> </dd>
|
||||||
|
<dd> <a href="#api">The API</a> </dd>
|
||||||
|
<dd> <a href="#misc">Miscellaneous Notes</a> </dd>
|
||||||
|
<dd> <a href="#issues">Issues and Feature Requests</a> </dd>
|
||||||
|
<dd> <br/> </dd>
|
||||||
|
</dl></blockquote>
|
||||||
|
|
||||||
|
<h2> <A NAME=intro>Introduction, and Comparison to Other Commandline
|
||||||
|
Flags Libraries</A> </h2>
|
||||||
|
|
||||||
|
<p><b>Commandline flags</b> are flags that users specify on the
|
||||||
|
command line when they run an executable. In the command</p>
|
||||||
|
<pre>
|
||||||
|
fgrep -l -f /var/tmp/foo johannes brahms
|
||||||
|
</pre>
|
||||||
|
<p><code>-l</code> and <code>-f /var/tmp/foo</code> are the two
|
||||||
|
commandline flags. (<code>johannes</code> and <code>brahms</code>,
|
||||||
|
which don't start with a dash, are <b>commandline arguments</b>.)</p>
|
||||||
|
|
||||||
|
<p>Typically, an application lists what flags the user is allowed to
|
||||||
|
pass in, and what arguments they take -- in this example,
|
||||||
|
<code>-l</code> takes no argument, and <code>-f</code> takes a
|
||||||
|
string (in particular, a filename) as an argument. Users can use a
|
||||||
|
library to help parse the commandline and store the flags in some data
|
||||||
|
structure.</p>
|
||||||
|
|
||||||
|
<p>Gflags, the commandline flags library used within Google,
|
||||||
|
differs from other libraries,
|
||||||
|
such as <code>getopt()</code>, in that flag definitions can be
|
||||||
|
scattered around the source code, and not just listed in one place
|
||||||
|
such as <code>main()</code>. In practice, this means that a single
|
||||||
|
source-code file will define and use flags that are meaningful to that
|
||||||
|
file. Any application that links in that file will get the flags, and
|
||||||
|
the gflags library will automatically handle that
|
||||||
|
flag appropriately.</p>
|
||||||
|
|
||||||
|
<p>There's significant gain in flexibility, and ease of code reuse,
|
||||||
|
due to this technique. However, there is a danger that two files will
|
||||||
|
define the same flag, and then give an error when they're linked
|
||||||
|
together.</p>
|
||||||
|
|
||||||
|
<p>The rest of this document describes how to use the commandlineflag
|
||||||
|
library. It's a C++ library, so examples are in C++. However, there
|
||||||
|
is a Python port with the same functionality, and this discussion
|
||||||
|
translates directly to Python.</p>
|
||||||
|
|
||||||
|
<h2> <A NAME=download>Download and Installation</A> </h2>
|
||||||
|
|
||||||
|
<p>The gflags library can be downloaded from <A href="https://github.com/gflags/gflags">GitHub</A>.
|
||||||
|
You can clone the project using the command:</p>
|
||||||
|
<pre>
|
||||||
|
git clone https://github.com/gflags/gflags.git
|
||||||
|
</pre>
|
||||||
|
<p>Build and installation instructions are provided in the
|
||||||
|
<A href="https://github.com/gflags/gflags/blob/master/INSTALL.md">INSTALL</A> file.
|
||||||
|
The installation of the gflags package includes configuration files for popular build systems
|
||||||
|
such as <A href="https://www.freedesktop.org/wiki/Software/pkg-config/">pkg-config</A>,
|
||||||
|
<A href="#cmake">CMake</A>, and <A href="#bazel">Bazel</A>.</p>
|
||||||
|
|
||||||
|
|
||||||
|
<h2> <A name=cmake>Declare dependency on gflags with CMake</A></h2>
|
||||||
|
|
||||||
|
<p>Using gflags within a project which uses <A href="http://www.cmake.org">CMake</A> for its build system is easy.
|
||||||
|
You can either require an external installation of the gflags package and find it using CMake's find_package
|
||||||
|
command, or include the gflags project as subtree or submodule within your project's source tree and add the directory
|
||||||
|
using CMake's add_subdirectory command.
|
||||||
|
|
||||||
|
<p>To use an external gflags installation, add the following CMake code to your <code>CMakeLists.txt</code> file.</p>
|
||||||
|
|
||||||
|
<p>Find gflags installation. The <code>gflags_DIR</code> variable must be set to the <prefix>/lib/cmake/gflags directory
|
||||||
|
containing the gflags-config.cmake file if <prefix> is a non-standard location. Otherwise, CMake should find
|
||||||
|
the gflags installation automatically.</p>
|
||||||
|
<pre>
|
||||||
|
find_package(gflags REQUIRED)
|
||||||
|
</pre>
|
||||||
|
<p>To request a particular imported gflags library target to link against, use the <code>COMPONENTS</code> option of
|
||||||
|
the find_package command. For example, to force the use of the single-threaded static library, use the command</p>
|
||||||
|
<pre>
|
||||||
|
find_package(gflags COMPONENTS nothreads_static)
|
||||||
|
</pre>
|
||||||
|
<p>Note that this will raise a fatal error when the installed gflags package does not contain the requested library.
|
||||||
|
It is therefore recommended to only specify the particular component to look for if a specific library must be used.
|
||||||
|
Otherwise, the gflags-config.cmake module will choose a suitable and available library for you. By default, the
|
||||||
|
multi-threaded gflags library with shared linkage is chosen if available.</p>
|
||||||
|
|
||||||
|
<p>When the source tree of the gflags project is included as subtree or submodule in the "gflags" directory of your project,
|
||||||
|
replace the above find_package command by <code>add_subdirectory(gflags)</code>. See the top of the <code>gflags/CMakeLists.txt</code>
|
||||||
|
file for a listing of available CMake variables that can be set before this command to configure the build of the
|
||||||
|
gflags library. The default build settings are the build of a single-threaded static library which does not require
|
||||||
|
any installation of the gflags subproject products.</p>
|
||||||
|
|
||||||
|
<p>Finally, add your executable build target which uses gflags to parse the command arguments with dependency on the
|
||||||
|
imported gflags library target:</p>
|
||||||
|
<pre>
|
||||||
|
add_executable(foo main.cc)
|
||||||
|
target_link_libraries(foo gflags::gflags)
|
||||||
|
</pre>
|
||||||
|
|
||||||
|
<h2> <A name=bazel>Declare dependency on gflags with Bazel</A></h2>
|
||||||
|
|
||||||
|
<p>To use gflags within a project which uses <A href="https://bazel.build/">Bazel</A> as build tool,
|
||||||
|
add the following lines to your <code>WORKSPACE</code> file
|
||||||
|
(see also Bazel documentation of <A href="https://www.bazel.io/versions/master/docs/be/workspace.html#git_repository">git_repository</A>):
|
||||||
|
|
||||||
|
<pre>
|
||||||
|
git_repository(
|
||||||
|
name = "com_github_gflags_gflags",
|
||||||
|
remote = "https://github.com/gflags/gflags.git",
|
||||||
|
tag = "v2.2.2"
|
||||||
|
)
|
||||||
|
</pre>
|
||||||
|
|
||||||
|
<p>You can then add <code>@com_github_gflags_gflags//:gflags</code> to the <code>deps</code> section of a
|
||||||
|
<code>cc_binary</code> or <code>cc_library</code> rule, and <code>#include "gflags/gflags.h"</code> to
|
||||||
|
include it in your source code. This uses the shared gflags library with multi-threading enabled.
|
||||||
|
In order to use the single-threaded shared gflags library, use the dependency
|
||||||
|
<code>@com_github_gflags_gflags//:gflags_nothreads</code> instead.</p>
|
||||||
|
|
||||||
|
<p>For example, see the following <code>BUILD</code> rule of the gflags/example project:</p>
|
||||||
|
|
||||||
|
<pre>
|
||||||
|
cc_binary(
|
||||||
|
name = "foo",
|
||||||
|
srcs = ["main.cc"],
|
||||||
|
deps = ["@com_github_gflags_gflags//:gflags"],
|
||||||
|
)
|
||||||
|
</pre>
|
||||||
|
|
||||||
|
<h2> <A name=define>DEFINE: Defining Flags In Program</A> </h2>
|
||||||
|
|
||||||
|
<p> Defining a flag is easy: just use the appropriate macro for the
|
||||||
|
type you want the flag to be, as defined at the bottom of
|
||||||
|
<code>gflags/gflags.h</code>. Here's an example file,
|
||||||
|
<code>foo.cc</code>:</p>
|
||||||
|
|
||||||
|
<pre>
|
||||||
|
#include <gflags/gflags.h>
|
||||||
|
|
||||||
|
DEFINE_bool(big_menu, true, "Include 'advanced' options in the menu listing");
|
||||||
|
DEFINE_string(languages, "english,french,german",
|
||||||
|
"comma-separated list of languages to offer in the 'lang' menu");
|
||||||
|
</pre>
|
||||||
|
|
||||||
|
<p><code>DEFINE_bool</code> defines a boolean flag. Here are the
|
||||||
|
types supported:</p>
|
||||||
|
<ul>
|
||||||
|
<li> <code>DEFINE_bool</code>: boolean
|
||||||
|
<li> <code>DEFINE_int32</code>: 32-bit integer
|
||||||
|
<li> <code>DEFINE_int64</code>: 64-bit integer
|
||||||
|
<li> <code>DEFINE_uint64</code>: unsigned 64-bit integer
|
||||||
|
<li> <code>DEFINE_double</code>: double
|
||||||
|
<li> <code>DEFINE_string</code>: C++ string
|
||||||
|
</ul>
|
||||||
|
|
||||||
|
<p>Note that there are no 'complex' types like lists: the "languages"
|
||||||
|
flag in our example is a list of strings, but is defined of type
|
||||||
|
"string", not "list_of_string" or similar. This is by design. We'd
|
||||||
|
rather use only simple types for the flags, and allow for complex,
|
||||||
|
arbitrary parsing routines to parse them, than to try to put the logic
|
||||||
|
inside the flags library proper.</p>
|
||||||
|
|
||||||
|
<p>All DEFINE macros take the same three arguments: the name of the
|
||||||
|
flag, its default value, and a 'help' string that describes its use.
|
||||||
|
The 'help' string is displayed when the user runs the application with
|
||||||
|
the <A HREF="#special"><code>--help</code> flag</A>.</p>
|
||||||
|
|
||||||
|
<p>You can define a flag in any source-code file in your executable.
|
||||||
|
Only define a flag once! If you want to access a flag in more than
|
||||||
|
one source file, DEFINE it in one file, and <A
|
||||||
|
HREF="#declare">DECLARE</A> it in the others. Even better, DEFINE it
|
||||||
|
in <code>foo.cc</code> and DECLARE it in <code>foo.h</code>; then
|
||||||
|
everyone who <code>#includes foo.h</code> can use the flag.</p>
|
||||||
|
|
||||||
|
<p>
|
||||||
|
Defining flags in libraries rather than in main() is powerful, but
|
||||||
|
does have some costs. One is that a library might not have a good
|
||||||
|
default value for its flags, for example if the flag holds a
|
||||||
|
filename that might not exist in some environments. To mitigate such problems,
|
||||||
|
you can use <a href="#validate">flag validators</a> to ensure prompt
|
||||||
|
notification (in the form of a crash) of an invalid flag value.
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<p>Note that while most functions in this library are defined in the
|
||||||
|
<code>google</code> namespace, <code>DEFINE_foo</code> (and
|
||||||
|
<code>DECLARE_foo</code>, <A HREF="#declare">below</A>), should always
|
||||||
|
be in the global namespace.</p>
|
||||||
|
|
||||||
|
|
||||||
|
<h2> <A name=using>Accessing the Flag</A> </h2>
|
||||||
|
|
||||||
|
<p>All defined flags are available to the program as just a normal
|
||||||
|
variable, with the prefix <code>FLAGS_</code> prepended. In the above
|
||||||
|
example, the macros define two variables, <code>FLAGS_big_menu</code>
|
||||||
|
(a bool), and <code>FLAGS_languages</code> (a C++ string).</p>
|
||||||
|
|
||||||
|
<p>You can read and write to the flag just like any other
|
||||||
|
variable:</p>
|
||||||
|
<pre>
|
||||||
|
if (FLAGS_consider_made_up_languages)
|
||||||
|
FLAGS_languages += ",klingon"; // implied by --consider_made_up_languages
|
||||||
|
if (FLAGS_languages.find("finnish") != string::npos)
|
||||||
|
HandleFinnish();
|
||||||
|
</pre>
|
||||||
|
|
||||||
|
<p>You can also get and set flag values via special functions in
|
||||||
|
<code>gflags.h</code>. That's a rarer use case, though.</p>
|
||||||
|
|
||||||
|
|
||||||
|
<h2> <A name=declare>DECLARE: Using the Flag in a Different File</A> </h2>
|
||||||
|
|
||||||
|
<p>Accessing a flag in the manner of the previous section only works
|
||||||
|
if the flag was <code>DEFINE</code>-ed at the top of the file. If it
|
||||||
|
wasn't, you'll get an 'unknown variable' error.</p>
|
||||||
|
|
||||||
|
<p>The <code>DECLARE_type</code> macro is available when you want to
|
||||||
|
use a flag that's defined in another file. For instance, if I were
|
||||||
|
writing <code>bar.cc</code> but wanted to access the big_menu, flag, I
|
||||||
|
would put this near the top of <code>bar.cc</code>:</p>
|
||||||
|
<pre>
|
||||||
|
DECLARE_bool(big_menu);
|
||||||
|
</pre>
|
||||||
|
|
||||||
|
<p>This is functionally equivalent to saying <code>extern
|
||||||
|
FLAGS_big_menu</code>.</p>
|
||||||
|
|
||||||
|
<p>Note that such an extern declaration introduces a dependency
|
||||||
|
between your file and the file that defines the <code>big_menu</code>
|
||||||
|
flag: <code>foo.cc</code>, in this case. Such implicit dependencies
|
||||||
|
can be difficult to manage in large projects. For that reason we
|
||||||
|
recommend the following guideline:</p>
|
||||||
|
|
||||||
|
<blockquote>
|
||||||
|
If you DEFINE a flag in <code>foo.cc</code>, either don't DECLARE it
|
||||||
|
at all, only DECLARE it in tightly related tests, or only DECLARE
|
||||||
|
it in <code>foo.h</code>.
|
||||||
|
</blockquote>
|
||||||
|
|
||||||
|
<p>You should go the do-not-DECLARE route when the flag is only needed
|
||||||
|
by <code>foo.cc</code>, and not in any other file. If you want to
|
||||||
|
modify the value of the flag in the related test file to see if it is
|
||||||
|
functioning as expected, DECLARE it in the <code>foo_test.cc</code>
|
||||||
|
file.
|
||||||
|
|
||||||
|
<p>If the flag does span multiple files, DECLARE it in the associated
|
||||||
|
<code>.h</code> file, and make others <code>#include</code> that
|
||||||
|
<code>.h</code> file if they want to access the flag. The
|
||||||
|
<code>#include</code> will make explicit the dependency between the
|
||||||
|
two files. This causes the flag to be a global variable.</p>
|
||||||
|
|
||||||
|
|
||||||
|
<h2> <A name=validate>RegisterFlagValidator: Sanity-checking Flag Values</A> </h2>
|
||||||
|
|
||||||
|
<p>After DEFINE-ing a flag, you may optionally register a validator
|
||||||
|
function with the flag. If you do this, after the flag is parsed from
|
||||||
|
the commandline, and whenever its value is changed via a call to
|
||||||
|
<code>SetCommandLineOption()</code>, the validator function is called
|
||||||
|
with the new value as an argument. The validator function should
|
||||||
|
return 'true' if the flag value is valid, and false otherwise.
|
||||||
|
If the function returns false for the new setting of the
|
||||||
|
flag, the flag will retain its current value. If it returns false for the
|
||||||
|
default value, ParseCommandLineFlags will die.
|
||||||
|
|
||||||
|
<p>Here is an example use of this functionality:</p>
|
||||||
|
<pre>
|
||||||
|
static bool ValidatePort(const char* flagname, int32 value) {
|
||||||
|
if (value > 0 && value < 32768) // value is ok
|
||||||
|
return true;
|
||||||
|
printf("Invalid value for --%s: %d\n", flagname, (int)value);
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
DEFINE_int32(port, 0, "What port to listen on");
|
||||||
|
DEFINE_validator(port, &ValidatePort);
|
||||||
|
</pre>
|
||||||
|
|
||||||
|
<p>By doing the registration at global initialization time (right
|
||||||
|
after the DEFINE_int32), we ensure that the registration happens before
|
||||||
|
the commandline is parsed at the beginning of <code>main()</code>.</p>
|
||||||
|
|
||||||
|
<p>The above used <code>DEFINE_validator</code> macro calls the
|
||||||
|
<code>RegisterFlagValidator()</code> function which returns true if the
|
||||||
|
registration is successful. It returns false if the registration fails
|
||||||
|
because a) the first argument does not refer to a commandline flag, or
|
||||||
|
b) a different validator has already been registered for this flag.
|
||||||
|
The return value is available as global static boolean variable named
|
||||||
|
<code><flag>_validator_registered</code>.</p>
|
||||||
|
|
||||||
|
|
||||||
|
<h2> <A name=together>Putting It Together: How to Set Up Flags</A> </h2>
|
||||||
|
|
||||||
|
<p>The final piece is the one that tells the executable to process the
|
||||||
|
commandline flags, and set the <code>FLAGS_*</code> variables to the
|
||||||
|
appropriate, non-default value based on what is seen on the
|
||||||
|
commandline. This is equivalent to the <code>getopt()</code> call in
|
||||||
|
the getopt library, but has much less overhead to use. In fact, it's
|
||||||
|
just a single function call:</p>
|
||||||
|
|
||||||
|
<pre>
|
||||||
|
gflags::ParseCommandLineFlags(&argc, &argv, true);
|
||||||
|
</pre>
|
||||||
|
|
||||||
|
<p>Usually, this code is at the beginning of <code>main()</code>.
|
||||||
|
<code>argc</code> and <code>argv</code> are exactly as passed in to
|
||||||
|
<code>main()</code>. This routine might modify them, which is why
|
||||||
|
pointers to them are passed in.</p>
|
||||||
|
|
||||||
|
<p>The last argument is called "remove_flags". If true, then
|
||||||
|
<code>ParseCommandLineFlags</code> removes the flags and their
|
||||||
|
arguments from <code>argv</code>, and modifies <code>argc</code>
|
||||||
|
appropriately. In this case, after the function call,
|
||||||
|
<code>argv</code> will hold only commandline arguments, and not
|
||||||
|
commandline flags.</p>
|
||||||
|
|
||||||
|
<p>If, on the other hand, <code>remove_flags</code> is false, then
|
||||||
|
<code>ParseCommandLineFlags</code> will leave argc unchanged, but will
|
||||||
|
rearrange the arguments in argv so that the flags are all at the
|
||||||
|
beginning. For example, if the input is <code>"/bin/foo" "arg1" "-q"
|
||||||
|
"arg2"</code> (which is legal but weird), the function will rearrange
|
||||||
|
<code>argv</code> so it reads <code>"/bin/foo", "-q", "arg1",
|
||||||
|
"arg2"</code>. In this case, <code>ParseCommandLineFlags</code>
|
||||||
|
returns the index into argv that holds the first commandline argument:
|
||||||
|
that is, the index past the last flag. (In this example, it would
|
||||||
|
return 2, since <code>argv[2]</code> points to <code>arg1</code>.)</p>
|
||||||
|
|
||||||
|
<p>In either case, the <code>FLAGS_*</code> variables are modified
|
||||||
|
based on what was <A HREF="#commandline">passed in on the
|
||||||
|
commandline</A>.</p>
|
||||||
|
|
||||||
|
|
||||||
|
<h2> <A name=commandline>Setting Flags on the Command Line</A> </h2>
|
||||||
|
|
||||||
|
<p>The reason you make something a flag instead of a compile-time
|
||||||
|
constant, is so users can specify a non-default value on the
|
||||||
|
commandline. Here's how they might do it for an application that
|
||||||
|
links in <code>foo.cc</code>:</p>
|
||||||
|
<pre>
|
||||||
|
app_containing_foo --nobig_menu -languages="chinese,japanese,korean" ...
|
||||||
|
</pre>
|
||||||
|
|
||||||
|
<p>This sets <code>FLAGS_big_menu = false;</code> and
|
||||||
|
<code>FLAGS_languages = "chinese,japanese,korean"</code>, when
|
||||||
|
<code>ParseCommandLineFlags</code> is run.</p>
|
||||||
|
|
||||||
|
<p>Note the atypical syntax for setting a boolean flag to false:
|
||||||
|
putting "no" in front of its name. There's a fair bit of flexibility
|
||||||
|
to how flags may be specified. Here's an example of all the ways to
|
||||||
|
specify the "languages" flag:</p>
|
||||||
|
<ul>
|
||||||
|
<li> <code>app_containing_foo --languages="chinese,japanese,korean"</code>
|
||||||
|
<li> <code>app_containing_foo -languages="chinese,japanese,korean"</code>
|
||||||
|
<li> <code>app_containing_foo --languages "chinese,japanese,korean"</code>
|
||||||
|
<li> <code>app_containing_foo -languages "chinese,japanese,korean"</code>
|
||||||
|
</ul>
|
||||||
|
|
||||||
|
<p>For boolean flags, the possibilities are slightly different:</p>
|
||||||
|
<ul>
|
||||||
|
<li> <code>app_containing_foo --big_menu</code>
|
||||||
|
<li> <code>app_containing_foo --nobig_menu</code>
|
||||||
|
<li> <code>app_containing_foo --big_menu=true</code>
|
||||||
|
<li> <code>app_containing_foo --big_menu=false</code>
|
||||||
|
</ul>
|
||||||
|
<p>(as well as the single-dash variant on all of these).</p>
|
||||||
|
|
||||||
|
<p>Despite this flexibility, we recommend using only a single form:
|
||||||
|
<code>--variable=value</code> for non-boolean flags, and
|
||||||
|
<code>--variable/--novariable</code> for boolean flags. This
|
||||||
|
consistency will make your code more readable, and is also the format
|
||||||
|
required for certain special-use cases like <A
|
||||||
|
HREF="#flagfiles">flagfiles</A>.</p>
|
||||||
|
|
||||||
|
<p>It is a fatal error to specify a flag on the commandline that has
|
||||||
|
not been DEFINED somewhere in the executable. If you need that
|
||||||
|
functionality for some reason -- say you want to use the same set of
|
||||||
|
flags for several executables, but not all of them DEFINE every flag
|
||||||
|
in your list -- you can specify <A
|
||||||
|
HREF="#special"><code>--undefok</code></A> to suppress the error.</p>
|
||||||
|
|
||||||
|
<p>As in getopt(), <code>--</code> by itself will terminate flags
|
||||||
|
processing. So in <code>foo -f1 1 -- -f2 2</code>, <code>f1</code> is
|
||||||
|
considered a flag, but <code>-f2</code> is not.</p>
|
||||||
|
|
||||||
|
<p>If a flag is specified more than once, only the last specification
|
||||||
|
is used; the others are ignored.</p>
|
||||||
|
|
||||||
|
<p>Note that flags do not have single-letter synonyms, like they do in
|
||||||
|
the getopt library, nor do we allow "combining" flags behind a
|
||||||
|
single dash, as in <code>ls -la</code>.</p>
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
<h2> <A name=default>Changing the Default Flag Value</A> </h2>
|
||||||
|
|
||||||
|
<p>Sometimes a flag is defined in a library, and you want to change
|
||||||
|
its default value in one application but not others. It's simple to
|
||||||
|
do this: just assign a new value to the flag in <code>main()</code>,
|
||||||
|
before calling <code>ParseCommandLineFlags()</code>:</p>
|
||||||
|
<pre>
|
||||||
|
DECLARE_bool(lib_verbose); // mylib has a lib_verbose flag, default is false
|
||||||
|
int main(int argc, char** argv) {
|
||||||
|
FLAGS_lib_verbose = true; // in my app, I want a verbose lib by default
|
||||||
|
ParseCommandLineFlags(...);
|
||||||
|
}
|
||||||
|
</pre>
|
||||||
|
|
||||||
|
<p>For this application, users can still set the flag value on the
|
||||||
|
commandline, but if they do not, the flag's value will default to
|
||||||
|
true.</p>
|
||||||
|
|
||||||
|
|
||||||
|
<h2> <A name="special">Special Flags</a> </h2>
|
||||||
|
|
||||||
|
<p>There are a few flags defined by the commandlineflags module
|
||||||
|
itself, and are available to all applications that use
|
||||||
|
commandlineflags. These fall into
|
||||||
|
three categories. First are the 'reporting' flags that, when found, cause
|
||||||
|
the application to print some information about itself and exit.</p>
|
||||||
|
|
||||||
|
<table><tr valign=top>
|
||||||
|
<td><code>--help</code></td>
|
||||||
|
<td>shows all flags from all files, sorted by file and then by name;
|
||||||
|
shows the flagname, its default value, and its help string</td>
|
||||||
|
</tr><tr valign=top>
|
||||||
|
<td><code>--helpfull</code></td>
|
||||||
|
<td>same as -help, but unambiguously asks for all flags
|
||||||
|
(in case -help changes in the future)</td>
|
||||||
|
</tr><tr valign=top>
|
||||||
|
<td><code>--helpshort</code></td>
|
||||||
|
<td>shows only flags for the file with the same name as the executable
|
||||||
|
(usually the one containing <code>main()</code>)</td>
|
||||||
|
</tr><tr valign=top>
|
||||||
|
<td><code>--helpxml</code></td>
|
||||||
|
<td>like --help, but output is in xml for easier parsing</td>
|
||||||
|
</tr><tr valign=top>
|
||||||
|
<td><code>--helpon=FILE </code></td>
|
||||||
|
<td>shows only flags defined in FILE.*</td>
|
||||||
|
</tr><tr valign=top>
|
||||||
|
<td><code>--helpmatch=S</code></td>
|
||||||
|
<td>shows only flags defined in *S*.*</td>
|
||||||
|
</tr><tr valign=top>
|
||||||
|
<td><code>--helppackage</code></td>
|
||||||
|
<td>shows flags defined in files in same directory as <code>main()</code></td>
|
||||||
|
</tr><tr valign=top>
|
||||||
|
<td><code>--version</code></td>
|
||||||
|
<td>prints version info for the executable</td>
|
||||||
|
</tr></table>
|
||||||
|
|
||||||
|
<p>Second are the flags that affect how other flags are parsed.</p>
|
||||||
|
|
||||||
|
<table><tr valign=top>
|
||||||
|
<td><code>--undefok=flagname,flagname,...</code></td>
|
||||||
|
<td>for those names listed as the argument to <code>--undefok</code>,
|
||||||
|
suppress the normal error-exit that occurs when
|
||||||
|
<code>--name</code> is seen on the commandline, but
|
||||||
|
<code>name</code> has not been DEFINED anywhere in the
|
||||||
|
application
|
||||||
|
</table>
|
||||||
|
|
||||||
|
<p>Third are the 'recursive' flags, that cause other flag values to be
|
||||||
|
set: <code>--fromenv</code>, <code>--tryfromenv</code>,
|
||||||
|
<code>--flagfile</code>. These are described below in more
|
||||||
|
detail.</p>
|
||||||
|
|
||||||
|
<h3> <code>--fromenv</code> </h3>
|
||||||
|
|
||||||
|
<p><code>--fromenv=foo,bar</code> says to read the values for the
|
||||||
|
<code>foo</code> and <code>bar</code> flags from the environment.
|
||||||
|
In concert with this flag, you must actually set the values in the
|
||||||
|
environment, via a line like one of the two below:</p>
|
||||||
|
<pre>
|
||||||
|
export FLAGS_foo=xxx; export FLAGS_bar=yyy # sh
|
||||||
|
setenv FLAGS_foo xxx; setenv FLAGS_bar yyy # tcsh
|
||||||
|
</pre>
|
||||||
|
<p>This is equivalent to specifying <code>--foo=xxx</code>,
|
||||||
|
<code>--bar=yyy</code> on the commandline.</p>
|
||||||
|
|
||||||
|
<p>Note it is a fatal error to say <code>--fromenv=foo</code> if
|
||||||
|
<code>foo</code> is not DEFINED somewhere in the application. (Though
|
||||||
|
you can suppress this error via <code>--undefok=foo</code>, just like
|
||||||
|
for any other flag.)</p>
|
||||||
|
|
||||||
|
<p>It is also a fatal error to say <code>--fromenv=foo</code> if
|
||||||
|
<code>FLAGS_foo</code> is not actually defined in the environment.</p>
|
||||||
|
|
||||||
|
<h3> <code>--tryfromenv</code> </h3>
|
||||||
|
|
||||||
|
<p><code>--tryfromenv</code> is exactly like <code>--fromenv</code>,
|
||||||
|
except it is <b>not</b> a fatal error to say
|
||||||
|
<code>--tryfromenv=foo</code> if <code>FLAGS_foo</code> is not
|
||||||
|
actually defined in the environment. Instead, in such cases,
|
||||||
|
<code>FLAGS_foo</code> just keeps its default value as specified in
|
||||||
|
the application.</p>
|
||||||
|
|
||||||
|
<p>Note it is still an error to say <code>--tryfromenv=foo</code> if
|
||||||
|
<code>foo</code> is not DEFINED somewhere in the application.</p>
|
||||||
|
|
||||||
|
<h3> <code>--flagfile</code> </h3>
|
||||||
|
|
||||||
|
<p><code>--flagfile=f</code> tells the commandlineflags module to read
|
||||||
|
the file <code>f</code>, and to run all the flag-assignments found in
|
||||||
|
that file as if these flags had been specified on the commandline.</p>
|
||||||
|
|
||||||
|
<p>In its simplest form, <code>f</code> should just be a list of flag
|
||||||
|
assignments, one per line. Unlike on the commandline, the equals sign
|
||||||
|
separating a flagname from its argument is <i>required</i> for
|
||||||
|
flagfiles. An example flagfile, <code>/tmp/myflags</code>:</p>
|
||||||
|
<pre>
|
||||||
|
--nobig_menus
|
||||||
|
--languages=english,french
|
||||||
|
</pre>
|
||||||
|
|
||||||
|
<p>With this flagfile, the following two lines are equivalent:<p>
|
||||||
|
<pre>
|
||||||
|
./myapp --foo --nobig_menus --languages=english,french --bar
|
||||||
|
./myapp --foo --flagfile=/tmp/myflags --bar
|
||||||
|
</pre>
|
||||||
|
|
||||||
|
<p>Note that many errors are silently suppressed in flagfiles. In
|
||||||
|
particular, unrecognized flagnames are silently ignored, as are flags
|
||||||
|
that are missing a required value (e.g., a flagfile that just says
|
||||||
|
<code>--languages</code>).</p>
|
||||||
|
|
||||||
|
<p>The general format of a flagfile is a bit more complicated than the
|
||||||
|
simple, common case above. It is: a sequence of filenames, one per
|
||||||
|
line, followed by a sequence of flags, one per line, repeated as many
|
||||||
|
times as desired. Filenames in a flagfile can use wildcards
|
||||||
|
(<code>*</code> and <code>?</code>), and the sequence of flags located
|
||||||
|
after a sequence of filenames is processed only if the current
|
||||||
|
executable's name matches one of the filenames. It is possible to
|
||||||
|
start the flagfile with a sequence of flags instead of a sequence of
|
||||||
|
filenames; if such a sequence of flags is present, these flags are
|
||||||
|
applied to the current executable no matter what it is.</p>
|
||||||
|
|
||||||
|
<p>Lines that start with a <code>#</code> are ignored as comments.
|
||||||
|
Leading whitespace is also ignored in flagfiles, as are blank
|
||||||
|
lines.</p>
|
||||||
|
|
||||||
|
<p>It is possible for a flagfile to use the <code>--flagfile</code>
|
||||||
|
flag to include another flagfile.</p>
|
||||||
|
|
||||||
|
<p>Flags are always processed in the expected order. That is,
|
||||||
|
processing begins by examining the flags specified directly on the
|
||||||
|
command line. If a flagfile is specified, its contents are processed,
|
||||||
|
and then processing continues with remaining flags from the command
|
||||||
|
line.</p>
|
||||||
|
|
||||||
|
|
||||||
|
<h2> <A name="api">The API</a> </h2>
|
||||||
|
|
||||||
|
<p>In addition to accessing <code>FLAGS_foo</code> directly, it is
|
||||||
|
possible to access the flags programmatically, through an API. It is
|
||||||
|
also possible to access information about a flag, such as its default
|
||||||
|
value and help-string. A <code>FlagSaver</code> makes it easy to
|
||||||
|
modify flags and then automatically undo the modifications later.
|
||||||
|
Finally, there are somewhat unrelated, but useful, routines to easily
|
||||||
|
access parts of <code>argv</code> outside main, including the program
|
||||||
|
name (<code>argv[0]</code>).</p>
|
||||||
|
|
||||||
|
<p>For more information about these routines, and other useful helper
|
||||||
|
methods such as <code>gflags::SetUsageMessage()</code> and
|
||||||
|
<code>gflags::SetVersionString</code>, see <code>gflags.h</code>.</p>
|
||||||
|
|
||||||
|
|
||||||
|
<h2> <A name="misc">Miscellaneous Notes</code> </h2>
|
||||||
|
|
||||||
|
<p>If your application has code like this:</p>
|
||||||
|
<pre>
|
||||||
|
#define STRIP_FLAG_HELP 1 // this must go before the #include!
|
||||||
|
#include <gflags/gflags.h>
|
||||||
|
</pre>
|
||||||
|
<p>we will remove the help messages from the compiled source. This can
|
||||||
|
reduce the size of the resulting binary somewhat, and may also be
|
||||||
|
useful for security reasons.</p>
|
||||||
|
|
||||||
|
<h2> <A name="issues">Issues and Feature Requests</code> </h2>
|
||||||
|
|
||||||
|
<p>Please report any issues or ideas for additional features on <A href="https://github.com/gflags/gflags/issues">GitHub</A>.
|
||||||
|
We would also like to encourage <A href="https://github.com/gflags/gflags/pulls">pull requests</A> for bug fixes and implementations of new features.</p>
|
||||||
|
|
||||||
|
<hr>
|
||||||
|
<address>
|
||||||
|
Craig Silverstein, Andreas Schuh<br>
|
||||||
|
<script type=text/javascript>
|
||||||
|
var lm = new Date(document.lastModified);
|
||||||
|
document.write(lm.toDateString());
|
||||||
|
</script>
|
||||||
|
</address>
|
||||||
|
|
||||||
|
</body>
|
||||||
|
</html>
|
||||||
Loading…
Reference in New Issue
Block a user