sbopkg/tools/sbopkg8.html

759 lines
15 KiB
HTML
Raw Normal View History

Content-type: text/html
<HTML><HEAD><TITLE>Manpage of SBOPKG</TITLE>
</HEAD><BODY>
<H1>SBOPKG</H1>
Section: (8)<BR>Updated: October 2015<BR><A HREF="#index">Index</A>
<A HREF="http://localhost/cgi-bin/man/man2html">Return to Main Contents</A><HR>
2010-11-12 05:07:45 +01:00
<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>
2010-11-12 05:07:45 +01:00
sbopkg - the SlackBuilds.org package browser
<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>
<B>sbopkg</B>
2010-11-12 05:07:45 +01:00
[<I>options</I>]
<A NAME="lbAD">&nbsp;</A>
<H2>DESCRIPTION</H2>
2010-11-12 05:07:45 +01:00
<B>Sbopkg</B>
is a command-line and
<B>dialog</B>-based
tool to interact with the SlackBuilds.org (``SBo'') repository, a
collection of third-party SlackBuild scripts to build Slackware
packages.
<A NAME="lbAE">&nbsp;</A>
2010-11-12 05:07:45 +01:00
<H3>Instructions</H3>
2010-11-12 05:07:45 +01:00
<B>Sbopkg</B>
usage assumes an understanding of SlackBuilds, generally, and the
third-party SBo repository, specifically.
A thorough reading of
<I><A HREF="http://www.slackbuilds.org/howto/">http://www.slackbuilds.org/howto/</A></I>
and the pages at
<I><A HREF="http://www.slackwiki.org">http://www.slackwiki.org</A></I>
about SlackBuilds is strongly advised.
<P>
2010-11-12 05:07:45 +01:00
In order for
<B>sbopkg</B>
to be used, a configuration file must exist at
2011-04-28 05:01:06 +02:00
<I>/etc/sbopkg/sbopkg.conf</I>
2010-11-12 05:07:45 +01:00
2011-04-28 05:01:06 +02:00
and/or
<I>~/.sbopkg.conf</I>.
An initial install will provide the user with the system file while
upgrades will add an
2010-11-12 05:07:45 +01:00
<I>/etc/sbopkg/sbopkg.conf.new</I>
2011-02-05 05:34:55 +01:00
file with which the user may merge or replace the older version.
2010-11-12 05:07:45 +01:00
See
<B><A HREF="http://localhost/cgi-bin/man/man2html?5+sbopkg.conf">sbopkg.conf</A></B>(5)
2011-04-28 05:01:06 +02:00
for more information about the configuration files.
<P>
2010-11-12 05:07:45 +01:00
<B>Sbopkg</B>
must be run as the root user (since the SBo SlackBuilds are written with
the intention of being run as root).
Furthermore, using the
<B>-</B>
option with
<B>su</B>
is strongly encouraged.
The reason is that some SlackBuilds rely on certain tools that are only
available in root's
<B>PATH</B>
when the scripts in
<I>/etc/profile.d</I>
have been run (i.e.,
<B>texmf</B>
to build man pages), which is only done for login shells, or otherwise
require a ``truer'' root environment than that given by only
<B>su</B>.
In any event, invoking
<B>sbopkg</B>
with no arguments (or with just
<B>-d</B>,
<B>-f</B>,
or
<B>-V</B>)
will launch the
<B>dialog</B>-based
interface, and the menus provided should be fairly self-explanatory.
<P>
2010-11-12 05:07:45 +01:00
The main menu allows the user to synchronize with the SBo repository.
This is the first step to take (after configuration) with a new install
of
<B>sbopkg</B>.
Currently, the size of a local copy of the SBo repository is about
about 220MB.
2010-11-12 05:07:45 +01:00
The main menu also allows the user to view the SBo
<I>ChangeLog</I>,
check for potential updates to SBo packages, display the contents of the
local cache directory where source tarballs are saved, display the
permanent build log, and browse or search the local copy of the SBo
repository.
Once the browse function is chosen, the user can select the category of
software to view.
After choosing a category, the user can then view the various software
packages available in that category within the local SBo repository.
Selecting a package will display another menu allowing the user to view
the package's
<I>README</I>,
<I>SlackBuild</I>,
<I>.info</I>,
or
<I>slack-desc</I>
files.
The user can also edit the
<I>.info</I>
file and
<I>SlackBuild</I>
and the edited files will remain after doing a sync.
Additionally, the user can choose to build a package using either the
original
<I>SlackBuild</I>
or the locally-edited one, if present.
If using the
<B>dialog</B>
interface, and if
<B>sbopkg</B>
finds a built package for a particular piece of software in the
<B>OUTPUT</B>
directory, then
<B>sbopkg</B>
will automatically add a new menu entry allowing the user to install the
package if he chooses.
2012-10-04 05:16:56 +02:00
Alternatively, the user can choose to automatically download, build, or
install individual packages or several packages in a queue.
2010-11-12 05:07:45 +01:00
Finally, if
<B>KEEPLOG</B>
is set to
<B>YES</B>
2011-04-28 05:01:06 +02:00
in a configuration file, a permanent log of the build process is saved.
2010-11-12 05:07:45 +01:00
See
<B><A HREF="http://localhost/cgi-bin/man/man2html?5+sbopkg.conf">sbopkg.conf</A></B>(5)
under
<B>KEEPLOG</B>
and
<B>LOGFILE</B>
for details.
<P>
2010-11-12 05:07:45 +01:00
Alternatively,
<B>sbopkg</B>
can be run from the command line without using the
<B>dialog</B>
interface.
See the
<B>OPTIONS</B>
section for the available command line options.
<P>
2010-11-12 05:07:45 +01:00
<B>Sbopkg</B>
also has the capability of loading, saving, and using user-created
queuefiles.
These queuefiles are simple text files with one application name per
line.
By default, when a queuefile is loaded in the dialog interface, the
application is selected, or ``ON.''
This can be changed by inserting a ``-'' in front of the application
name in the queuefile.
Also, queuefiles can reference other queuefiles when the first character
is an ``@''.
See the
<I>readme-queuefiles</I>
document in the documentation directory for more information.
<P>
2010-11-12 05:07:45 +01:00
Certain features of
<B>sbopkg</B>
rely on outside binaries, such as a pager to view the text files when
<B>sbopkg</B>
is run from the command line, and an editor to edit the
<I>.info</I>
or
<I>SlackBuild</I>
files.
The paging functions will look to the environmental variable
<B>PAGER</B>
and, if that variable is not defined, it will default to
<B>more</B>.
Similarly, the editing functions will look to
<B>EDITOR</B>
and will default to
<B>vi</B>.
If the user wants
<B>sbopkg</B>
2011-04-28 05:01:06 +02:00
to use another editor or pager, then adding the requisite information in
2010-11-12 05:07:45 +01:00
<I>~/.bashrc</I>,
<I>/etc/profile</I>,
2011-04-28 05:01:06 +02:00
or other similar configuration file (including
<B>sbopkg</B>'s
2010-11-12 05:07:45 +01:00
2011-04-28 05:01:06 +02:00
own configuration files) to export the relevant variable will suffice.
2010-11-12 05:07:45 +01:00
<A NAME="lbAF">&nbsp;</A>
<H2>OPTIONS</H2>
2010-11-12 05:07:45 +01:00
<DL COMPACT>
2010-11-12 05:07:45 +01:00
<DT><B>-b</B><I> PACKAGE(s)/QUEUE(s)</I>
<DD>
2010-11-12 05:07:45 +01:00
Build packages of the argument(s) from the active repository.
If more than one package is specified, they may either be quoted or the
switch can be given multiple times.
Using this second form, a colon-separated list of options may be given.
If whitespace occurs between the colons, it must be quoted.
<DT><DD>
For example:
<DL COMPACT><DT><DD>
<DL COMPACT>
<DT><DD>
<PRE>
# sbopkg -b &quot;foo bar&quot;
</PRE>
</DL>
</DL>
<DT><DD>
will build
<I>foo</I>
and then
<I>bar</I>.
<DT><DD>
Or
<DL COMPACT><DT><DD>
<DL COMPACT>
<DT><DD>
<PRE>
# sbopkg -b app1:opt1=&quot;foo bar&quot;:opt2=baz -b app2:opt=mu
</PRE>
</DL>
</DL>
<DT><DD>
will build app1 with the options ``foo bar'' and ``baz'', and app2 with
the option ``mu''.
<DT><DD>
Queuefile names can also be specified.
In that case, all the packages specified in the queuefile will be built.
In the unfortunate case a token matches both a queuefile name and a
package name (i.e., the user named a queuefile with the name of a
package),
<B>sbopkg</B>
will ask the user which one should be used.
A way to avoid this is to specify the queuefile with its
<I>.sqf</I>
extension.
Also, a mix of both packages and queuefiles may be given.
The tokens (package names or queuefiles) are processed in the order they
2012-10-04 05:16:56 +02:00
are specified on the command line, and the order specified in the
2010-11-12 05:07:45 +01:00
queuefiles is retained.
If a package is specified more than once, it gets queued only the first
time it is encountered.
2013-12-09 16:18:45 +01:00
<DT><B>-B</B>
<DD>
Process the packages or queues without prompting for confirmation first.
<DT><B>-c</B>
<DD>
2010-11-12 05:07:45 +01:00
Display a list of installed SBo packages and potential updates.
2012-10-04 05:16:56 +02:00
<DT><B>-d</B><I> PACKAGE(s)/QUEUE(s)</I>
<DD>
Download source archives of the argument(s) from the URL specified in
the active repository.
<DT><DD>
See the
<B>-b</B>
option for details since, other than the build, these two options
operate similarly.
<DT><B>-D</B><I> DIRECTORY</I>
<DD>
2010-11-12 05:07:45 +01:00
Manually specify the full path to the
<I>DIRECTORY</I>
containing the local SBo repository.
<DT><B>-e ask</B>|continue|stop
<DD>
2010-11-12 05:07:45 +01:00
Specify what
<B>sbopkg</B>
2012-10-04 05:16:56 +02:00
should do when it encounters an error while processing a package.
2010-11-12 05:07:45 +01:00
Valid options are:
<DT><DD>
<B>ask</B>:
2010-11-12 05:07:45 +01:00
This is the default behavior, asking the user what to do.
<DT><DD>
<B>continue</B>:
2010-11-12 05:07:45 +01:00
Ignore the error and continue processing (act as if the user answered
``Yes'' to all questions).
<DT><DD>
<B>stop</B>:
Stop the processing (act as if the user answered ``No'' to all questions).
<DT><B>-f</B><I> FILE</I>
<DD>
2010-11-12 05:07:45 +01:00
Override the default configuration file,
<I>/etc/sbopkg/sbopkg.conf</I>,
with
<I>FILE</I>.
<DT><B>-g</B><I> PACKAGE(s)</I>
<DD>
2010-11-12 05:07:45 +01:00
General search for
<I>PACKAGE(s)</I>
by case-insensitive glob where the argument is automatically wrapped in
<B>*</B>s.
If more than one glob is specified, they must be quoted or the -g flag
must be used multiple times, once for each glob.
<DT><DD>
For example:
<DL COMPACT><DT><DD>
<DL COMPACT>
<DT><DD>
<PRE>
# sbopkg -g &quot;foo bar&quot;
</PRE>
</DL>
</DL>
<DT><DD>
will return a list of packages with either
<I>foo</I>
or
<I>bar</I>
in their names.
<DT><B>-h</B>
<DD>
Display the help.
2010-11-12 05:07:45 +01:00
<DT><B>-i</B><I> PACKAGE(s)/QUEUE(s)</I>
<DD>
2012-10-04 05:16:56 +02:00
Download, build, and install packages of the argument(s) from the active
2010-11-12 05:07:45 +01:00
repository.
<DT><DD>
See the
<B>-b</B>
option for details since, other than the installation, these two options
operate similarly.
<DT><DD>
2011-02-05 05:34:55 +01:00
Note that by carefully considering the order of the packages listed
2012-10-04 05:16:56 +02:00
and/or using queuefiles, the user may be able to install dependencies in
the right order before the final application is built.
2010-11-12 05:07:45 +01:00
<DT><B>-k</B>
<DD>
2010-11-12 05:07:45 +01:00
When used together with
2012-10-04 05:16:56 +02:00
<B>-b</B>,
<B>-d</B>,
2010-11-12 05:07:45 +01:00
or
<B>-i</B>,
this option tells
<B>sbopkg</B>
2012-10-04 05:16:56 +02:00
to skip (i.e., don't process) any package it finds to be already
2010-11-12 05:07:45 +01:00
installed.
<DT><DD>
Please note that only a name comparison is performed, so when this
2010-11-12 05:07:45 +01:00
option is specified
<B>sbopkg</B>
will also omit the build of different versions of installed packages.
<DT><B>-l</B>
<DD>
2010-11-12 05:07:45 +01:00
Display the SBo
<I>ChangeLog</I>
and quit.
<DT><B>-o</B>
<DD>
2010-11-12 05:07:45 +01:00
List the currently installed cached source files which are deemed
obsolete, and optionally delete them.
2010-11-12 05:07:45 +01:00
<DT><DD>
Source files are obsolete when no
<I>.info</I>
file's
<B>DOWNLOAD</B>
field(s) reference it any more, which is something that can happen after
syncing the local repository.
<DT><DD>
Please note that only the currently active repository is used to
identify the obsolete sources, so if the user builds packages with
different repositories (e.g., for different Slackware versions) the
source files only used in the ``other'' repository will be listed.
2010-05-25 00:32:33 +02:00
<DT><B>-P</B>
<DD>
List the cached package files which are not currently installed on the
system and optionally delete them.
2010-11-12 05:07:45 +01:00
<DT><B>-p</B>
<DD>
2010-11-12 05:07:45 +01:00
List installed SBo packages.
<DT><B>-q</B>
<DD>
2010-11-12 05:07:45 +01:00
Enable the ``quiet mode.''
When this flag is specified, the output of some of the command-line
options is minimized.
<DT><B>-R</B>
<DD>
2011-04-28 05:01:06 +02:00
When combined with
2012-10-04 05:16:56 +02:00
<B>-b</B>,
<B>-d</B>,
2011-04-28 05:01:06 +02:00
or
<B>-i</B>,
view the
2010-11-12 05:07:45 +01:00
<I>README</I>
2012-10-04 05:16:56 +02:00
files of the packages to be processed before processing them.
2011-04-28 05:01:06 +02:00
This is useful for making a final check.
When combined with
<B>-p</B>,
view the
<I>README</I>
files of all installed packages from the active repo.
2010-11-12 05:07:45 +01:00
<DT><B>-r</B>
<DD>
2010-11-12 05:07:45 +01:00
``Rsync'' the local repository with SBo and quit.
<DT><B>-s</B><I> PACKAGE(s)</I>
<DD>
Specific search for
<I>PACKAGE(s)</I>
by case-sensitive glob and, if found, display the
<I>README</I>,
<I>SlackBuild</I>,
<I>.info</I>,
and
<I>slack-desc</I>
files in that order for each
<I>PACKAGE</I>
found, using
<I>$PAGER</I>.
If more than one glob is specified, they must be quoted or the -s flag
must be used multiple times, once for each glob.
<DT><DD>
For example:
<DL COMPACT><DT><DD>
<DL COMPACT>
<DT><DD>
<PRE>
# sbopkg -s &quot;foo bar&quot;
</PRE>
</DL>
</DL>
<DT><DD>
will display all the above-mentioned files for packages whose names are
exactly
<I>foo</I>
or
<I>bar</I>.
<DT><DD>
2011-04-28 05:01:06 +02:00
Note that shell metacharacters may be supplied in the arguments.
For instance,
2010-11-12 05:07:45 +01:00
<DL COMPACT><DT><DD>
<DL COMPACT>
<DT><DD>
<PRE>
# sbopkg -s '*[Oo]pen*'
</PRE>
</DL>
</DL>
<DT><DD>
will return all packages with 'open' or 'Open' anywhere in the name.
If multiple applications are returned, the user will be presented with a
menu to select from.
<DT><B>-u</B>
<DD>
2010-11-12 05:07:45 +01:00
Check for an update to
<B>sbopkg</B>
itself and then quit.
<DT><B>-V</B><I> VERSION</I>
<DD>
Set the repository and branch to use.
2010-11-12 05:07:45 +01:00
<DT><DD>
For a list of valid versions, invoke
<B>sbopkg</B>
2010-05-25 00:32:33 +02:00
2010-11-12 05:07:45 +01:00
as
<DL COMPACT><DT><DD>
<DL COMPACT>
<DT><DD>
<PRE>
# sbopkg -V ?
</PRE>
</DL>
</DL>
<DT><DD>
See the
2010-11-12 05:07:45 +01:00
<B><A HREF="http://localhost/cgi-bin/man/man2html?5+sbopkg.conf">sbopkg.conf</A></B>(5)
man page for more information about the ``local'' repository.
<DT><DD>
The
<I>VERSION</I>
2013-12-09 16:18:45 +01:00
format is repository/branch (e.g., SBo/xxxSWVERxxx).
2010-11-12 05:07:45 +01:00
If the repository is omitted,
<B>sbopkg</B>
will first look for the specified branch in the default repository.
If that attempt fails,
<B>sbopkg</B>
will look for the first matching branch in any repository.
2010-05-25 00:32:33 +02:00
<DT><B>-v</B>
<DD>
2010-11-12 05:07:45 +01:00
Prints the current version of
<B>sbopkg</B>
on stdout.
</DL>
<A NAME="lbAG">&nbsp;</A>
<H2>FILES</H2>
2010-11-12 05:07:45 +01:00
<DL COMPACT>
<DT><I>/etc/sbopkg/sbopkg.conf</I>
2010-11-12 05:07:45 +01:00
<DD>
Default system-wide file to specify configuration options.
2011-04-28 05:01:06 +02:00
<DT><I>~/.sbopkg.conf</I>
<DD>
File to override system configuration options.
<DT><I>/etc/sbopkg/renames.d/*.renames</I>
2010-11-12 05:07:45 +01:00
<DD>
2011-04-28 05:01:06 +02:00
Files that list software in the SBo repositories that has been renamed.
2010-11-12 05:07:45 +01:00
See the
2011-04-28 05:01:06 +02:00
<I>README-renames</I>
2010-11-12 05:07:45 +01:00
document in the
<B>sbopkg</B>
documentation directory for more information.
2011-04-28 05:01:06 +02:00
<DT><I>/etc/sbopkg/repos.d/*.repo</I>
2010-11-12 05:07:45 +01:00
<DD>
2011-04-28 05:01:06 +02:00
Files for various types of
2010-11-12 05:07:45 +01:00
<B>sbopkg</B>
repositories.
See the
2011-04-28 05:01:06 +02:00
<I>README-repos</I>
2010-11-12 05:07:45 +01:00
document in the
<B>sbopkg</B>
documentation directory for more information.
</DL>
<A NAME="lbAH">&nbsp;</A>
<H2>AUTHORS</H2>
Willy Sudiarto Raharjo
&lt;<A HREF="mailto:willysr@sbopkg.org">willysr@sbopkg.org</A>&gt;
<P>
2010-11-12 05:07:45 +01:00
Chess Griffin
&lt;<A HREF="mailto:chess@chessgriffin.com">chess@chessgriffin.com</A>&gt;
<P>
2010-11-12 05:07:45 +01:00
Mauro Giachero
&lt;<A HREF="mailto:mauro.giachero@gmail.com">mauro.giachero@gmail.com</A>&gt;
<P>
2010-11-12 05:07:45 +01:00
slakmagik
&lt;<A HREF="mailto:slakmagik@gmail.com">slakmagik@gmail.com</A>&gt;
<A NAME="lbAI">&nbsp;</A>
<H2>SEE ALSO</H2>
2010-11-12 05:07:45 +01:00
<B><A HREF="http://localhost/cgi-bin/man/man2html?1+dialog">dialog</A></B>(1),
2010-11-12 05:07:45 +01:00
<B><A HREF="http://localhost/cgi-bin/man/man2html?1+more">more</A></B>(1),
2010-11-12 05:07:45 +01:00
<B><A HREF="http://localhost/cgi-bin/man/man2html?8+removepkg">removepkg</A></B>(8),
2010-11-12 05:07:45 +01:00
<B><A HREF="http://localhost/cgi-bin/man/man2html?1+rsync">rsync</A></B>(1),
2010-11-12 05:07:45 +01:00
<B><A HREF="http://localhost/cgi-bin/man/man2html?5+sbopkg.conf">sbopkg.conf</A></B>(5),
2010-11-12 05:07:45 +01:00
<B><A HREF="http://localhost/cgi-bin/man/man2html?1+su">su</A></B>(1),
<B><A HREF="http://localhost/cgi-bin/man/man2html?8+upgradepkg">upgradepkg</A></B>(8),
<B><A HREF="http://localhost/cgi-bin/man/man2html?1+vi">vi</A></B>(1),
<I>/usr/doc/sbopkg-0.37.1/*</I>
<P>
<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT><A HREF="#lbAB">NAME</A><DD>
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
2010-11-12 05:07:45 +01:00
<DL>
<DT><A HREF="#lbAE">Instructions</A><DD>
</DL>
<DT><A HREF="#lbAF">OPTIONS</A><DD>
<DT><A HREF="#lbAG">FILES</A><DD>
2010-11-12 05:07:45 +01:00
<DT><A HREF="#lbAH">AUTHORS</A><DD>
<DT><A HREF="#lbAI">SEE ALSO</A><DD>
</DL>
<HR>
This document was created by
<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
using the manual pages.<BR>
Time: 03:03:32 GMT, October 27, 2015
</BODY>
</HTML>