source: trunk/base/doc/port-mirror.1 @ 134980

Last change on this file since 134980 was 125314, checked in by cal@…, 5 years ago

base: regenerate roff from asciidoc source

File size: 3.9 KB
Line 
1'\" t
2.TH "PORT\-MIRROR" "1" "2014\-09\-13" "MacPorts 2\&.3\&.99" "MacPorts Manual"
3.\" -----------------------------------------------------------------
4.\" * Define some portability stuff
5.\" -----------------------------------------------------------------
6.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
7.\" http://bugs.debian.org/507673
8.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
9.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
10.ie \n(.g .ds Aq \(aq
11.el       .ds Aq '
12.\" -----------------------------------------------------------------
13.\" * set default formatting
14.\" -----------------------------------------------------------------
15.\" disable hyphenation
16.nh
17.\" disable justification (adjust text to left margin only)
18.ad l
19.\" -----------------------------------------------------------------
20.\" * MAIN CONTENT STARTS HERE *
21.\" -----------------------------------------------------------------
22.SH "NAME"
23port-mirror \- Fetch distfiles for a port
24.SH "SYNOPSIS"
25.sp
26.nf
27\fBport\fR [\fB\-qvdp\fR] [\fB\-D\fR \fIportdir\fR] \fBmirror\fR
28     [\-\-new]
29     [[\fIportname\fR | \fIpseudo\-portname\fR | \fIport\-expressions\fR | \fIport\-url\fR]]
30.fi
31.SH "DESCRIPTION"
32.sp
33\fBport mirror\fR creates or updates a local mirror of source archives (called \fIdistfiles\fR in MacPorts lingo) for the ports given on the command line\&. It will download any file that can be fetched using the standard \fBlibcurl\fR(3) download method and ignore ports that fetch from version control systems such as Subversion or Git\&.
34.sp
35Downloaded files will be checked for consistency and deleted if the checksums don\(cqt match those specified in the \fIPortfile\fR\&. Additionally, successfully downloaded files are stored in a custom database in \fI$portdbpath/distfiles_mirror\&.db\fR, where \fI$portdbpath\fR can be configured in \fBmacports.conf\fR(5)\&. This database can be deleted and re\-created from scratch using the \fB\-\-new\fR option\&.
36.SH "OPTIONS"
37.PP
38\fB\-\-new\fR
39.RS 4
40Delete the existing database of mirrored files and re\-create it from scratch\&.
41.RE
42.SH "GLOBAL OPTIONS"
43.sp
44Please see the section \fBGLOBAL OPTIONS\fR in the \fBport\fR(1) man page for a description of global port options\&.
45.PP
46\fB\-p\fR
47.RS 4
48Don\(cqt abort downloading on the first error\&. This can be useful when attempting to create or update a full mirror, e\&.g\&. when using
49\fBport mirror all\fR\&.
50.RE
51.SH "EXAMPLES"
52.sp
53If your use case for \fBport mirror\fR is downloading the files you need to install a set of ports later without a network connection, do not use \fBport mirror\fR: It will not work for ports that distribute their source code using a version control system such as Subversion or Git\&. Instead, use \fBport fetch\fR:
54.sp
55.if n \{\
56.RS 4
57.\}
58.nf
59$> sudo port \-p fetch rdepof:$newport and not installed
60$> sudo port \-p fetch $newport
61.fi
62.if n \{\
63.RE
64.\}
65.sp
66These can also be conveniently wrapped in a single command using a port expression (see \fBport\fR(1) for details):
67.sp
68.if n \{\
69.RS 4
70.\}
71.nf
72$> sudo port \-p fetch $newport rdepof:$newport and not installed
73.fi
74.if n \{\
75.RE
76.\}
77.sp
78If your intention is creating a new complete mirror of all MacPorts distfiles, it is probably easier to sync them via rsync from our main mirror hosted by Mac OS Forge\&. See \m[blue]\fBMirrors\fR\m[]\&\s-2\u[1]\d\s+2 for details\&.
79.sp
80If you want to create a partial mirror of MacPorts distfiles or are running the main mirror for MacPorts, you should use \fBport mirror\fR:
81.sp
82.if n \{\
83.RS 4
84.\}
85.nf
86$> sudo port \-p mirror all
87$> sudo port \-p mirror maintainer:^cal or category:haskell
88.fi
89.if n \{\
90.RE
91.\}
92.SH "SEE ALSO"
93.sp
94\fBport\fR(1), \fBport-fetch\fR(1), \fBlibcurl\fR(3), \fBcurl\fR(1)
95.SH "AUTHORS"
96.sp
97.if n \{\
98.RS 4
99.\}
100.nf
101(C) 2014 The MacPorts Project
102Clemens Lang <cal@macports\&.org>
103.fi
104.if n \{\
105.RE
106.\}
107.SH "EXTERNAL REFERENCES"
108.IP " 1." 4
109Mirrors
110.RS 4
111\%https://trac.macports.org/wiki/Mirrors
112.RE
Note: See TracBrowser for help on using the repository browser.