Using libhostile

libhostile adds a very thin layer over every call that it breaks. By default it will not break any calls, it needs to be told what calls you wish to be hostile to. There are two ways of doing this:

1. Using the hostile.sh tool
2. Manually as below

Manual hostility

You can manually invoke libhostile using LD_PRELOAD as follows:

$ LD_PRELOAD=/usr/local/lib/libhostile.so application

Where application is the application/service you wish to be hostile to.

To become hostile to libc functions you will need to set environment variables. Multiple environment variables can be used in the same run.

Each environment variable should be set to an integer representation of the frequency of failures. For example:

$ export HOSTILE_MALLOC=500

The above will tell libhostile to return an error for roughly 1/500 malloc() calls (there is a random element and a small grace period).

HOSTILE_ACCEPT

Become hostile to accept() calls

HOSTILE_ACCEPT4

Become hostile to accept4() calls

HOSTILE_CLOSE

Become hostile to close() calls

HOSTILE_CONNECT

Become hostile to connect() calls

HOSTILE_GETADDRINFO

Become hostile to getaddrinfo() calls

HOSTILE_MALLOC

Become hostile to malloc() calls

HOSTILE_PIPE

Become hostile to pipe() calls

HOSTILE_PIPE2

Become hostile to pipe2() calls

HOSTILE_POLL

Become hostile to poll() calls

HOSTILE_REALLOC

Become hostile to realloc() calls

HOSTILE_RECV

Become hostile to recv() calls

HOSTILE_SEND

Become hostile to send() calls

HOSTILE_SETSOCKOPT

Become hostile to setsockopt() calls

HOSTILE_SOCKET

Become hostile to socket() calls

HOSTILE_WRITE

Become hostile to write() calls