Lines Matching +full:in +full:- +full:ports
2 .\" SPDX-License-Identifier: BSD-2-Clause
8 .\" Redistribution and use in source and binary forms, with or without
13 .\" 2. Redistributions in binary form must reproduce the above copyright
14 .\" notice, this list of conditions and the following disclaimer in the
20 .\" IN NO EVENT SHALL THE DEVELOPERS BE LIABLE FOR ANY DIRECT, INDIRECT,
24 .\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
25 .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
32 .Nm ports
37 Ports Collection
42 The ports tree, typically located at
43 .Pa /usr/ports ,
44 consists of subdirectories, one for each category; those in turn contain
45 individual ports.
58 the port depends on in order to build and work.
65 Ports Collection is maintained in several branches, which differ mostly
77 .Lk https://git.FreeBSD.org/ports.git
81 .Cm git clone https://git.FreeBSD.org/ports.git
85 branches can be found in Git as branches like
95 .Cm git clone -b 2021Q2 https://git.FreeBSD.org/ports.git
118 field in
119 .Cm pkg -vv
122 For more information about using ports, see the
123 .Dq "Packages and Ports" section
130 .Lk https://docs.FreeBSD.org/en/books/handbook/ports/
132 For information about creating new ports, see
138 .Lk https://docs.FreeBSD.org/en/books/porters-handbook/
145 ports with one command.
153 target in order.
163 .Bl -tag -width ".Cm configure"
168 .Xr portconfig 1 Pq Pa ports/ports-mgmt/portconfig .
171 listed in
195 targets, this is run in piecemeal as
196 .Cm fetch-depends , build-depends ,
207 Some ports will ask you questions during this stage.
220 .It Cm install-missing-packages
225 .Bl -tag -width ".Cm fetch-recursive"
230 .It Cm showconfig-recursive
238 .It Cm rmconfig-recursive
242 .It Cm config-conditional
243 Skip the ports which have already had their
246 .It Cm config-recursive
250 .Xr portconfig 1 Pq Pa ports/ports-mgmt/portconfig .
251 .It Cm fetch-list
252 Show the list of files to fetch in order to build the port (but not its
254 .It Cm fetch-recursive
256 .It Cm fetch-recursive-list
258 .Cm fetch-recursive .
259 .It Cm build-depends-list , run-depends-list
261 .It Cm all-depends-list
263 .It Cm pretty-print-build-depends-list , pretty-print-run-depends-list
287 .Xr pkg-delete 8
292 .Xr pkg-delete 8 .
293 .It Cm deinstall-all
294 Remove all installed ports with the same
304 .Xr pkg-add 8 .
307 does not exist, the package will be put in
308 .Pa /usr/ports/category/port/work/pkg .
314 .It Cm package-recursive
318 .It Cm package-name
324 .Pa /usr/ports
325 to create a browsable web of all ports on your system!
343 (searches the port build-time dependency),
345 (searches the port run-time dependency),
354 .Dl "cd /usr/ports && make search name=query"
356 to find all ports whose
359 Results include the matching ports' path, comment, maintainer,
361 .Bd -literal -offset indent
362 cd /usr/ports && make search name=pear- \e
366 To find all ports whose
368 .Dq Li pear-
370 listed in build-time dependencies.
371 .Bd -literal -offset indent
372 cd /usr/ports && make search name=pear- \e
376 To find all ports whose names contain
377 .Dq Li pear- ,
382 .Bd -literal -offset indent
386 To find ports that contain
391 By default the search is not case-sensitive.
392 In order to make it case-sensitive you can use the
395 .Bd -literal -offset indent
396 make search name=p5-R icase=0
404 Generate a one-line description of each port for use in the
411 .Pa /usr/ports/INDEX ,
413 .Cm pretty-print-*
421 file is up to date with your ports tree.
431 .Bl -tag -width ".Va MASTER_SITES"
433 Location of the ports tree.
435 .Pa /usr/ports
441 is read-only (perhaps mounted from a CD-ROM).
454 .Ql /usr/bin/su root -c .
456 .Ql /usr/local/bin/sudo -E sh -c
468 .Bl -tag -width ".Va PKGREPOSITORY"
470 Directory to put the package in.
495 Try the download locations in a random order.
509 .Pa https://download.FreeBSD.org/ports/index/ .
517 .Dq Li "fetch -am" .
534 .Xr pkg-audit 8
535 when installing new ports.
537 If defined, allow installation of ports marked as
539 The default behavior of the Ports framework is to abort when the
541 Of course, these ports may not work as expected, but if you really know
555 .Pa /var/db/ports .
558 have been configured will have a uniquely named sub-directory, containing a
564 variables that are used when building ports.
565 More information on these and other related variables may be found in
570 .Bl -tag -width "WITH_CCACHE_BUILD"
573 If set, debugging symbols are installed for ports binaries.
578 .Pq Default: Ql -g
588 for building ports.
595 .Bl -tag -width ".Pa /usr/ports/Mk/bsd.port.mk" -compact
596 .It Pa /usr/ports
597 The default ports directory.
598 .It Pa /usr/ports/Mk/bsd.port.mk
602 .Bl -tag -width 0n
606 .Bd -literal -offset 2n
607 .Li # Ic cd /usr/ports/editors/emacs
616 .Bd -literal -offset 2n
617 .Li # Ic make install-missing-packages
628 .It Sy Example 3\&: No Building a Non-Default Flavor of a Port
630 The following command builds a non-default flavor of a port.
632 .Pa devel/py-pip
634 .Bd -literal -offset 2n
635 .Li # Ic cd /usr/ports/devel/py-pip
638 .It Sy Example 4\&: No Setting Ports Options via Xr make.conf 5
640 The following lines present various ways of configuring ports options via
644 .Bd -literal -offset 2n
645 # Enable NLS for all ports unless configured otherwise
648 # Disable DOCS for all ports overriding the options set
655 These and other options-related variables are documented in
656 .Pa /usr/ports/Mk/bsd.options.mk .
657 .It Sy Example 5\&: No Setting Xr make 1 Variables for Specific Ports via Xr make.conf 5
661 variables only specific ports:
662 .Bd -literal -offset 2n
669 .It Sy Example 6\&: No Debugging Ports
670 By default ports are built and packaged without debugging support (e.g.,
673 Whether ports are built with debugging symbols can be controlled by the
674 settings in
677 .Bd -literal -offset 2n
678 # Enable debugging for all ports.
680 # Enable debugging for selected ports.
685 .Bd -literal -offset 2n
686 .Li # Ic make -DWITH_DEBUG DEBUG_FLAGS="-g -O0" build
700 If debugging is enabled for a specific port, the ports framework will:
701 .Bl -bullet
706 .Ql -g )
712 .Ql install-strip
719 However, this is port-specific and the ports framework might not be aware of
730 .Bl -dash -width "" -offset indent
734 .Pa /usr/ports/Mk/bsd.port.mk
738 .Bl -dash -width "" -offset indent
742 .Lk "https://ports.FreeBSD.org" "Searchable index of all ports"
745 The Ports Collection
746 appeared in
753 .An -nosplit
757 Ports documentation is split over four places \(em
758 .Pa /usr/ports/Mk/bsd.port.mk ,
761 .Dq "Packages and Ports"