---
name: "astbuildprog"
section: "1"
platform: "linux"
package: "gnuastro"
version: "0.19-1+b2"
release: "Debian 12 (Bookworm)"
platforms: ["linux"]
url: "https://new.carta.tech/astbuildprog"
---

# astbuildprog(1)

compile, link with Gnuastro library and its dependencies, and run a C program

## NAME

BuildProgram - compile, link with Gnuastro library and its dependencies, and run a C program

## SYNOPSIS

**astbuildprog** \[*OPTION*...\] *C-source* \[*ARGUMENTS TO RUN*\]

## DESCRIPTION

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 **-P**

- 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/

## REPORTING BUGS

Report bugs to bug-gnuastro@gnu.org.

## COPYRIGHT

Copyright © 2015-2022 Free Software Foundation, Inc. License GPLv3+: GNU General public license version 3 or later.\
 This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.

Written/developed by Mohammad Akhlaghi

## SEE ALSO

The full documentation for **BuildProgram** is maintained as a Texinfo manual.  If the **info** and **BuildProgram** programs are properly installed at your site, the command

-

  **info BuildProgram**

should give you access to the complete manual.