dllist.1



    1 ." Text automatically generated by txt2man-1.4.7
    2 .TH dllist  "June 25, 2021" "" ""
    3 .SH NAME
    4 \fBdllist \fP- Show sources to be downloaded for compiling a port
    5 \fB
    6 .SH SYNOPSIS
    7 .nf
    8 .fam C
    9 \fBdllist\fP [--all] <port1> [\fIport2\fP \.\.\. \fIportN\fP]
   10 \fBdllist\fP --diff
   11 .fam T
   12 .fi
   13 .SH DESCRIPTION
   14 \fBdllist\fP displays a list of URLs that have to be downloaded for compiling
   15 the given \fBport\fP(s), using \fBprt-get\fP(8) to collect information on
   16 ports and installation status.
   17 .PP
   18 The script can operate in two modes: list files needed for specified
   19 ports, or list files needed to update the system.
   20 .PP
   21 The list is restricted to packages not currently installed,
   22 unless the --all option is specified.
   23 .PP
   24 \fBdllist\fP filters the list based on the contents of $PKGMK_SOURCE_DIR,
   25 reporting only those source files that are not found in the expected download
   26 location on the filesystem. It is the user's responsibility to ensure that
   27 $PKGMK_SOURCE_DIR is consistent for all invocations of \fBpkgmk\fB; otherwise
   28 \fBdllist\fP might exaggerate the number of downloads needed. For a similar reason,
   29 moving or renaming downloaded source files using a mechanism other
   30 than the \(oqrenames\(cq array of \fBPkgfile\fB(5) will cause \fBdllist\fP
   31 to report them as needing a fresh download.
   32 .SH OPTIONS
   33 .TP
   34 .B
   35 --all
   36 read the source array of each dependency (even those already installed)
   37 and print the URLs that have no corresponding file in $PKGMK_SOURCE_DIR
   38 .TP
   39 .B
   40 --diff
   41 display URLs needed for a system upgrade
   42 .SH EXAMPLES
   43 .TP
   44 .B
   45 \fBdllist\fP apache
   46 display the missing sources needed to build apache
   47 .TP
   48 .B
   49 \fBdllist\fP --all apache
   50 show the full list of files
   51 needed to build apache
   52 .TP
   53 .B
   54 \fBdllist\fP --diff
   55 list files to be downloaded for a system upgrade
   56 .SH SEE ALSO
   57 \fBprt-get\fP(8), \fBports\fP(8), \fBPkgfile\fP(5)
   58 .SH AUTHORS
   59 Johannes Winkelmann <jw at tks6 dot net>, John McQuah <jmcquah at disroot dot org>
   60 .RE
   61 .PP