astbuildprog1
Compile, link with gnuastro library and its dependencies, and run a c program
Usage
astbuildprog [OPTION ...]
C-source
[ARGUMENTS
TO
RUN]
Overview
BuildProgram is part of GNU Astronomy Utilities 0.19. BuildProgram will compile and run a C program, while automatically linking with libraries that Gnuastro depends on. Hence you do not have to worry about explicitly linking with CFITSIO for example if you want to work on a FITS file, or with GSL if you want to use GNU Scientific Library's functions. The standard compiler options of '-I', '-L', and '-l' are also available for further customization of the build.
For more information, please run any of the following commands. In particular the second contains a very comprehensive explanation of BuildProgram's invocation: expected input(s), output(s), and a full description of all the options.
All options and their values:
|
$ astbuildprog |
|---|---|
Inputs/Outputs and options:
|
$ info astbuildprog |
Full section in manual/book:
|
$ info BuildProgram |
Full Gnuastro manual/book:
|
$ info gnuastro |
If you couldn't find your answer in the manual, you can get direct help from experienced Gnuastro users and developers. For more information, please run:
-
$ info help-gnuastro
BuildProgram options:
-
Input:
-
-a, --la=STR -
Libtool '.la' to use instead of default.
-
-c, --cc=STR -
Name of C compiler's executable.
-
-e, --noenv -
No env. (e.g., LDFLAGS or CPPFLAGS) in build.
-
-I, --includedir=STR -
Directories to search for '#include's.
-
-l, --linklib=STR -
Link libraries, e.g., for libgsl: '-lgsl'.
-
-L, --linkdir=STR -
Directory to search for libraries to link.
-
-t, --tag=STR -
Libtool '--tag': programming language.
-
Output:
-
-b, --onlybuild -
Don't run the built program.
-
-d, --deletecompiled -
Delete compiled program after running.
-
-D, --dontdelete -
Don't delete output if it exists.
-
-g, --debug -
Debugging information in compiled binary.
-
-K, --keepinputdir -
Keep input directory for automatic output.
-
-o, --output=STR -
Output file name.
-
-O, --optimize=INT -
Optimization level: 0, 1, 2, 3.
-
-W, --warning=STR -
Compilation warnings on command-line.
-
Operating modes:
-
-?, --help -
give this help list
-
--checkconfig -
List all config files and variables read.
-
--cite -
BibTeX citation for this program.
-
--config=STR -
Read configuration file STR immediately.
-
--lastconfig -
Do not parse any more configuration files.
-
--minmapsize=INT -
Min. bytes to avoid RAM automatically.
-
--onlyversion=STR -
Only run if the program version is STR.
-
-P, --printparams -
Print parameter values to be used and abort.
-
--quietmmap -
Don't print mmap'd file's name and size.
-
-q, --quiet -
Only report errors, remain quiet about steps.
-
-S, --setdirconf -
Set default values for this directory and abort.
-
--usage -
give a short usage message
-
-U, --setusrconf -
Set default values for this user and abort.
-
-V, --version -
print program version
Mandatory or optional arguments to long options are also mandatory or optional for any corresponding short options.
GNU Astronomy Utilities home page: http://www.gnu.org/software/gnuastro/
Releases
3 releases since Debian 10 (Buster); the text changed 2 times.
--cc since Debian 11 (Bullseye);
--checkconfig since Debian 11 (Bullseye);
--minmapsize since Debian 11 (Bullseye);
--noenv since Debian 11 (Bullseye);
--quietmmap since Debian 11 (Bullseye);
-c since Debian 11 (Bullseye);
-e since Debian 11 (Bullseye).