urbit/base/pub/doc/reference/vere.md
Anton Dyudin 6cbb6b060d Revert "remove docs for demo", "remove odds and ends", "demo network", "DEMO ONLY: root beak as %demo.", "DEMO ONLY: don't show doznec flapping.", "Prinrtf."
This reverts commit 8e1e40d75b3ab15c194b6bf9570f3edc46e2de58.
This reverts commit f073c490f9fd7c5abc033af4857df92229877de7.
This reverts commit f187d2d7e01a54823f3e979af9bbd148b398e7e9.
This reverts commit bc272862a73cfce1b118586ca39d3a377d841f1b.
This reverts commit 30a397513f8890a3406dc7ab91c6e067e3bbfbbb.
This reverts commit 4fc6856fb50d88c20a0f533392ca606641c5f38f.

Conflicts:
	urb/urbit.pill
	urb/zod/base/lib/drum.hoon
2015-06-15 18:10:02 -07:00

184 lines
3.4 KiB
Markdown

<div class="short">
vere
====
vere is the Urbit virtual machine.
bin/vere -c ship
------------------------------------------------------------------------
Options
-------
### `-b`
Batch create
------------------------------------------------------------------------
### `-c`
Create
Creates a new pier. Takes a folder name, such as `pier`.
bin/vere -c pier
------------------------------------------------------------------------
### `-d`
Daemon
------------------------------------------------------------------------
### `-D`
Dry compute
dry compute the north and/or south events
------------------------------------------------------------------------
### `-f`
Fuzz testing
------------------------------------------------------------------------
### `-k`
Kernel version
------------------------------------------------------------------------
### `-l`
Raft port
------------------------------------------------------------------------
### `-L`
Localhost.
Routes all networking over `0.0.0.0` and checks the keys.
bin/vere -L -I ~del -c fz
------------------------------------------------------------------------
### `-M`
Memory madness
------------------------------------------------------------------------
### `-n`
Unix hostname
------------------------------------------------------------------------
### `-p`
Specify the [`%ames`](/doc/arvo/ames) udp listening port.
bin/vere -p 42665
It can sometimes help if you get a port pointed at you and run vere with
`-p` to specify the [`%ames`](/doc/arvo/ames) udp listening port. VMs
and [docker](http://www.docker.com/) containers and the like tend to put
up some pretty effective barriers to
[NAT](http://en.wikipedia.org/wiki/Network_address_translation) [hole
punching](http://en.wikipedia.org/wiki/TCP_hole_punching).
------------------------------------------------------------------------
### `-P`
Profile
------------------------------------------------------------------------
### `-q`
Quite
Inverse of [`-v`](#-v)
See also: [`:verb`](/doc/arvo/util#verb))
------------------------------------------------------------------------
### `-r`
Raft flotilla
Also needs the [`-l`](#-l) option set.
------------------------------------------------------------------------
### `-F`
Fake
Routes all networking over `0.0.0.0` and doesn't check any keys. This
allows you to start any carrier.
bin/vere -F -I ~zod -c zod
You get an isolated network with just yourself but you can [`:ticket`]()
other ships or start other ships or start other carriers.
------------------------------------------------------------------------
### `-I`
Imperial
Takes a carrier name, such as `~zod`.
bin/vere -F -I ~zod -c zod
------------------------------------------------------------------------
### `-v`
Verbose
Inverse of [`-q`](#-q)
See also: [`:verb`](reference/arvo/util.md#verb).
bin/vere -v mypier
------------------------------------------------------------------------
### `-X`
Skip last event
bin/vere -Xwtf mypier
------------------------------------------------------------------------
Tips
====
Inability to mmap 2Gb with `MAP_FIXED`
--------------------------------------
It's probably because of
[ASLR](http://en.wikipedia.org/wiki/Address_space_layout_randomization)
(some shared library got its data mapped in the middle of your address
space). If so, applying
bash setarch `uname -m` -R ./bin/vere
should help.
</div>