pavement

Ports tree

From FreeBSDwiki
(Difference between revisions)
Jump to: navigation, search
(Remove many things taht were already written)
(Looking for ports: psearch)
 
(6 intermediate revisions by 2 users not shown)
Line 1: Line 1:
The port tree is commonly located in "/usr/ports/". It is composed of a "two level" directory structure containg a few files. Each application has it own directory, for example, [[vim]] is located in "/editors/vim" from the root of the port directory, so commonly, "/usr/ports/editors/vim" from the root of the system.
+
The ports tree is commonly located in "/usr/ports/". It is composed of a two level directory structure containg a few files. Each application has it own directory, for example, [[vim]] is located in "/editors/vim" from the root of the port directory, so commonly, "/usr/ports/editors/vim" from the root of the system.
  
 
Each directory contains a few files:
 
Each directory contains a few files:
 
* '''Makefile''': Used for compiling [[ports]].
 
* '''Makefile''': Used for compiling [[ports]].
 
* '''distinfo''': Contains informations on the files needed to install (To check their integrity).
 
* '''distinfo''': Contains informations on the files needed to install (To check their integrity).
* '''pkg-descr''': This file tell what is the port.
+
* '''pkg-descr''': This file describes what the port is.
 
* '''pkg-plist''': This file lists the binaries installed by the port.
 
* '''pkg-plist''': This file lists the binaries installed by the port.
* An optionnal '''files''' folder: Patches applied on the source before compilation.
+
* An optional '''files''' folder: Patches the port will apply to the standard source code before compilation; may be either to add features or reconfigure the port to install itself in BSD-centric directory format.
  
== Dependancies ==
+
== Dependencies ==
  
 
You have nothing to do while installing: dependencies are automaticaly installed. But this is '''*NOT*''' done while uninstalling (uninstalling a port will not deinstall the other that need it), so '''you shall not deinstall port''' directly in the port tree. Instead, use [[pkg_deinstall]].
 
You have nothing to do while installing: dependencies are automaticaly installed. But this is '''*NOT*''' done while uninstalling (uninstalling a port will not deinstall the other that need it), so '''you shall not deinstall port''' directly in the port tree. Instead, use [[pkg_deinstall]].
 +
 +
== Looking for ports ==
 +
 +
You can browse the port tree randomly to find many interesting ports, but you can also search ports using keywords :
 +
# cd /usr/ports ; make search key=MyKeyword
 +
It you want to search a port by name, use this :
 +
# cd /usr/ports ; make search name=PortName
 +
 +
Another way is to install and use the package or port ''psearch''. Then the following will search for a program and optionally the options -c can be used to filter a category, or -l can be used for a long description:
 +
psearch xorg -l -c x11
  
 
See also [[Ports%2C_Installing]], [[Ports_Tree%2C_Updating]].
 
See also [[Ports%2C_Installing]], [[Ports_Tree%2C_Updating]].
 +
 +
[[Category:FreeBSD Terminology]]

Latest revision as of 16:48, 17 December 2014

The ports tree is commonly located in "/usr/ports/". It is composed of a two level directory structure containg a few files. Each application has it own directory, for example, vim is located in "/editors/vim" from the root of the port directory, so commonly, "/usr/ports/editors/vim" from the root of the system.

Each directory contains a few files:

  • Makefile: Used for compiling ports.
  • distinfo: Contains informations on the files needed to install (To check their integrity).
  • pkg-descr: This file describes what the port is.
  • pkg-plist: This file lists the binaries installed by the port.
  • An optional files folder: Patches the port will apply to the standard source code before compilation; may be either to add features or reconfigure the port to install itself in BSD-centric directory format.

[edit] Dependencies

You have nothing to do while installing: dependencies are automaticaly installed. But this is *NOT* done while uninstalling (uninstalling a port will not deinstall the other that need it), so you shall not deinstall port directly in the port tree. Instead, use pkg_deinstall.

[edit] Looking for ports

You can browse the port tree randomly to find many interesting ports, but you can also search ports using keywords :

# cd /usr/ports ; make search key=MyKeyword

It you want to search a port by name, use this :

# cd /usr/ports ; make search name=PortName

Another way is to install and use the package or port psearch. Then the following will search for a program and optionally the options -c can be used to filter a category, or -l can be used for a long description:

psearch xorg -l -c x11

See also Ports,_Installing, Ports_Tree,_Updating.

Personal tools