Commit | Line | Data |
---|---|---|
db2c5b8b MW |
1 | # Definition of mirror hosts we push. |
2 | # One mirror per line, with the following fields defined. | |
3 | # | |
4 | # Type ShortName HostName User SSHProtocol SSHKeyFile | |
5 | # | |
6 | # ALTERNATIVELY the line may look like | |
7 | # | |
8 | # Type ShortName HostName User -$SOMESSHOPTION | |
9 | # | |
10 | # The fields Type, ShortName, HostName and User are *mandantory*. | |
11 | # | |
12 | # Type is either all, staged or mhop, meaning: | |
13 | # all - do a "normal" push. Trigger them, go on. | |
14 | # staged - do a two-stage push, waiting for them after stage 2(and all others that | |
15 | # are staged) before doing stage2 | |
16 | # mhop - send a multi-hop staged push. This will tell the mirror to initiate | |
17 | # a mhop/stage1 push to its staged/mhop mirrors and then exit. | |
18 | # When all mhop got back we then send the stage2 through to them. | |
19 | # | |
20 | # ShortName will be used as a shorthand in logfile outputs and for the logfile | |
21 | # where every ssh output gets redirected to. | |
22 | # | |
23 | # If no SSHKeyFile is given, the default from the config file applies. | |
24 | # If SSHProtocol is empty, it will default to 2, but if you want to | |
25 | # define a keyfile you HAVE TO set protocol too! | |
26 | # | |
27 | # With the ALTERNATIVE syntax you are able to use any special ssh option | |
28 | # you want just for one special mirror. The option after the username | |
29 | # then MUST start with a -, in which case the whole rest of the line is taken | |
30 | # as a set of options to give to ssh, it is passed through without doing | |
31 | # anything with it. | |
32 | # | |
33 | # There is one caveat here: Should you want to use the -i option to give | |
34 | # another ssh key to use, keep in mind that the master keyfile will | |
35 | # always be presented too! That is, ssh will show both keys to the other | |
36 | # side and the first one presented wins. Which might not be the key you | |
37 | # want. There is currently no way around this, as that would mean | |
38 | # dropping backward compatibility. | |
39 | # | |
40 | # Backwards compatibility: | |
41 | # An older runmirrors script will NOT run with a newer runmirrors.mirror file, but | |
42 | # a new runmirrors can run with an old runmirrors.mirror file. This should make updates | |
43 | # painless. | |
44 | # | |
45 | # Examples: | |
46 | # all eu.puccini puccini.debian.org archvsync 2 | |
47 | # | |
48 | # -> will push puccini.debian.org, user archvsync, using ssh protocol 2 | |
49 | # and the globally configured ssh key. | |
50 | # | |
51 | # all eu.puccini puccini.debian.org archvsync -p 2222 | |
52 | # | |
53 | # -> will do the same as above, but use port 2222 to connect to. | |
54 | # | |
55 | # staged eu.puccini puccini.debian.org archvsync | |
56 | # staged eu.powell powell.debian.org archvsync | |
57 | # | |
58 | # -> will push both puccini and powell in stage1, waiting for both to | |
59 | # finish stage1 before stage2 gets pushed. The username will be archvsync. | |
60 | # | |
61 | # staged eu.puccini puccini.debian.org archvsync | |
62 | # mhop eu.powell powell.debian.org archvsync | |
63 | # | |
64 | # -> will do the same as above, but powell gets told about mhop and can then | |
65 | # push its own staged/mhop mirrors before returning. When both returned | |
66 | # then stage2 is sent to both. | |
67 | # | |
68 | # One special value is allowed: DELAY | |
69 | # This word has to be on a line itself, followed by a space and a number. | |
70 | # nothing else, not even whitespace. It will trigger a pause of $number | |
71 | # seconds between the two mirrors. If no number is given it defaults to | |
72 | # 600 seconds. |