Beginning in February, 2013, PC-BSD® switched from the traditional FreeBSD ports system to [http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/pkgng-intro.html pkgng], the next generation package management system for FreeBSD.

+

PC-BSD® uses pkgng, the next generation package management system for FreeBSD. All of the PC-BSD® utilities that deal with installing or updating non-PBI software now use the pkgng system. This allows users to safely install non-PBI software from the command line without that software being deleted by a system upgrade.

−

+

−

<!--T:3-->

+

−

{{note|icon64= Users of PC-BSD® 9.1-RELEASE will not be affected by this change unless they upgrade or install a [[Using a Rolling Release| rolling release]].}}

+

−

+

−

<!--T:4-->

+

−

All of the PC-BSD® utilities that deal with installing or updating software now use the pkgng system. This allows users to safely install non-PBI software from the command line without that software being deleted by a system upgrade.

+

<!--T:5-->

<!--T:5-->

Since FreeBSD does not have an official pkgng repository yet, the PC-BSD® project provides its own repository containing all of the packages that can be built using pkgng.

Since FreeBSD does not have an official pkgng repository yet, the PC-BSD® project provides its own repository containing all of the packages that can be built using pkgng.

−

<!--T:6-->

+

<!--T:25-->

−

PC-BSD® provides a custom command, '''pc-pkg''', which is a small wrapper to '''pkg'''. When '''pc-pkg''' is used with the '''install''' or '''upgrade''' flags, it will automatically connect to the PC-BSD® pkgng repository using the integrated [http://aria2.sourceforge.net/ aria2] downloader utility, which can significantly reduce download speeds over a slow link.

+

PC-BSD® provides a custom command, '''pc-pkg''', which is a small wrapper to '''pkg'''. When '''pc-pkg''' is used with the '''install''' or '''upgrade''' flags, it will automatically connect to the PC-BSD® pkgng repository using the integrated {{citelink|url=http://aria2.sourceforge.net/|txt=aria2}} downloader utility, which can significantly reduce download speeds over a slow link.

<!--T:7-->

<!--T:7-->

−

If you are used to using the traditional FreeBSD package system, you will notice that the commands used to install and manage software differ slightly. For example, instead of using '''pkg_add''' to install a package from a remote repository, use '''pkg install''' or '''pc-pkg install''' (notice there is now a space instead of an underscore). Type '''man pkg''' to see a list of the available commands. Once you know the name of a command, you can use the built-in help system to get more information about that command. For example, to learn more about '''pkg install''', type '''pkg help install'''.

+

If you are used to using the traditional FreeBSD package system, take note that the commands used to install and manage software differ slightly. For example, instead of using '''pkg_add''' to install a package from a remote repository, use '''pkg install''' or '''pc-pkg install''' (notice there is now a space instead of an underscore).

+

+

<!--T:34-->

+

The {{citelink|fbsdh|url=pkgng-intro.html|txt=FreeBSD Handbook}} provides an introduction to using pkgng. Section 5.5.1 is not needed on a PC-BSD® or TrueOS® system as the operating system installation does this for you. The various pkgng commands have associated man pages. Type '''man pkg''' for an overview of general usage; the names of the associated man pages will be found towards the bottom of this man page. Once you know the name of a command, you can also use the built-in help system to get more information about that command. For example, to learn more about '''pkg install''', type '''pkg help install'''.

+

+

===pc-metapkgmanager=== <!--T:26-->

+

+

<!--T:27-->

+

'''pc-metapkgmanager''' is the back-end command line utility used by the PC-BSD® installer, Package Manager, and Warden® to manage meta-packages. Meta-packages are like system components, and include supported and unsupported desktops, development utilities, hardware drivers, and miscellaneous applications such as MythTV or XBMC.

+

+

<!--T:29-->

+

The '''pc-metapkgmanager''' command can be used to install or delete meta-packages. If you type the command without any options, it will display its usage:

+

+

<!--T:30-->

+

{{txtbox|box='''pc-metapkgmanager'''

+

usage: pc-metapkgmanager [options]

+

Options:

+

add pkg1,pkg2 <loc> -- Add the specified list of meta-packages

+

del pkg1,pkg2 -- Delete the specified list of meta-packages

+

list -- List the available meta-packages

+

status <pkg> -- List the status of the specified meta-packages{{nbsp|2}}

To determine if a meta-package is installed, specify its "Meta Package" name as shown in the output of the '''pc-metapkgmanager list''' command. For example, to see if the Awesome desktop is installed:

+

+

<!--T:13-->

+

{{txtbox|box='''pc-metapkgmanager status Awesome'''

+

The meta-pkg Awesome is not installed{{nbsp|39}}}}

+

+

<!--T:14-->

+

To install the meta-package, use the '''add''' option and specify the meta-package name. Only the superuser can install meta-packages.

+

+

<!--T:15-->

+

The following example installs the Awesome meta-package. '''pc-metapkgmanager''' will provide messages regarding the status of the installation:

To delete an installed meta-package, specify its name. Only the superuser can uninstall meta-packages. As seen in the following example, '''pc-metapkgmanager''' automatically determines which dependent packages are still needed by other applications and which can be safely removed.

+

+

<!--T:18-->

+

{{txtbox|box='''pc-metapkgmanager del Awesome'''

+

Pending Meta-Package changes: 1

+

Removing Meta-Package: Awesome

+

Removing: pcbsd-meta-awesome

+

The meta-pkg Awesome is not installed{{nbsp|39}}

+

Meta-Package changes finished!}}

−

<!--T:8-->

+

<!--T:35-->

<noinclude>

<noinclude>

−

<!-- {{refheading}} --><!-- uncomment when citelink is used on this page -->

+

{{refheading}}

[[category:Using pkgng]]

[[category:Using pkgng]]

[[category:Installing Applications and Keeping PC-BSD® Updated]]

[[category:Installing Applications and Keeping PC-BSD® Updated]]

Latest revision as of 00:33, 16 December 2013

PC-BSD® uses pkgng, the next generation package management system for FreeBSD. All of the PC-BSD® utilities that deal with installing or updating non-PBI software now use the pkgng system. This allows users to safely install non-PBI software from the command line without that software being deleted by a system upgrade.

Since FreeBSD does not have an official pkgng repository yet, the PC-BSD® project provides its own repository containing all of the packages that can be built using pkgng.

PC-BSD® provides a custom command, pc-pkg, which is a small wrapper to pkg. When pc-pkg is used with the install or upgrade flags, it will automatically connect to the PC-BSD® pkgng repository using the integrated aria2[1] downloader utility, which can significantly reduce download speeds over a slow link.

If you are used to using the traditional FreeBSD package system, take note that the commands used to install and manage software differ slightly. For example, instead of using pkg_add to install a package from a remote repository, use pkg install or pc-pkg install (notice there is now a space instead of an underscore).

The FreeBSD Handbook[2] provides an introduction to using pkgng. Section 5.5.1 is not needed on a PC-BSD® or TrueOS® system as the operating system installation does this for you. The various pkgng commands have associated man pages. Type man pkg for an overview of general usage; the names of the associated man pages will be found towards the bottom of this man page. Once you know the name of a command, you can also use the built-in help system to get more information about that command. For example, to learn more about pkg install, type pkg help install.

pc-metapkgmanager is the back-end command line utility used by the PC-BSD® installer, Package Manager, and Warden® to manage meta-packages. Meta-packages are like system components, and include supported and unsupported desktops, development utilities, hardware drivers, and miscellaneous applications such as MythTV or XBMC.

The pc-metapkgmanager command can be used to install or delete meta-packages. If you type the command without any options, it will display its usage:

To delete an installed meta-package, specify its name. Only the superuser can uninstall meta-packages. As seen in the following example, pc-metapkgmanager automatically determines which dependent packages are still needed by other applications and which can be safely removed.