CINXE.COM

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> <html> <head> <meta http-equiv="X-UA-Compatible" content="IE=Edge"> <meta name="viewport" content="width=device-width, initial-scale=1"> <meta http-equiv="Content-Type" content="text/html;charset=utf-8"> <meta name="robots" content="index,nofollow"> <title>PkgPrimer - FreeBSD Wiki</title> <script type="text/javascript" src="/moin_static1911/common/js/common.js"></script> <script type="text/javascript">  </script> <link rel="stylesheet" type="text/css" charset="utf-8" media="all" href="/moin_static1911/modern/css/common.css"> <link rel="stylesheet" type="text/css" charset="utf-8" media="screen" href="/moin_static1911/modern/css/screen.css"> <link rel="stylesheet" type="text/css" charset="utf-8" media="print" href="/moin_static1911/modern/css/print.css"> <link rel="stylesheet" type="text/css" charset="utf-8" media="projection" href="/moin_static1911/modern/css/projection.css">   <link rel="alternate" title="FreeBSD Wiki: PkgPrimer" href="/action/rss_rc/PkgPrimer?diffs=1&show_att=1&action=rss_rc&unique=0&page=PkgPrimer&ddiffs=1" type="application/rss+xml"> <link rel="Start" href="/FrontPage"> <link rel="Alternate" title="Wiki Markup" href="/action/raw/PkgPrimer?action=raw"> <link rel="Alternate" media="print" title="Print View" href="/action/print/PkgPrimer?action=print"> <link rel="Search" href="/FindPage"> <link rel="Index" href="/TitleIndex"> <link rel="Glossary" href="/WordIndex"> <link rel="Help" href="/HelpOnFormatting"> </head> <body lang="en" dir="ltr"> <div id="header"> <div id="logo"><a href="/FrontPage"><img src="/logo-full-thumb.png" alt="Logo"></a></div> <form id="searchform" method="get" action="/PkgPrimer"> <div> <input type="hidden" name="action" value="fullsearch"> <input type="hidden" name="context" value="180"> <label for="searchinput">Search:</label> <input id="searchinput" type="text" name="value" value="" size="20" onfocus="searchFocus(this)" onblur="searchBlur(this)" onkeyup="searchChange(this)" onchange="searchChange(this)" alt="Search"> <input id="titlesearch" name="titlesearch" type="submit" value="Titles" alt="Search Titles"> <input id="fullsearch" name="fullsearch" type="submit" value="Text" alt="Search Full Text"> </div> </form> <script type="text/javascript">  </script> <ul id="username"><li><a href="/action/login/PkgPrimer?action=login" id="login" rel="nofollow">Login</a></li></ul> <div id="locationline"> <ul id="pagelocation"> <li><a href="/PkgPrimer">PkgPrimer</a></li> </ul> </div> <ul id="navibar"> <li class="wikilink"><a href="/RecentChanges">RecentChanges</a></li><li class="wikilink"><a href="/FindPage">FindPage</a></li><li class="wikilink"><a href="/HelpContents">HelpContents</a></li><li class="current"><a href="/PkgPrimer">PkgPrimer</a></li> </ul> <div id="pageline"><hr style="display:none;"></div> <ul class="editbar"><li>Immutable Page</li><li class="toggleCommentsButton" style="display:none;"><a href="#" class="nbcomment" onClick="toggleComments();return false;">Comments</a></li><li><a class="nbinfo" href="/action/info/PkgPrimer?action=info" rel="nofollow">Info</a></li><li><a class="nbattachments" href="/action/AttachFile/PkgPrimer?action=AttachFile" rel="nofollow">Attachments</a></li><li> <form class="actionsmenu" method="GET" action="/PkgPrimer"> <div> <label>More Actions:</label> <select name="action" onchange="if ((this.selectedIndex != 0) && (this.options[this.selectedIndex].disabled == false)) { this.form.submit(); } this.selectedIndex = 0;"> <option value="raw">Raw Text</option> <option value="print">Print View</option> <option value="RenderAsDocbook">Render as Docbook</option> <option value="refresh">Delete Cache</option> <option value="show" disabled class="disabled">------------------------</option> <option value="SpellCheck">Check Spelling</option> <option value="LikePages">Like Pages</option> <option value="LocalSiteMap">Local Site Map</option> <option value="show" disabled class="disabled">------------------------</option> <option value="RenamePage" disabled class="disabled">Rename Page</option> <option value="DeletePage" disabled class="disabled">Delete Page</option> <option value="show" disabled class="disabled">------------------------</option> <option value="show" disabled class="disabled">Subscribe User</option> <option value="show" disabled class="disabled">------------------------</option> <option value="show" disabled class="disabled">Remove Spam</option> <option value="show" disabled class="disabled">Revert to this revision</option> <option value="PackagePages">Package Pages</option> <option value="SyncPages">Sync Pages</option> <option value="show" disabled class="disabled">------------------------</option> <option value="Load">Load</option> <option value="Save">Save</option> <option value="SlideShow">SlideShow</option> </select> <input type="submit" value="Do"> </div> <script type="text/javascript">  </script> </form> </li></ul> </div> <div id="page" lang="en" dir="ltr"> <div dir="ltr" id="content" lang="en"> <h1 id="Pkg_Primer">Pkg Primer</h1> <div class="table-of-contents">Contents<ol><li> <a href="#Pkg_Primer">Pkg Primer</a><ol><li> <a href="#Switching_to_pkgng">Switching to pkgng</a></li><li> <a href="#Charter_and_Roadmap">Charter and Roadmap</a></li><li> <a href="#Rosetta_Stone">Rosetta Stone</a></li><li> <a href="#Details">Details</a><ol><li> <a href="#Marking_all_packages_but_vim-lite_and_pkg_as_automatic">Marking all packages but vim-lite and pkg as automatic</a></li></ol></li><li> <a href="#Building_custom_repositories">Building custom repositories</a><ol><li> <a href="#Using_poudriere">Using poudriere</a></li><li> <a href="#Using_portbuilder_inside_a_jail">Using portbuilder inside a jail</a></li></ol></li></ol></li></ol></div> <h2 id="Switching_to_pkgng">Switching to pkgng</h2> Please see <a class="http" href="http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/pkgng-intro.html">Using pkgng for Binary Package Management</a> in the FreeBSD Handbook for information about changing a system to use pkgng. <h2 id="Charter_and_Roadmap">Charter and Roadmap</h2> see: <a href="/pkgng/CharterAndRoadMap">pkgng/CharterAndRoadMap</a> <h2 id="Rosetta_Stone">Rosetta Stone</h2> <div><table><tbody><tr> <td> Function </td> <td> legacy pkg_* </td> <td> pkgng </td> </tr> <tr> <td> get list of installed packages </td> <td> pkg_info </td> <td> pkg info </td> </tr> <tr> <td> get basic information about a package </td> <td> pkg_info pkgname-pkgversion </td> <td> pkg info pkgname OR pkg info category/name OR pkg info pkgname-pkgversion </td> </tr> <tr> <td> get detailed information about a package </td> <td> N/A </td> <td> pkg info -f pkgname OR pkg info -f category/name OR pkg info -f pkgname-pkgversion </td> </tr> <tr> <td> list all files contained in an installed package </td> <td> pkg_info -L pkgname-pkgversion </td> <td> pkg info -l pkgname OR pkg info -l category/name OR pkg info -l pkgname-pkgversion </td> </tr> <tr> <td> find which package provide an installed file </td> <td> pkg_info -W /path/to/my/file </td> <td> pkg which /path/to/my/file </td> </tr> <tr> <td> install a local package </td> <td> pkg_add ./localpkg.tbz </td> <td> pkg add ./localpkg.txz </td> </tr> <tr> <td> install a remote package </td> <td> pkg_add -r mypackage </td> <td> pkg install mypackage OR pkg install category/name OR pkg install pkgname-pkgversion </td> </tr> <tr> <td> search for a remote package </td> <td> N/A </td> <td> pkg search mypackage OR pkg search category/name OR pkg search pkgname-pkgversion </td> </tr> <tr> <td> search for detailed informations about a remote package </td> <td> N/A </td> <td> pkg search -f mypackage OR pkg search -f category/name OR pkg search -f pkgname-pkgversion </td> </tr> <tr> <td> show reverse dependencies of an installed package </td> <td> pkg_info -R pkgname-pkgversion </td> <td> pkg info -r mypackage OR pkg info -r category/name OR pkg info -r pkgname-pkgversion </td> </tr> <tr> <td> show dependencies of an installed package </td> <td> pkg_info -r pkgname-pkgversion </td> <td> pkg info -d mypackage OR pkg info -d category/name OR pkg info -d pkgname-pkgversion </td> </tr> <tr> <td> remove unused packages install as a dependency </td> <td> N/A </td> <td> pkg autoremove </td> </tr> <tr> <td> binary upgrade the installed packages </td> <td> N/A </td> <td> pkg upgrade </td> </tr> <tr> <td> create a remote repository </td> <td> N/A </td> <td> pkg repo /path/to/a/directory/containing/packages </td> </tr> <tr> <td> manipulate packages in a jail </td> <td> N/A </td> <td> pkg -j <name_or_id_of_a_jail> <command> </td> </tr> <tr> <td> manipulate packages in a chroot </td> <td> pkg_add -C <path_to_chroot> (not all commands are chroot aware) </td> <td> pkg -c <path_to_chroot> <command> </td> </tr> <tr> <td> show information about installed packages using regular expression </td> <td> pkg_info -x <regex> </td> <td> pkg info -x <regex> </td> </tr> <tr> <td> show information about installed packages using extended regular expression </td> <td> pkg_info -X <regex> </td> <td> pkg info -X <regex> </td> </tr> <tr> <td> show information about installed packages using globbing </td> <td> pkg_info <globbing> </td> <td> pkg info -g <globbing> </td> </tr> <tr> <td> check for known vulnerability </td> <td> portaudit (third party tool) </td> <td> pkg audit </td> </tr> <tr> <td> show out of date packages (determine out of the ports tree) </td> <td> pkg_version -l < </td> <td> pkg version -l < </td> </tr> <tr> <td> show out of date packages (determine out of the ports tree index) </td> <td> pkg_version -Il < </td> <td> pkg version -Il < </td> </tr> <tr> <td> show out of date packages compared to a remote repository </td> <td> N/A </td> <td> pkg upgrade -n </td> </tr> <tr> <td> show statistic about installed packages </td> <td> N/A </td> <td> pkg stat </td> </tr> <tr> <td> checking for missing dependency (and try to fix them) </td> <td> N/A </td> <td> pkg check -d </td> </tr> <tr> <td> port origin </td> <td> pkg_info -o </td> <td> pkg info -o </td> </tr> </tbody></table></div> <h2 id="Details">Details</h2> <h3 id="Marking_all_packages_but_vim-lite_and_pkg_as_automatic">Marking all packages but vim-lite and pkg as automatic</h3> <pre>pkg set -yA 1 `pkg query -e "%n != pkg && %n != vim-lite" %o`</pre>Now you can cleanup all the left crufts <pre>pkg autoremove</pre> <h2 id="Building_custom_repositories">Building custom repositories</h2> <h3 id="Using_poudriere">Using poudriere</h3> Install poudriere and pkgng on the host (please note that the host do not need to be converted to pkgng) <pre>make -C /usr/ports/ports-mgmt/poudriere install clean make -C /usr/ports/ports-mgmt/pkg install clean</pre>Create a default configuration in the ${LOCALBASE}/etc/poudriere.conf configuration file: <pre>BASEFS=/poudriere ZPOOL=myzpool FREEBSD_HOST=ftp://ftp.freebsd.org POUDRIERE_DATA=/poudriere_data RESOLV_CONF=/etc/resolv.conf DISTFILES_CACHE=/usr/ports/distfiles</pre>poudriere is now ready to be used. First create a ports tree to be used by poudriere <pre>poudriere ports -c</pre>Create the jail in version you want to build packages for: <pre>poudriere jail -c -j 90amd64 -v 9.0-RELEASE -a amd64 poudriere jail -c -j 10i386 -v head -a i386 -m svn</pre>The first will create a 9.0-RELEASE amd64 jail from the official sets (fetched on FREEBSD_HOST) The second will create a current jail using svn and build for i386 As poudriere works for both legacy pkg_* and pkgng you need to make it pkgng aware: <pre>mkdir /usr/local/etc/poudriere.d echo "WITH_PKGNG=yes" > /usr/local/etc/poudriere.d/90amd64-make.conf echo "WITH_PKGNG=yes" > /usr/local/etc/poudriere.d/10i386-make.conf</pre>Create the list of packages you want to see built by poudriere: <pre>cat ~/mylist1 editors/vim-lite www/nginx</pre><pre>cat ~/mylist2 www/firefox editors/libreoffice</pre>Just run poudriere: <pre>poudriere bulk -f ~/mylist1 -j 90amd64 poudriere bulk -f ~/mylist2 -j 10i386</pre>This will built 2 pkgng repositories: <ul><li>${POUDRIERE_DATA}/packages/10i386-default </li><li>${POUDRIERE_DATA}/packages/90amd64-default </li></ul>Configure your http server to those directories to be able to serve them. On your user boxes: (if you use the automatic bootstrap it will take care of creating this file) <pre>echo "packagesite: http://yoururl/10i386-default" >> /usr/local/etc/pkg.conf</pre><pre>echo "packagesite: http://yoururl/90amd64-default" >> /usr/local/etc/pkg.conf</pre>From 9.1 you can directly bootstrap from the base: Before 9.1 you will need to bootstrap by hand: <pre>fetch http://yoururl/90amd64-default/Latest/pkg.txz tar xf ./pkg.txz -s ",/.*/,,g" "*/pkg-static" ./pkg-static add ./pkg.txz</pre>To update your repositories just rerun poudriere: <pre>poudriere ports -u # this updates your default ports tree poudriere bulk -f ~/mylist1 -j 90amd64 poudriere bulk -f ~/mylist2 -j 10i386</pre> <h3 id="Using_portbuilder_inside_a_jail">Using portbuilder inside a jail</h3> When building 9-stable ports in a 9-stable jail under -current you might want to set the UNAME_r environment variable to fake the FreeBSD version in /path_to_my_jail/root/.cshrc . Some examples: <ul><li>setenv UNAME_r 9-STABLE </li><li>setenv UNAME_r 8-STABLE </li><li>setenv UNAME_r 7-STABLE </li></ul>Else some ports won't build properly. <hr /> <a href="/CategoryHowTo">CategoryHowTo</a> </div>PkgPrimer (last edited 2017-08-23T13:17:55+0000 by <a href="/MateuszPiotrowski" title="0mp">MateuszPiotrowski</a>) <div id="pagebottom"></div> </div> <div id="footer"> <ul class="editbar"><li>Immutable Page</li><li class="toggleCommentsButton" style="display:none;"><a href="#" class="nbcomment" onClick="toggleComments();return false;">Comments</a></li><li><a class="nbinfo" href="/action/info/PkgPrimer?action=info" rel="nofollow">Info</a></li><li><a class="nbattachments" href="/action/AttachFile/PkgPrimer?action=AttachFile" rel="nofollow">Attachments</a></li><li> <form class="actionsmenu" method="GET" action="/PkgPrimer"> <div> <label>More Actions:</label> <select name="action" onchange="if ((this.selectedIndex != 0) && (this.options[this.selectedIndex].disabled == false)) { this.form.submit(); } this.selectedIndex = 0;"> <option value="raw">Raw Text</option> <option value="print">Print View</option> <option value="RenderAsDocbook">Render as Docbook</option> <option value="refresh">Delete Cache</option> <option value="show" disabled class="disabled">------------------------</option> <option value="SpellCheck">Check Spelling</option> <option value="LikePages">Like Pages</option> <option value="LocalSiteMap">Local Site Map</option> <option value="show" disabled class="disabled">------------------------</option> <option value="RenamePage" disabled class="disabled">Rename Page</option> <option value="DeletePage" disabled class="disabled">Delete Page</option> <option value="show" disabled class="disabled">------------------------</option> <option value="show" disabled class="disabled">Subscribe User</option> <option value="show" disabled class="disabled">------------------------</option> <option value="show" disabled class="disabled">Remove Spam</option> <option value="show" disabled class="disabled">Revert to this revision</option> <option value="PackagePages">Package Pages</option> <option value="SyncPages">Sync Pages</option> <option value="show" disabled class="disabled">------------------------</option> <option value="Load">Load</option> <option value="Save">Save</option> <option value="SlideShow">SlideShow</option> </select> <input type="submit" value="Do"> </div> <script type="text/javascript">  </script> </form> </li></ul> <ul id="credits"> <li><a href="http://moinmo.in/" title="This site uses the MoinMoin Wiki software.">MoinMoin Powered</a></li><li><a href="http://moinmo.in/Python" title="MoinMoin is written in Python.">Python Powered</a></li><li><a href="http://moinmo.in/GPL" title="MoinMoin is GPL licensed.">GPL licensed</a></li><li><a href="http://validator.w3.org/check?uri=referer" title="Click here to validate this page.">Valid HTML 4.01</a></li> </ul> </div> </body> </html>