akovalenko/lnd.xprv
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity
19fafd7a9a
lnd.xprv/docs/MAKEFILE.md
Philipp Gillé 449707d90a
docs/MAKEFILE: Remove mention of dep and Glide 
Commit ca28c0b removed the dep section,
so it shouldn't be mentioned as a target in other targets.
Also, Glide doesn't seem to be used anymore as well.
2019-03-24 13:28:51 +01:00

4.1 KiB
Raw Blame History

Makefile

To build, verify, and install lnd from source, use the following commands:

make
make check
make install

Developers

This document specifies all commands available from lnd's Makefile. The commands included handle:

  • Installation of all go-related dependencies.
  • Compilation and installation of lnd and lncli.
  • Compilation and installation of btcd and btcctl.
  • Running unit and integration suites.
  • Testing, debugging, and flake hunting.
  • Formatting and linting.

Commands

all

Compiles, tests, and installs lnd and lncli. Equivalent to scratch check install.

btcd

Ensures that the github.com/btcsuite/btcd repository is checked out locally. Lastly, installs the version of github.com/btcsuite/btcd specified in Gopkg.toml

build

Compiles the current source and vendor trees, creating ./lnd and ./lncli.

check

Installs the version of github.com/btcsuite/btcd specified in Gopkg.toml, then runs the unit tests followed by the integration tests.

Related: unit itest

clean

Removes compiled versions of both ./lnd and ./lncli, and removes the vendor tree.

default

Alias for scratch.

flake-unit

Runs the unit test endlessly until a failure is detected.

Arguments:

  • pkg=<package>
  • case=<testcase>
  • timeout=<timeout>

Related: unit

flakehunter

Runs the itegration test suite endlessly until a failure is detected.

Arguments:

  • icase=<itestcase>
  • timeout=<timeout>

Related: itest

fmt

Runs go fmt on the entire project.

install

Copies the compiled lnd and lncli binaries into $GOPATH/bin.

itest

Installs the version of github.com/btcsuite/btcd specified in Gopkg.toml, builds the ./lnd and ./lncli binaries, then runs the integration test suite.

Arguments:

  • icase=<itestcase>
  • timeout=<timeout>

lint

Ensures that gopkg.in/alecthomas/gometalinter.v1 is installed, then lints the project.

list

Lists all known make targets.

rpc

Compiles the lnrpc proto files.

scratch

Compiles all dependencies and builds the ./lnd and ./lncli binaries. Equivalent to lint btcd unit-race.

unit

Runs the unit test suite. By default, this will run all known unit tests.

Arguments:

  • pkg=<package>
  • case=<testcase>
  • timeout=<timeout>
  • log="stdlog[ <log-level>]" prints logs to stdout
    • <log-level> can be info (default), debug, trace, warn, error, critical, or off

unit-cover

Runs the unit test suite with test coverage, compiling the statisitics in profile.cov.

Arguments:

  • pkg=<package>
  • case=<testcase>
  • timeout=<timeout>
  • log="stdlog[ <log-level>]" prints logs to stdout
    • <log-level> can be info (default), debug, trace, warn, error, critical, or off

Related: unit

unit-race

Runs the unit test suite with go's race detector.

Arguments:

  • pkg=<package>
  • case=<testcase>
  • timeout=<timeout>
  • log="stdlog[ <log-level>]" prints logs to stdout
    • <log-level> can be info (default), debug, trace, warn, error, critical, or off

Related: unit