pbuild(1)

1PBUILD(1)                   General Commands Manual                  PBUILD(1)
2
3
4

NAME

6       pbuild - build a project consisting of a set of packages
7
8

SYNOPSIS

10       pbuild [--preset preset] [--dist dist] [--buildjobs num] [dir]
11       pbuild [--preset preset] [--dist dist] --result [--details] [dir]
12
13

DESCRIPTION

15       The pbuild tool builds a project consisting of a set of packages stored
16       in the specified directory dir. If the directory is not specified,  the
17       current working directory is used instead.
18
19       A  package  consists  of  files stored in a directory where the package
20       name is the name of the directory. Directories with names starting with
21       "." or "_" are ignored.
22
23       Pbuild  works  by parsing the recipe files from the packages to get de‐
24       pendency information, sorting the packages by dependency and then  cre‐
25       ating  build  jobs  for  every package that needs to be rebuild. Pbuild
26       stores extra information with the build results so that it is  able  to
27       resume after interruption or integrate new source changes.
28
29       The  results  of  the  package  builds  are stored in a directory "_re‐
30       sult.reponame.arch", where reponame defaults to the name  of  the  base
31       distribution selected with the --dist or --preset options.
32
33       If  Pbuild detects that the specified directory is a package directory,
34       it will automatically go into single-build mode and use the parent  di‐
35       rectory as project directory.
36
37

COMMON OPTIONS

39       --arch arch
40              Build  for  the  specified  architecture.  If this option is not
41              used, pbuild will build for the host architecture.
42
43       --preset preset
44              Use a defined preset to set the distribution config, the reposi‐
45              tories,  and the container registries. Presets can be defined by
46              having a "_pbuild" file in the source directory.
47
48       --dist dist
49              Use the specified distribution  config  dist  to  configure  the
50              build environment.
51
52       --reponame name
53              Use  the  specified  name to generate the directory name used to
54              store the package build results.
55
56

BUILD OPTIONS

58       --repo url
59              Use the specified location to set up the build environment.  The
60              repo  option can be used multiple times to create a search path.
61              Note that the order of the option matters, i.e. the first repos‐
62              itory  containing a package with a specific name wins regardless
63              of the version. If no repo is configured, the default  reposito‐
64              ries specified in the distribution config is used.
65
66       --registry url
67              Use the specified location to search for remote containers.
68
69       --obs url
70              Use the specified url to specify the open build service instance
71              if obs:/ urls need to be resolved.
72
73       --buildjobs num
74              Start up to num processes to build packages in parallel.
75
76       --rebuild-pkg packagename
77              Force a rebuild of the specified package.  This  option  can  be
78              used multiple times.
79
80       --rebuild-code code
81              Force a rebuild of the packages in state "code". This option can
82              be used multiple times.
83
84       --rebuild [code_or_packagename]
85              Short hand form to force a rebuild. If no argument is given, all
86              packages  are  rebuilt.  If the argument is a known result code,
87              packages with a state matching the specified code  are  rebuilt.
88              Otherwise it is assumed that the argument is a package name.
89
90       --single packagename
91              Only  build the specified package. This option also forces a re‐
92              build of the package.
93
94       --vm-...
95       --jobs
96       --threads
97       --xen, --kvm, ...
98       --no-checks
99       --no-clean
100       --target
101              This options are passed on to the call of the build tool used to
102              build packages.
103
104

QUERY OPTIONS

106       --result-pkg packagename
107              Only  show  build results for the specified package. This option
108              can be used multiple times.
109
110       --result-code code
111              Only show build results for builds that resulted in  the  speci‐
112              fied code.  This option can be used multiple times.
113
114       --result [code_or_packagename]
115              This is a short hand form for result querying. If no argument is
116              given, the results for all packages are shown. If  the  argument
117              is  a  known  result code, builds that resulted in the specified
118              code are shown.  Otherwise it is assumed that the argument is  a
119              package name.
120
121       --terse
122              Do not show detailed information about the package state.
123
124

MISC OPTIONS

126       --hostarch arch
127              Assume  the  specified host architecture instead of using "uname
128              -m".
129
130       --configdir dir
131              Specify a different directory containing distribution configura‐
132              tions.
133
134       --help Print a short help text.
135
136

RETURN CODES

138       0      When  none  of the builds finished with failure, unresolvable or
139              in broken state
140
141       1      When one or more builds failed, remained unresolvable or in bro‐
142              ken state
143
144