emo/xbps
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

New manual page for xbps-fbulk(1).

Browse Source
This commit is contained in:
Juan RP
2015-10-28 09:37:09 +01:00
parent d4f1fd56cd
commit 4211f5cd09
14 changed files with 141 additions and 13 deletions
Download Patch File Download Diff File Expand all files Collapse all files

3
bin/xbps-checkvers/xbps-checkvers.1
View File

@@ -1,4 +1,4 @@
.Dd May 16, 2015
.Dd October 28, 2015
.Dt XBPS-CHECKVERS 1
.Sh NAME
.Nm xbps-checkvers
@@ -51,6 +51,7 @@ Shows the XBPS version.
.Sh SEE ALSO
.Xr xbps-create 1 ,
.Xr xbps-dgraph 1 ,
.Xr xbps-fbulk 1 ,
.Xr xbps-install 1 ,
.Xr xbps-pkgdb 1 ,
.Xr xbps-query 1 ,

3
bin/xbps-create/xbps-create.1
View File

@@ -1,4 +1,4 @@
.Dd May 16, 2015
.Dd October 28, 2015
.Dt XBPS-CREATE 1
.Sh NAME
.Nm xbps-create
@@ -84,6 +84,7 @@ A list of required shared libraries, separated by whitespaces. Example:
.Sh SEE ALSO
.Xr xbps-checkvers 1 ,
.Xr xbps-dgraph 1 ,
.Xr xbps-fbulk 1 ,
.Xr xbps-install 1 ,
.Xr xbps-pkgdb 1 ,
.Xr xbps-query 1 ,

3
bin/xbps-dgraph/xbps-dgraph.1
View File

@@ -1,4 +1,4 @@
.Dd May 16, 2015
.Dd October 28, 2015
.Dt XBPS-DGRAPH 1
.Sh NAME
.Nm xbps-dgraph
@@ -125,6 +125,7 @@ Default cache directory to store downloaded binary packages.
.Xr xbps.d 5 ,
.Xr xbps-checkvers 1 ,
.Xr xbps-create 1 ,
.Xr xbps-fbulk 1 ,
.Xr xbps-install 1 ,
.Xr xbps-pkgdb 1 ,
.Xr xbps-query 1 ,

1
bin/xbps-fbulk/Makefile
View File

@@ -2,6 +2,5 @@ TOPDIR = ../..
-include $(TOPDIR)/config.mk
BIN = xbps-fbulk
MAN =
include $(TOPDIR)/mk/prog.mk

7
bin/xbps-fbulk/main.c
View File

@@ -152,7 +152,7 @@ addItem(const char *pkgn)
static void __attribute__((noreturn))
usage(const char *progname)
{
fprintf(stderr, "%s [-a targetarch] [-h] [-j parallel] [-l logdir] "
fprintf(stderr, "%s [-a targetarch] [-h] [-j parallel] [-l logdir] [-V]"
"/path/to/void-packages [pkg pkgN]\n", progname);
exit(EXIT_FAILURE);
}
@@ -552,7 +552,7 @@ main(int argc, char **argv)
{ NULL, 0, NULL, 0 }
};
while ((ch = getopt_long(argc, argv, "a:hj:l:v", longopts, NULL)) != -1) {
while ((ch = getopt_long(argc, argv, "a:hj:l:vV", longopts, NULL)) != -1) {
switch (ch) {
case 'a':
TargetArch = optarg;
@@ -566,6 +566,9 @@ main(int argc, char **argv)
case 'l':
LogDir = optarg;
break;
case 'V':
printf("%s\n", XBPS_RELVER);
exit(EXIT_SUCCESS);
case 'h':
default:
usage(progname);

114
bin/xbps-fbulk/xbps-fbulk.1 Normal file
View File

@@ -0,0 +1,114 @@
.Dd October 28, 2015
.Dt XBPS-FBULK 1
.Sh NAME
.Nm xbps-fbulk
.Nd XBPS utility to perform a fast bulk build of void-packages
.Sh SYNOPSYS
.Nm xbps-fbulk
.Op OPTIONS
.Ar /path/to/void-packages
.Op pkgN pkgN+1 ...
.Sh DESCRIPTION
The
.Nm
utility iterates all srcpkg directories in the
.Xr void-packages
repository or processes the
.Xr pkgN
arguments, and then runs
.Ar ./xbps-src show-build-deps',
to build a dependency tree on the fly.
.Pp
As the dependency tree is being built, terminal dependencies are built
and packaged on the fly.
.Pp
As these builds complete additional dependencies may be satisfied and be
added to the build order. Ultimately the entire tree is built.
.Pp
Only one attempt is made to build any given package, no matter how many
other packages depend on it.
.Sh OPTIONS
.Bl -tag -width -x
.It Fl a Ar arch
Set a different target architecture, useful for cross compiling.
.It Fl j Ar X
Set number of parallel builds running at the same time. By default set to 1.
.It Fl l Ar logdir
Set the log directory. By default set to `log.<pid>`.
.It Fl d, Fl -debug
Enables extra debugging shown to stderr.
.It Fl h, Fl -help
Show the help usage.
.It Fl v, Fl -verbose
Enables verbose messages.
.It Fl V, Fl -version
Shows the XBPS version.
.El
.Sh FILES
.Bl -tag -width logdir/skipped
.It Ar logdir/run
Packages that are being built.
.It Ar logdir/good
Packages that were built successfully.
.It Ar logdir/bad
Packages that failed to build.
.It Ar logdir/skipped
Packages that were not built because they had to be skipped (unsupported architecture, broken or restricted).
.It Ar logdir/deps
Packages that were not built due to missing dependencies.
.El
.Sh NOTES
The
.Ar masterdir
in the
.Ar void-packages
repository must be fully populated for chroot operations, and some options
need to be set in
.Ar etc/conf
to make
.Nm
work correctly:
.Bl -tag -width XBPS_CHROOT_CMD=uchroot
.It Ar XBPS_CHROOT_CMD=uchroot
The
.Xr xbps-uchroot 1
utility is required because
.Nm
builds packages in temporary masterdirs that are mounted with
.Ar overlayfs .
.El
.Pp
Make sure the user running
.Nm
has rights to execute
.Xr xbps-uchroot 1
and the kernel supports the overlay filesystem, introduced in 4.0.
.Pp
.Sh SEE ALSO
.Xr xbps-checkvers 1 ,
.Xr xbps-create 1 ,
.Xr xbps-dgraph 1 ,
.Xr xbps-install 1 ,
.Xr xbps-pkgdb 1 ,
.Xr xbps-query 1 ,
.Xr xbps-reconfigure 1 ,
.Xr xbps-remove 1 ,
.Xr xbps-rindex 1 ,
.Xr xbps-uchroot 1 ,
.Xr xbps-uunshare 1 ,
.Xr xbps.d 5
.Sh AUTHORS
The
.Nm
utility was originally written by
.An Matthew Dillon <dillon@backplane.com>
for the
.Ar DragonFlyBSD project.
.Pp
.An Juan Romero Pardines <xtraeme@gmail.com>
adapted it for xbps and added some new features.
.Sh BUGS
Probably, but I try to make this not happen. Use it under your own
responsability and enjoy your life.
.Pp
Report bugs in https://github.com/voidlinux/xbps/issues

3
bin/xbps-install/xbps-install.1
View File

@@ -1,4 +1,4 @@
.Dd October 20, 2015
.Dd October 28, 2015
.Dt XBPS-INSTALL 1
.Sh NAME
.Nm xbps-install
@@ -150,6 +150,7 @@ Default cache directory to store downloaded binary packages.
.Xr xbps-checkvers 1 ,
.Xr xbps-create 1 ,
.Xr xbps-dgraph 1 ,
.Xr xbps-fbulk 1 ,
.Xr xbps-pkgdb 1 ,
.Xr xbps-query 1 ,
.Xr xbps-reconfigure 1 ,

3
bin/xbps-pkgdb/xbps-pkgdb.1
View File

@@ -1,4 +1,4 @@
.Dd May 16, 2015
.Dd October 28, 2015
.Dt XBPS-PKGDB 1
.Sh NAME
.Nm xbps-pkgdb
@@ -92,6 +92,7 @@ Default cache directory to store downloaded binary packages.
.Xr xbps-checkvers 1 ,
.Xr xbps-create 1 ,
.Xr xbps-dgraph 1 ,
.Xr xbps-fbulk 1 ,
.Xr xbps-install 1 ,
.Xr xbps-query 1 ,
.Xr xbps-reconfigure 1 ,

3
bin/xbps-reconfigure/xbps-reconfigure.1
View File

@@ -1,4 +1,4 @@
.Dd May 16, 2015
.Dd October 28, 2015
.Dt XBPS-RECONFIGURE 1
.Sh NAME
.Nm xbps-reconfigure
@@ -78,6 +78,7 @@ Default cache directory to store downloaded binary packages.
.Xr xbps-checkvers 1 ,
.Xr xbps-create 1 ,
.Xr xbps-dgraph 1 ,
.Xr xbps-fbulk 1 ,
.Xr xbps-install 1 ,
.Xr xbps-pkgdb 1 ,
.Xr xbps-query 1 ,

3
bin/xbps-remove/xbps-remove.1
View File

@@ -1,4 +1,4 @@
.Dd October 20, 2015
.Dd October 28, 2015
.Dt XBPS-REMOVE 1
.Sh NAME
.Nm xbps-remove
@@ -113,6 +113,7 @@ Default cache directory to store downloaded binary packages.
.Xr xbps-checkvers 1 ,
.Xr xbps-create 1 ,
.Xr xbps-dgraph 1 ,
.Xr xbps-fbulk 1 ,
.Xr xbps-install 1 ,
.Xr xbps-pkgdb 1 ,
.Xr xbps-query 1 ,

3
bin/xbps-rindex/xbps-rindex.1
View File

@@ -1,4 +1,4 @@
.Dd June 4, 2015
.Dd October 28, 2015
.Dt XBPS-RINDEX 1
.Sh NAME
.Nm xbps-rindex
@@ -91,6 +91,7 @@ a repository. Otherwise it will ask you to enter the passphrase on the terminal.
.Xr xbps-checkvers 1 ,
.Xr xbps-create 1 ,
.Xr xbps-dgraph 1 ,
.Xr xbps-fbulk 1 ,
.Xr xbps-install 1 ,
.Xr xbps-pkgdb 1 ,
.Xr xbps-query 1 ,

3
bin/xbps-uchroot/xbps-uchroot.1
View File

@@ -1,4 +1,4 @@
.Dd May 16, 2015
.Dd October 28, 2015
.Dt XBPS-UCHROOT 1
.Sh NAME
.Nm xbps-uchroot
@@ -75,6 +75,7 @@ other Operating Systems. The following kernel options must be enabled:
.Xr xbps-checkvers 1 ,
.Xr xbps-create 1 ,
.Xr xbps-dgraph 1 ,
.Xr xbps-fbulk 1 ,
.Xr xbps-install 1 ,
.Xr xbps-pkgdb 1 ,
.Xr xbps-query 1 ,

3
bin/xbps-uunshare/xbps-uunshare.1
View File

@@ -1,4 +1,4 @@
.Dd May 16, 2015
.Dd October 28, 2015
.Dt XBPS-UUNSHARE 1
.Sh NAME
.Nm xbps-uunshare
@@ -54,6 +54,7 @@ other Operating Systems. The following kernel options must be enabled:
.Xr xbps-checkvers 1 ,
.Xr xbps-create 1 ,
.Xr xbps-dgraph 1 ,
.Xr xbps-fbulk 1 ,
.Xr xbps-install 1 ,
.Xr xbps-pkgdb 1 ,
.Xr xbps-query 1 ,