1FEATHERS(1)               BSD General Commands Manual              FEATHERS(1)
2

NAME

4     feathers — a simple source-level debugger for CHICKEN Scheme
5

SYNOPSIS

7     feathers [OPTION ...] [PROGRAM ARGUMENTS ...]
8

DESCRIPTION

10     feathers runs a program compiled with CHICKEN Scheme and allows basic
11     source-level debugging like setting breakpoints, single-stepping and in‐
12     spection of procedure arguments and global variables.
13
14     The Scheme code must be compiled with debug-level 3 for debugging to be
15     possible. Communication with the debugger takes place by exchanging mes‐
16     sages over a TCP socket, the address and port being given by the environ‐
17     ment variable CHICKEN_DEBUGGER which holds a connection address of the
18     form ⟨ADDRESS⟩:⟨PORT⟩.
19
20     PROGRAM must give the path to the executable that is to be run, PATH is
21     not searched.
22
23     The program accepts following arguments:
24
25     -help   Shows a list of supported command-line options.
26
27     -n      Do not load the default startup file .feathers.
28
29     -d      TODO: Document this
30
31     -dir DIRECTORY
32             Add DIRECTORY to the list of searched paths for locating source
33             files.
34
35     -port PORT
36             Select a different TCP port than the default (9999).
37

ENVIRONMENT

39     The following environment variables change the behaviour of feathers:
40
41     CHICKEN_DEBUGGER  Should hold a TCP server address and port where the de‐
42                       bugger is listening.  This variable is set by the de‐
43                       bugger when a program is run from it, and defaults to
44                       localhost:9999
45

EXIT STATUS

47     The feathers utility exits 0 on success, and >0 if an error occurs.
48

SEE ALSO

50     chicken(1), csc(1), csi(1)
51
52     More information can be found in the CHICKEN User's Manual:
53     http://wiki.call-cc.org/manual/index
54

AUTHORS

56     The CHICKEN Team
57

BUGS

59     Submit bug reports by e-mail to chicken-janitors@nongnu.org
60
61BSD                              Apr 26, 2017                              BSD