1SMC_RUN(8)                Linux Programmer's Manual                 SMC_RUN(8)
2
3
4

NAME

6       smc_run  - start a TCP socket program with the capability to use SMC as
7       networking protocol
8
9

SYNOPSIS

11       smc_run [-dhrtv][-r SIZE] [-t SIZE] program parameters
12
13

DESCRIPTION

15       smc_run starts a program specified as argument with its parameters, al‐
16       lowing to use the SMC protocol for program-used TCP socket connections.
17       The  script specifies libsmc-preload.so as a preload shared library for
18       the Linux program loader, and may adjust transmit  and  receive  buffer
19       sizes to SIZE by setting socket options SO_RCVBUF and SO_SNDBUF respec‐
20       tively.  SIZE can be specified in Bytes or using metric prefixes k  and
21       m, e.g.  8k...1024k/1m.
22       The preload library libsmc-preload.so intercepts a few TCP socket calls
23       and triggers the equivalent execution through SMC.
24       Note: If it is not possibile to use smc_run, the libsmc-preload.so  may
25       be  installed  as apreload library via environment variable LD_PRELOAD.
26       Use environment varibles SMC_SNDBUF and SMC_RCVBUF to request  specific
27       transmit  and  receive  buffer sizes respectively. Supports metric pre‐
28       fixes k and m.
29
30       The following options can be specified:
31
32       -d     Display additional diagnostic messages during the program execu‐
33              tion.
34
35       -h     Display a brief usage information.
36
37       -r SIZE
38              Request receive buffer size SIZE.
39              Notes:
40
41              • May be overridden by the application.
42
43              • Increases net.core.rmem_max if necessary.
44
45       -t SIZE
46              Request transmit buffer size SIZE.
47              Notes:
48
49              • May be overridden by the application.
50
51              • Increases net.core.wmem_max if necessary.
52
53       -v     Display version information.
54

RETURN CODES

56       On  success, the smc_run command returns 0.  If an error occurs smc_run
57       writes a message to stdout and completes with a return code other  than
58       0.
59
60
61       1      An invalid option was specified.
62

EXAMPLES

64       Run program foo using SMC, requesting a receive buffer size of 512KB
65
66           $ smc_run -r 512k ./foo
67

SEE ALSO

69       af_smc(7),  smc_chk(8) smc_pnet(8), smc_rnics(8), smcd(8), smcr(8), sm‐
70       css(8), tcp(7)
71
72
73
74smc-tools                        January 2017                       SMC_RUN(8)
Impressum