#language en = Resources for Debian BOINC Maintainers = The purpose of this page is to provide resources to aid members of the [[Teams/DebianBOINCMaintainers|Debian BOINC maintenance team]] and curious hobbyists in packaging [[BOINC]] and related software. Anyone who understands (or corrects) the instructions given below is certainly of help for us. Raise your hand if you feel like helping out. <> == Using pkg-boinc's git source code repositories == The development of our packages is now coordinated in Git repositories. For a tutorial on how to build the boinc packages follow the [[BOINC/Development/GitUsage]] pages. This starts with the checkout of the source code and truly ends with the packages how they are also uploaded to the distribution. The instructions may appeal also to those with some interest in git usage alone. As an extension, see [[BOINC/Development/Backports]] with instructions how to port back to older distributions. We are steadily following upstream's releases. The [[https://salsa.debian.org/pkg-boinc-team/boinc/-/raw/master/debian/TODO.Debian|TODO.Debian file]] in the repository attempts to reference current activities. It is of a particular interest of the BOINC developers to see the server side of BOINC develop separately from the clients. This will be addressed as time permits. === Compilation from the distribution's source package === You need to decide what source tree to start with. There are two ways. The first is that the Debian Maintainers use. It takes the BOINC sources of the BOINC developers and adds ever better working packaging instructions. Albeit not ultimately complicated, you may want to skip that as your first encounter. The second approach is to use what the Maintainers eventually released to Debian build demons - it means that this works for robots, so you can also just those readily prepared bits for your local build. ==== Alternative 1: Like we developers are doing it - from the git repository ==== If new to Linux development, you may possibly decide to start with what the automated Debian build demons do to get the package compiled on various platforms: they use the source packages the Debian maintainer uploads. Once you ever compiled a Debian package yourself, please learn about git and check out our repository. Our introduction at [[BOINC/Development/GitUsage]] by now does a fairly good job. It just helps communicating with us. ==== Alternative 2: Like the build daemons are doing it - be a robot on what was tagged for release ==== To install the BOINC packages from source, a `deb-src` line pointing to Debian's main archive must be present in your `/etc/apt/sources.list` file. Also make sure that you have the `build-essential` and `fakeroot` packages installed on your system. Curiosity is a good motivation to inspect and compile the source. 1. Ensure you have all the packages installed that are required to build boinc: {{{ sudo apt build-dep boinc }}} 1. Prepare a source directory and download the BOINC source package and it's build dependencies: {{{ mkdir -p ~/src/boinc cd !$ apt source boinc }}} 1. Change to the BOINC directory and build the sources. Before running `dpkg-buildpackage` you can apply patches to the BOINC source or set compiler flags to optimize the BOINC core client. {{{ cd boinc-X.Y.Z/ dpkg-buildpackage -rfakeroot -us -uc }}} 1. After `dpkg-buildpackage` successfully finishes the build you can install your custom built packages: {{{ cd ~/src/boinc dpkg -i boinc-client_X.Y.Z-R_ARCH.deb boinc-manager_X.Y.Z-R_ARCH.deb }}} If `dpkg-buildpackage` fails to build the BOINC packages this probably indicates a bug in our sources and it is worth reporting it to the pkg-boinc-devel mailing list pkg-boinc-devel@lists.alioth.debian.org. <> == Bookmarks for BOINC in Debian == * [[https://qa.debian.org/developer.php?login=pkg-boinc-devel@lists.alioth.debian.org|Packages overview for the Debian BOINC Maintainers]] * [[https://bugs.debian.org/cgi-bin/pkgreport.cgi?maint=pkg-boinc-devel%40lists.alioth.debian.org;users=bts-link-upstream%40lists.alioth.debian.org|Bugs in packages maintained by the Debian BOINC Maintainers (including usertags)]] * Overview of source packages: [[https://packages.qa.debian.org/b/boinc.html|BOINC]], [[https://packages.qa.debian.org/b/boinc-app-seti.html|SETI@home]] * Web-based repository browsing: [[https://salsa.debian.org/pkg-boinc-team/boinc|BOINC]], [[https://salsa.debian.org/pkg-boinc-team/boinc-app-seti|SETI@home]] * Status in the unstable wanna-build databases: [[https://buildd.debian.org/boinc|boinc]], [[https://buildd.debian.org/boinc-app-seti|boinc-app-seti]] * Security Bug Tracker: [[https://security-tracker.debian.net/tracker/source-package/boinc|boinc]], [[https://security-tracker.debian.net/tracker/source-package/boinc-app-seti|boinc-app-seti]] * DDTP pages for: [[https://ddtp.debian.org/ddt.cgi?source=boinc|boinc]], [[https://ddtp.debian.org/ddt.cgi?package=boinc-client|boinc-client]], [[https://ddtp.debian.org/ddt.cgi?package=boinc-dbg|boinc-dbg]], [[https://ddtp.debian.org/ddt.cgi?package=boinc-dev|boinc-dev]], [[https://ddtp.debian.org/ddt.cgi?package=boinc-manager|boinc-manager]], [[https://ddtp.debian.org/ddt.cgi?package=boinc-app-seti|boinc-app-seti]] * Build logs of the experimental and [[https://backports.debian.org/|backports]] autobuilders: [[https://buildd.debian.org/status/package.php?p=boinc&suite=experimental|boinc]], [[https://buildd.debian.org/status/package.php?p=boinc-app-seti&suite=experimental|boinc-app-seti]] * Status of our packages and bugs: [[http://io.debian.net/~tar/bugstats/?pkg-boinc-devel@lists.alioth.debian.org|bugstats and karma]] <> == Upstream resources for packagers == * [[https://boinc.berkeley.edu/trac/wiki/UnixClientPackage|Layout of BOINC client packages]] * [[https://boinc.berkeley.edu/trac/wiki/UnixProjectPackage|Layout of BOINC server packages]] <> == Packages for other operating systems == See the Repology pages for: [[https://repology.org/tools/project-by?repo=debian_unstable&name_type=srcname&target_page=project_packages&name=boinc|boinc]] [[https://repology.org/tools/project-by?repo=debian_unstable&name_type=srcname&target_page=project_packages&name=boinc-app-seti|boinc-app-seti]] <> == Source repositories of BOINC applications == ||[[http://einstein.phys.uwm.edu/license.php|Einstein@Home]]||upstream has working Debian packages for internal use|| ||[[https://setisvn.ssl.berkeley.edu/svn/|SETI@home]]||available as [[DebianPts:boinc-app-seti]] and works nicely|| ||[[http://milkyway.cs.rpi.edu/milkyway/download/code_release/|MilkyWay@home]]||available as [[DebianPts:boinc-app-milkyway]], may work or not, needs new maintainer|| [[http://www.desktopgrid.hu/index.php?page=1|SZTAKI]] prepared an infrastructure to run arbitrary jobs on BOINC in sync with regular Computational Grids. For that, they have also prepared Debian packages for the BOINC servers. Their efforts were never merged. == See also == * [[http://www.spy-hill.com/~myers/help/boinc/|Eric Myer's BOINC home page]] * [[http://www.boinc-wiki.info/Eric_Myers%27_BOINC_Developers%27_Notes|Eric Myer's BOINC devel wiki]] * [[http://boinc.berkeley.edu/trac/query|BOINC Upstream Bug Tracking System]]