raw
v_mod6_genesis          1      ..::[ The Bitcoin Foundation: V Users Manual ]::..
v_mod6_genesis 2
v_mod6_genesis 3
v_mod6_genesis 4 Doc Version: 99994 K
v_mod6_genesis 5 Author: mod6
v_mod6_genesis 6 Fingerprint: 0x027A8D7C0FB8A16643720F40721705A8B71EADAF
v_mod6_genesis 7
v_mod6_genesis 8 0x00]: Introduction
v_mod6_genesis 9
v_mod6_genesis 10 Welcome to V!
v_mod6_genesis 11
v_mod6_genesis 12 This document is intended to be a users manual for mod6's perl implementation
v_mod6_genesis 13 of V. Contained herein the user will find usage explanations and examples of
v_mod6_genesis 14 the many options available.
v_mod6_genesis 15
v_mod6_genesis 16 0x01]: Getting Started
v_mod6_genesis 17
v_mod6_genesis 18 [ Check if perl is installed & version ]:
v_mod6_genesis 19
v_mod6_genesis 20 First, in order to execute the perl version of V, the user must have perl
v_mod6_genesis 21 version 5.005 or greater installed on the local UNIX environment. Perl
v_mod6_genesis 22 typically comes installed on many UNIX environments ahead of time, but just
v_mod6_genesis 23 to be sure, do the following from the command prompt:
v_mod6_genesis 24
v_mod6_genesis 25 perl --version
v_mod6_genesis 26
v_mod6_genesis 27 The user should see a lengthy version message that starts with something
v_mod6_genesis 28 like this:
v_mod6_genesis 29
v_mod6_genesis 30 `This is perl 5, version 18, subversion 2 (v5.18.2) ...'
v_mod6_genesis 31
v_mod6_genesis 32 If not, please install perl 5.005 or greater before going any further:
v_mod6_genesis 33
v_mod6_genesis 34 Ubuntu:
v_mod6_genesis 35 apt-get install -y perl
v_mod6_genesis 36
v_mod6_genesis 37 Gentoo:
v_mod6_genesis 38 emerge =perl-5.20.2.ebuild
v_mod6_genesis 39
v_mod6_genesis 40 [ Install CPAN ]:
v_mod6_genesis 41
v_mod6_genesis 42 If it is desired to at all use the graphing feature of V the user will need
v_mod6_genesis 43 to install CPAN [ `cpan` or `cpanm` or on gentoo, `g-cpan` ] so that the
v_mod6_genesis 44 Graph::Easy perl library can be installed.
v_mod6_genesis 45
v_mod6_genesis 46 Ubuntu:
v_mod6_genesis 47
v_mod6_genesis 48 apt-get install cpanminus
v_mod6_genesis 49 cpanm -i Graph::Easy
v_mod6_genesis 50
v_mod6_genesis 51 Gentoo [x86-64]:
v_mod6_genesis 52
v_mod6_genesis 53 emerge g-cpan
v_mod6_genesis 54
v_mod6_genesis 55 [ NOTE: Copy the next nine lines exacty as they are presented here and ]
v_mod6_genesis 56 [ then paste them into the shell. ]
v_mod6_genesis 57
v_mod6_genesis 58 cat <<EOF > /etc/portage/package.accept_keywords
v_mod6_genesis 59 # required by perl-gcpan/JSON-MaybeXS-1.003005::x-g-cpan
v_mod6_genesis 60 # required by JSON-MaybeXS (argument)
v_mod6_genesis 61 =dev-perl/Test-Without-Module-0.180.0 ~amd64
v_mod6_genesis 62 # required by perl-gcpan/Cpanel-JSON-XS-3.0115::x-g-cpan
v_mod6_genesis 63 # required by Cpanel-JSON-XS (argument)
v_mod6_genesis 64 =dev-perl/common-sense-3.730.0 ~amd64
v_mod6_genesis 65 EOF
v_mod6_genesis 66
v_mod6_genesis 67 g-cpan -i Graph::Easy
v_mod6_genesis 68
v_mod6_genesis 69 [ Install GnuPG ]:
v_mod6_genesis 70
v_mod6_genesis 71 The user will need GnuPG installed locally to run V, if you already have
v_mod6_genesis 72 this installed, skip this step.
v_mod6_genesis 73
v_mod6_genesis 74 Ubuntu:
v_mod6_genesis 75 sudo apt-get install -y gnupg
v_mod6_genesis 76
v_mod6_genesis 77 [NOTE: 1.4.19 seems to be the oldest portage a recent gentoo ships with)]:
v_mod6_genesis 78 Gentoo:
v_mod6_genesis 79 emerge =gnupg-1.4.19
v_mod6_genesis 80
v_mod6_genesis 81 [ Install wget ]:
v_mod6_genesis 82
v_mod6_genesis 83 Many UNIX systems come with `wget` installed already, if yours does not,
v_mod6_genesis 84 install it:
v_mod6_genesis 85
v_mod6_genesis 86 Ubuntu:
v_mod6_genesis 87 sudo apt-get install -y wget
v_mod6_genesis 88
v_mod6_genesis 89 Gentoo:
v_mod6_genesis 90 emerge wget
v_mod6_genesis 91
v_mod6_genesis 92 [ Install GraphViz ]:
v_mod6_genesis 93
v_mod6_genesis 94 In addition to Graph::Easy, if you wish to have V automatically build the
v_mod6_genesis 95 SVG graph in an HTML output file for you from the Dot language output file,
v_mod6_genesis 96 also output by V, you need to install GraphViz.
v_mod6_genesis 97
v_mod6_genesis 98 Ubuntu:
v_mod6_genesis 99 sudo apt-get install -y graphviz
v_mod6_genesis 100
v_mod6_genesis 101 Gentoo:
v_mod6_genesis 102 emerge -a graphviz
v_mod6_genesis 103 etc-update [ enter -5 when prompted ]
v_mod6_genesis 104 emerge -a graphviz [ Answer Yes at prompt ]
v_mod6_genesis 105
v_mod6_genesis 106 [ Download V Archive ]:
v_mod6_genesis 107
v_mod6_genesis 108 Now you must obtain the V archive & signature from:
v_mod6_genesis 109
v_mod6_genesis 110 http://thebitcoin.foundation/v/V-20170317.tar.gz
v_mod6_genesis 111 http://thebitcoin.foundation/v/V-20170317.tar.gz.mod6.sig
v_mod6_genesis 112
v_mod6_genesis 113 Then check the PGP signatures supplied:
v_mod6_genesis 114
v_mod6_genesis 115 wget http://mod6.net/mod6.asc -O mod6.asc
v_mod6_genesis 116 gpg --import mod6.asc
v_mod6_genesis 117
v_mod6_genesis 118 [ Key Fingerprint: 0x027A8D7C0FB8A16643720F40721705A8B71EADAF ]
v_mod6_genesis 119
v_mod6_genesis 120 gpg --verify V-20170317.tar.gz.mod6.sig V-20170317.tar.gz
v_mod6_genesis 121
v_mod6_genesis 122 Then unpack the archive:
v_mod6_genesis 123
v_mod6_genesis 124 tar -xf V-20170317.tar.gz
v_mod6_genesis 125
v_mod6_genesis 126 [ Start V for the first time ]:
v_mod6_genesis 127
v_mod6_genesis 128 First, set the executable bit on v.pl:
v_mod6_genesis 129
v_mod6_genesis 130 chmod 0755 v.pl
v_mod6_genesis 131
v_mod6_genesis 132 Before you get any further, create a '.wot' directory (V looks for '.wot'
v_mod6_genesis 133 in the current working directory by default) and populate it with PGP public
v_mod6_genesis 134 keys manually. Name the pubkey files as such: <wotid>.asc
v_mod6_genesis 135
v_mod6_genesis 136 For example: mod6.asc
v_mod6_genesis 137
v_mod6_genesis 138 Now have V sync the required Seals and Patches directories from a signed
v_mod6_genesis 139 mirror. To view the list of mirrors, run the following command, the output
v_mod6_genesis 140 you'll see below.
v_mod6_genesis 141
v_mod6_genesis 142 ./v.pl m v_mirrors
v_mod6_genesis 143 Mirrors signed by (mod6):
v_mod6_genesis 144 http://thebitcoin.foundation
v_mod6_genesis 145
v_mod6_genesis 146 As stated from mirrors output we can use URL from The Bitcoin Foundation to
v_mod6_genesis 147 sync V up-to-date with all the latest WoT entries (PGP Public Keys), VPatch
v_mod6_genesis 148 Signatures (Seals) and Vpatches.
v_mod6_genesis 149
v_mod6_genesis 150 To begin this initial sync do the following:
v_mod6_genesis 151
v_mod6_genesis 152 ./v.pl i http://thebitcoin.foundation
v_mod6_genesis 153
v_mod6_genesis 154
v_mod6_genesis 155 0x01]: V Usage
v_mod6_genesis 156
v_mod6_genesis 157 At this point the user has installed all of V's requirements, performed a
v_mod6_genesis 158 lookup of available signed mirrors, and sync'd the WoT, Patches and Seals.
v_mod6_genesis 159
v_mod6_genesis 160 What follows are usages and definitions of V's options with examples.
v_mod6_genesis 161
v_mod6_genesis 162 A note about option syntax. Any option enclosed with parenthesis ( ) is
v_mod6_genesis 163 required. The | separates any aliases of commands. Square brackets [ ]
v_mod6_genesis 164 denote optional options. Angle brackets < > denote required arguments to
v_mod6_genesis 165 a given command.
v_mod6_genesis 166
v_mod6_genesis 167 [ m | mirrors ]:
v_mod6_genesis 168 Arguments:
v_mod6_genesis 169 (<output_dir>)
v_mod6_genesis 170
v_mod6_genesis 171 The m or mirrors command is available to connect to the main V site:
v_mod6_genesis 172 http://thebitcoin.foundation Here, V can connect and pull the list of
v_mod6_genesis 173 available mirrors, signed by mirror administrators with L1 trust with
v_mod6_genesis 174 assbot and are in good standing in the WoT. Ask mod6 about this if you
v_mod6_genesis 175 want to run an authorized, signed mirror of V.
v_mod6_genesis 176
v_mod6_genesis 177 The mirrors command takes one required argument, an output directory for the
v_mod6_genesis 178 list of mirrors and the signatures so V can verify the list.
v_mod6_genesis 179
v_mod6_genesis 180 Example:
v_mod6_genesis 181 ./v.pl m v_mirrors
v_mod6_genesis 182 Mirrors signed by (mod6):
v_mod6_genesis 183 http://thebitcoin.foundation
v_mod6_genesis 184
v_mod6_genesis 185 [ i | init ]:
v_mod6_genesis 186
v_mod6_genesis 187 Arguments & Options:
v_mod6_genesis 188 (mirror_url) [(<pdir> <sdir>)]
v_mod6_genesis 189
v_mod6_genesis 190 The i or init command is intended to be utilized the first time running V
v_mod6_genesis 191 on an environment. It takes one required option, and two optional
v_mod6_genesis 192 options. The required argument is a V mirror URL to sync from. Next, the
v_mod6_genesis 193 user can choose to use the default Patches ('patches' in the current working
v_mod6_genesis 194 directory) and Seals (.seals in the current working directory) directories
v_mod6_genesis 195 by not setting the two <pdir> or <sdir> options -- only passing a mirror URL
v_mod6_genesis 196 argument to the init command. If the user wishes to use their own named
v_mod6_genesis 197 directories, simply pass in those arguements in the exact order specified.
v_mod6_genesis 198
v_mod6_genesis 199 Example:
v_mod6_genesis 200 ./v.pl i http://thebitcoin.foundation
v_mod6_genesis 201 Full vpatch sync complete to "/home/mod6/patches"
v_mod6_genesis 202 Seal sync complete to "/home/mod6/.seals"
v_mod6_genesis 203
v_mod6_genesis 204 Example:
v_mod6_genesis 205 ./v.pl i http://thebitcoin.foundation wot vpatches seals
v_mod6_genesis 206 Full vpatch sync complete to "vpatches"
v_mod6_genesis 207 Seal sync complete to "seals"
v_mod6_genesis 208
v_mod6_genesis 209 [ wd | wotdir ]:
v_mod6_genesis 210
v_mod6_genesis 211 Arguments:
v_mod6_genesis 212 (<wotdir>)
v_mod6_genesis 213
v_mod6_genesis 214 The wd or wotdir command is available to point V at a specific WoT
v_mod6_genesis 215 directory rather than the default: '.wot' (in the current working directory)
v_mod6_genesis 216 There is one required argument: a WoT directory.
v_mod6_genesis 217
v_mod6_genesis 218 Example case, only mod6.asc exists in wot2:
v_mod6_genesis 219 ./v.pl f wd wot2
v_mod6_genesis 220 genesis.vpatch (mod6)
v_mod6_genesis 221 bitcoin-asciilifeform.1.vpatch (mod6)
v_mod6_genesis 222 rm_rf_upnp.vpatch (mod6)
v_mod6_genesis 223 ...
v_mod6_genesis 224
v_mod6_genesis 225 [ pd | patchdir ]:
v_mod6_genesis 226
v_mod6_genesis 227 Arguments:
v_mod6_genesis 228 (<patchdir>)
v_mod6_genesis 229
v_mod6_genesis 230 The pd or patchdir command is available to point V at a specific patch
v_mod6_genesis 231 directory rather than the default: 'patches', in V's present working
v_mod6_genesis 232 directory. There is one required argument: a vpatches directory.
v_mod6_genesis 233
v_mod6_genesis 234 Example case, only genesis.vpatch exists in patches2:
v_mod6_genesis 235 ./v.pl f pd patches2
v_mod6_genesis 236 genesis.vpatch (asciilifeform, mircea_popescu, mod6, trinque)
v_mod6_genesis 237
v_mod6_genesis 238 [ sd | sealdir ]:
v_mod6_genesis 239
v_mod6_genesis 240 Arguments:
v_mod6_genesis 241 (<sealdir>)
v_mod6_genesis 242
v_mod6_genesis 243 The sd or sealdir command is available to point V at a specific seal
v_mod6_genesis 244 directory rather than the default: '.seals' (in the current working
v_mod6_genesis 245 directory)
v_mod6_genesis 246 There is one required argument: a seals directory.
v_mod6_genesis 247
v_mod6_genesis 248 Example case, only seals created by mod6 exist in seal2:
v_mod6_genesis 249 ./v.pl f sd seals2/
v_mod6_genesis 250 genesis.vpatch (mod6)
v_mod6_genesis 251 bitcoin-asciilifeform.1.vpatch (mod6)
v_mod6_genesis 252 rm_rf_upnp.vpatch (mod6)
v_mod6_genesis 253 ...
v_mod6_genesis 254
v_mod6_genesis 255 [ w | wot ]:
v_mod6_genesis 256
v_mod6_genesis 257 Options:
v_mod6_genesis 258 [ finger ]
v_mod6_genesis 259
v_mod6_genesis 260 The w or wot command will build a list of WoT entities eligable for
v_mod6_genesis 261 creating seals for approved vpatches. If a specific vpatch has not
v_mod6_genesis 262 been signed by a WoT entity, it is considered a 'WILD' vpatch, and will be
v_mod6_genesis 263 ignored. A vpatch must be signed by both Co-Chairs of The Bitcoin Foundation
v_mod6_genesis 264 to be considered approved for release.
v_mod6_genesis 265
v_mod6_genesis 266 Example:
v_mod6_genesis 267 ./v.pl w
v_mod6_genesis 268 asciilifeform:17215D118B7239507FAFED98B98228A001ABFFC7:Stanislav Datskovskiy <stas@loper-os.org>
v_mod6_genesis 269 ben_vulpes:4F7907942CA8B89B01E25A762AFA1A9FD2D031DA:Ben Vulpes <benkay@gmail.com>
v_mod6_genesis 270 mircea_popescu:6160E1CAC8A3C52966FD76998A736F0E2FB7B452:Mircea Popescu (Acest articol are apriori avantajul aliteralitatii alaturi.) <office@polimedia.us>
v_mod6_genesis 271 mod6:027A8D7C0FB8A16643720F40721705A8B71EADAF:mod6 (mod6) <modsix@gmail.com>
v_mod6_genesis 272 punkman:F28E0095843B91CB22E7D65533588BE08B232B13:punkman
v_mod6_genesis 273 trinque:FC66C0C5D98C42A1D4A98B6B42F9985AFAB953C4:Michael Trinque <mike@trinque.org>
v_mod6_genesis 274
v_mod6_genesis 275 ./v.pl w finger
v_mod6_genesis 276 asciilifeform-B98228A001ABFFC7:17215D118B7239507FAFED98B98228A001ABFFC7:Stanislav Datskovskiy <stas@loper-os.org>
v_mod6_genesis 277 ben_vulpes-2AFA1A9FD2D031DA:4F7907942CA8B89B01E25A762AFA1A9FD2D031DA:Ben Vulpes <benkay@gmail.com>
v_mod6_genesis 278 mircea_popescu-8A736F0E2FB7B452:6160E1CAC8A3C52966FD76998A736F0E2FB7B452:Mircea Popescu (Acest articol are apriori avantajul aliteralitatii alaturi.) <office@polimedia.us>
v_mod6_genesis 279 mod6-721705A8B71EADAF:027A8D7C0FB8A16643720F40721705A8B71EADAF:mod6 (mod6) <modsix@gmail.com>
v_mod6_genesis 280 punkman-33588BE08B232B13:F28E0095843B91CB22E7D65533588BE08B232B13:punkman
v_mod6_genesis 281 trinque-42F9985AFAB953C4:FC66C0C5D98C42A1D4A98B6B42F9985AFAB953C4:Michael Trinque <mike@trinque.org>
v_mod6_genesis 282
v_mod6_genesis 283 [ r | roots ]:
v_mod6_genesis 284
v_mod6_genesis 285 The r or roots command takes no options or arguments, unless a different
v_mod6_genesis 286 pd or patchdir is specified. It simply traverses the vpatch directories
v_mod6_genesis 287 contained vpatches and returns any root vpatches found in the topological
v_mod6_genesis 288 order.
v_mod6_genesis 289
v_mod6_genesis 290 Examples:
v_mod6_genesis 291 ./v.pl r
v_mod6_genesis 292 Root: genesis.vpatch (asciilifeform, mircea_popescu, mod6, trinque)
v_mod6_genesis 293
v_mod6_genesis 294 Examples:
v_mod6_genesis 295 ./v.pl r pd patches2
v_mod6_genesis 296 Root: genesis.vpatch (asciilifeform, mircea_popescu, mod6, trinque)
v_mod6_genesis 297
v_mod6_genesis 298 [ l | leafs ]:
v_mod6_genesis 299
v_mod6_genesis 300 The l or leafs command takes no options or arguments, unless a different
v_mod6_genesis 301 pd or patchdir is specified. It simply traverses the vpatch directories
v_mod6_genesis 302 contained vpatches and returns any leaf vpatches found in the topological
v_mod6_genesis 303 order.
v_mod6_genesis 304
v_mod6_genesis 305 Examples:
v_mod6_genesis 306 ./v.pl l
v_mod6_genesis 307 Leaf: asciilifeform_add_verifyall_option.vpatch (asciilifeform, mod6)
v_mod6_genesis 308 Leaf: asciilifeform_maxint_locks_corrected.vpatch (asciilifeform, mod6)
v_mod6_genesis 309
v_mod6_genesis 310 Example case, only genesis.vpatch exists in patches2:
v_mod6_genesis 311 ./v.pl l pd patches2
v_mod6_genesis 312 Leaf: genesis.vpatch (asciilifeform, mircea_popescu, mod6, trinque)
v_mod6_genesis 313
v_mod6_genesis 314 [ f | flow ]:
v_mod6_genesis 315
v_mod6_genesis 316 The f or flow command prints a topoligical flow of vpatches based on
v_mod6_genesis 317 precedence. By default will look for the 'patches' directory in the present
v_mod6_genesis 318 working directory of V and print the flow to stdout.
v_mod6_genesis 319
v_mod6_genesis 320 Example:
v_mod6_genesis 321 ./v.pl f
v_mod6_genesis 322 genesis.vpatch (asciilifeform, mircea_popescu, mod6, trinque)
v_mod6_genesis 323 bitcoin-asciilifeform.1.vpatch (asciilifeform, mod6)
v_mod6_genesis 324 rm_rf_upnp.vpatch (asciilifeform, mod6)
v_mod6_genesis 325 bitcoin-asciilifeform.3-turdmeister-alert-snip.vpatch (asciilifeform, mod6)
v_mod6_genesis 326 bitcoin-asciilifeform.2-https_snipsnip.vpatch (asciilifeform, mod6)
v_mod6_genesis 327 bitcoin-asciilifeform.4-goodbye-win32.vpatch (asciilifeform, mod6)
v_mod6_genesis 328 asciilifeform_dnsseed_snipsnip.vpatch (asciilifeform, mod6)
v_mod6_genesis 329 asciilifeform_zap_hardcoded_seeds.vpatch (asciilifeform, mod6)
v_mod6_genesis 330 asciilifeform-kills-integer-retardation.vpatch (asciilifeform, mod6)
v_mod6_genesis 331 asciilifeform_zap_showmyip_crud.vpatch (asciilifeform, mod6)
v_mod6_genesis 332 asciilifeform_dns_thermonyukyoolar_kleansing.vpatch (asciilifeform, mod6)
v_mod6_genesis 333 asciilifeform_and_now_we_have_block_dumper_corrected.vpatch (asciilifeform, mod6)
v_mod6_genesis 334 mod6_fix_dumpblock_params.vpatch (asciilifeform, mod6)
v_mod6_genesis 335 bitcoin-v0_5_3_1-static_makefile_v002.8.vpatch (asciilifeform, mod6)
v_mod6_genesis 336 bitcoin-v0_5_3_1-rev_bump.7.vpatch (asciilifeform, mod6)
v_mod6_genesis 337 asciilifeform_ver_now_5_4_and_irc_is_gone_and_now_must_give_ip.vpatch (asciilifeform, mod6)
v_mod6_genesis 338 asciilifeform_orphanage_thermonuke.vpatch (asciilifeform, mod6)
v_mod6_genesis 339 asciilifeform_and_now_we_have_eatblock.vpatch (asciilifeform, mod6)
v_mod6_genesis 340 bitcoin-v0_5_3-db_config.6.vpatch (asciilifeform, mod6)
v_mod6_genesis 341 asciilifeform_tx-orphanage_amputation.vpatch (asciilifeform, mod6)
v_mod6_genesis 342 asciilifeform_maxint_locks_corrected.vpatch (asciilifeform, mod6)
v_mod6_genesis 343 asciilifeform_lets_lose_testnet.vpatch (asciilifeform, mod6)
v_mod6_genesis 344 asciilifeform_add_verifyall_option.vpatch (asciilifeform, mod6)
v_mod6_genesis 345
v_mod6_genesis 346 Example case, only genesis.vpatch exists in patches2:
v_mod6_genesis 347 ./v.pl f pd patches2
v_mod6_genesis 348 genesis.vpatch (asciilifeform, mircea_popescu, mod6, trinque)
v_mod6_genesis 349
v_mod6_genesis 350 [ p | press ]:
v_mod6_genesis 351
v_mod6_genesis 352 Arguments:
v_mod6_genesis 353 (<press_dir> <head>)
v_mod6_genesis 354
v_mod6_genesis 355 The p or press command is available to apply vpatches up through <head> in
v_mod6_genesis 356 topological order (see flow command) to an output directory <press_dir>.
v_mod6_genesis 357 There are two required arguments; an output directory for applied patches
v_mod6_genesis 358 <press_dir> and a vpatch <head> as the tip of the tree to press up through.
v_mod6_genesis 359 By default, no output is shown; however if the user supplies `v' or
v_mod6_genesis 360 `verbose' directly after the p or press command then the output from the
v_mod6_genesis 361 patching applcation process will be directed to stdout.
v_mod6_genesis 362
v_mod6_genesis 363 Example:
v_mod6_genesis 364 ./v.pl p press_output genesis.vpatch
v_mod6_genesis 365
v_mod6_genesis 366 Example:
v_mod6_genesis 367 ./v.pl p verbose press_verbose genesis.vpatch
v_mod6_genesis 368 genesis.vpatch
v_mod6_genesis 369 patching file bitcoin/.gitignore
v_mod6_genesis 370 patching file bitcoin/COPYING
v_mod6_genesis 371 patching file bitcoin/src/base58.h
v_mod6_genesis 372 patching file bitcoin/src/bignum.h
v_mod6_genesis 373 patching file bitcoin/src/bitcoinrpc.cpp
v_mod6_genesis 374 patching file bitcoin/src/bitcoinrpc.h
v_mod6_genesis 375 patching file bitcoin/src/checkpoints.cpp
v_mod6_genesis 376 patching file bitcoin/src/checkpoints.h
v_mod6_genesis 377 patching file bitcoin/src/crypter.cpp
v_mod6_genesis 378 patching file bitcoin/src/crypter.h
v_mod6_genesis 379 patching file bitcoin/src/db.cpp
v_mod6_genesis 380 patching file bitcoin/src/db.h
v_mod6_genesis 381 patching file bitcoin/src/headers.h
v_mod6_genesis 382 patching file bitcoin/src/init.cpp
v_mod6_genesis 383 ...
v_mod6_genesis 384
v_mod6_genesis 385 [ ss | sync-seals ]:
v_mod6_genesis 386
v_mod6_genesis 387 Arguments:
v_mod6_genesis 388 (<mirror_url> <sdir>)
v_mod6_genesis 389
v_mod6_genesis 390 The ss or sync-seals command is avilable to allow the user to sync seal to
v_mod6_genesis 391 an alternative directory. Two arguments are required; the <mirror_url>
v_mod6_genesis 392 from which to sync and the alternative or existing seals directory <sdir>.
v_mod6_genesis 393
v_mod6_genesis 394 Example:
v_mod6_genesis 395 ./v.pl ss http://thebitcoin.foundation seals2
v_mod6_genesis 396 Seal sync complete to "seals2"
v_mod6_genesis 397
v_mod6_genesis 398 [ sv | sync-vpatches ]:
v_mod6_genesis 399
v_mod6_genesis 400 Arguments:
v_mod6_genesis 401 (<mirror_url> <pdir> <vpatches>... )
v_mod6_genesis 402
v_mod6_genesis 403 The sv or sync-vpatches command is availabe to allow the user to sync one or
v_mod6_genesis 404 more individual vpatches to a alternative output directory. Three arguments
v_mod6_genesis 405 are required; the <mirror_url> from which to sync, the alternative or
v_mod6_genesis 406 existing directory <pdir> and one or more <vpatches>.
v_mod6_genesis 407
v_mod6_genesis 408 Example case, sync one vpatch to an existing patches directory:
v_mod6_genesis 409 ./v.pl sv http://thebitcoin.foundation patches genesis.vpatch
v_mod6_genesis 410 genesis.vpatch sync complete to "patches"
v_mod6_genesis 411
v_mod6_genesis 412 Example case, sync more than one vpatch to an alternative patches directory:
v_mod6_genesis 413 ./v.pl sv http://thebitcoin.foundation patches2 genesis.vpatch rm_rf_upnp.vpatch
v_mod6_genesis 414 genesis.vpatch sync complete to "patches2"
v_mod6_genesis 415 rm_rf_upnp.vpatch sync complete to "patches2"
v_mod6_genesis 416
v_mod6_genesis 417 [ sa | sync-all-vpatches ]:
v_mod6_genesis 418
v_mod6_genesis 419 Arguments:
v_mod6_genesis 420 (<mirror_url> <pdir>)
v_mod6_genesis 421
v_mod6_genesis 422 The sa or sync-all-vpatches command is avilable to allow the user to sync
v_mod6_genesis 423 all vpatches from a given mirror to an alternative output directory. Two
v_mod6_genesis 424 arguments are required; the <mirror_url> from which to sync and the
v_mod6_genesis 425 alternative or existing patches directory <pdir>.
v_mod6_genesis 426
v_mod6_genesis 427 Example case, sync all vpatches to the pre-existing patches directory:
v_mod6_genesis 428 ./v.pl sa http://thebitcoin.foundation patches
v_mod6_genesis 429 Full vpatch sync complete to "patches"
v_mod6_genesis 430
v_mod6_genesis 431 Example case, sync all vpatches to an alternative patches directory:
v_mod6_genesis 432 ./v.pl sa http://thebitcoin.foundation patches2
v_mod6_genesis 433 Full vpatch sync complete to "patches2"
v_mod6_genesis 434
v_mod6_genesis 435 [ se | sync-everything ]:
v_mod6_genesis 436
v_mod6_genesis 437 Arguments:
v_mod6_genesis 438 (<mirror_url> <pdir> <sdir>)
v_mod6_genesis 439
v_mod6_genesis 440 The se or sync-everything command is available to allow the user to sync
v_mod6_genesis 441 all patches and seals from a given mirror to either existing or alternative
v_mod6_genesis 442 directories. Three arguments are required; the <mirror_url> from which to
v_mod6_genesis 443 sync, the existing or alternative output patches directory <pdir>, and the
v_mod6_genesis 444 existing or alternative seals directory <sdir>.
v_mod6_genesis 445
v_mod6_genesis 446 ./v.pl se http://thebitcoin.foundation patches2 seals2
v_mod6_genesis 447 Full vpatch sync complete to "patches2"
v_mod6_genesis 448 Seal sync complete to "seals2"
v_mod6_genesis 449
v_mod6_genesis 450 [ a | ante | antecedents ]:
v_mod6_genesis 451
v_mod6_genesis 452 Arguments:
v_mod6_genesis 453 (<vpatch>)
v_mod6_genesis 454
v_mod6_genesis 455 The a or ante or antecedents command is available to allow the user to view
v_mod6_genesis 456 the antecedents of a given vpatch. One argument is required, the name of a
v_mod6_genesis 457 <vpatch>.
v_mod6_genesis 458
v_mod6_genesis 459 Example:
v_mod6_genesis 460 ./v.pl a mod6_fix_dumpblock_params.vpatch
v_mod6_genesis 461 Antecedent: asciilifeform_and_now_we_have_block_dumper_corrected.vpatch \
v_mod6_genesis 462 (asciilifeform, mod6) [ a/bitcoin/src/bitcoinrpc.cpp ]
v_mod6_genesis 463
v_mod6_genesis 464 Example case, examine the antecedents of a given vpatch from an alternative
v_mod6_genesis 465 directory:
v_mod6_genesis 466 ./v.pl a asciilifeform_zap_showmyip_crud.vpatch pd patches2
v_mod6_genesis 467 Antecedent: asciilifeform_zap_hardcoded_seeds.vpatch (asciilifeform, mod6) \
v_mod6_genesis 468 [ a/bitcoin/src/net.cpp ]
v_mod6_genesis 469
v_mod6_genesis 470 [ d | desc | descendants ]:
v_mod6_genesis 471
v_mod6_genesis 472 Arguments:
v_mod6_genesis 473 (<vpatch>)
v_mod6_genesis 474
v_mod6_genesis 475 The d or desc or descendants command is available to allow the user to view
v_mod6_genesis 476 the descendants of a given <vpatch>. One argument is required, the name of
v_mod6_genesis 477 a <vpatch>.
v_mod6_genesis 478
v_mod6_genesis 479 Example:
v_mod6_genesis 480 ./v.pl d mod6_fix_dumpblock_params.vpatch
v_mod6_genesis 481 Descendant: asciilifeform_and_now_we_have_eatblock.vpatch \
v_mod6_genesis 482 (asciilifeform, mod6) [ a/bitcoin/src/bitcoinrpc.cpp ]
v_mod6_genesis 483
v_mod6_genesis 484 Example case, examine the descendants of a given vpatch from an alternative
v_mod6_genesis 485 directory:
v_mod6_genesis 486 ./v.pl d asciilifeform_zap_showmyip_crud.vpatch pd patches2
v_mod6_genesis 487 Descendant: asciilifeform_dns_thermonyukyoolar_kleansing.vpatch \
v_mod6_genesis 488 (asciilifeform, mod6) [ a/bitcoin/src/net.cpp ]
v_mod6_genesis 489
v_mod6_genesis 490 [ o | origin ]:
v_mod6_genesis 491
v_mod6_genesis 492 Arguments:
v_mod6_genesis 493 (<sha512_hash>)
v_mod6_genesis 494
v_mod6_genesis 495 The o or origin command is avaliable to allow the user to pass a sha512
v_mod6_genesis 496 hash and view where the given hash originated in the source tree.
v_mod6_genesis 497
v_mod6_genesis 498 [ g | graph ]:
v_mod6_genesis 499
v_mod6_genesis 500 Arguments & Options:
v_mod6_genesis 501 (<output_dotfile> [<output_svg_html_file>])
v_mod6_genesis 502
v_mod6_genesis 503 The g or graph command is available to produce a topoligical flow graph in
v_mod6_genesis 504 SVG format. The command has a required argument, the <output_dotfile>.
v_mod6_genesis 505 The output Dot language file can be used to generate the SVG HTML output
v_mod6_genesis 506 file with the `dot` binary. To produce the output Dot language file, the
v_mod6_genesis 507 perl library Graph::Easy must be installed on the local environment.
v_mod6_genesis 508 The optional command is given as a name for the <output_svg_html_file>.
v_mod6_genesis 509 If 'graphviz' is installed on the local environment, then the `dot` binary
v_mod6_genesis 510 should be available for V to invoke and generate the SVG HTML output for
v_mod6_genesis 511 the user automatically. If it is not possible for the user to install
v_mod6_genesis 512 'graphviz' on the local environment for whatever reason, the Dot language
v_mod6_genesis 513 output file can be copied to a seperate environment where 'graphviz' can be
v_mod6_genesis 514 installed. A command like this is used to generate the SVG HTML output
v_mod6_genesis 515 with the `dot` binary: `dot -Tsvg v-graph.dot > v-graph.html`.
v_mod6_genesis 516
v_mod6_genesis 517 Example:
v_mod6_genesis 518 ./v.pl g vpatch.dot vpatch-graph.html
v_mod6_genesis 519 Printed Graphviz dot file to vpatch.dot
v_mod6_genesis 520 Executed `dot` and built svg html output file: vpatch-graph.html
v_mod6_genesis 521
v_mod6_genesis 522 Example case, build a graph from an alternative WoT, Patches and Seals
v_mod6_genesis 523 directory:
v_mod6_genesis 524 ./v.pl g vpatch-graph2.dot vpatch-graph2.html wd wot2 pd patches2 sd seals2
v_mod6_genesis 525 Printed Graphviz dot file to vpatch-graph2.dot
v_mod6_genesis 526 Executed `dot` and built svg html output file: vpatch-graph2.html
v_mod6_genesis 527
v_mod6_genesis 528 [ v | version ]:
v_mod6_genesis 529
v_mod6_genesis 530 The v or version command simply prints the current version of V to stdout.
v_mod6_genesis 531 This command takes no options or arguments.
v_mod6_genesis 532
v_mod6_genesis 533 [ h | ? | help ]:
v_mod6_genesis 534
v_mod6_genesis 535 The h or ? or help command will print a longer, more verbose help message
v_mod6_genesis 536 to stdout. This command takes no options or arguments.