1SMC_RUN(8) Linux Programmer's Manual SMC_RUN(8)
2
3
4
6 smc_run - start a TCP socket program with the capability to use SMC as
7 networking protocol
8
9
11 smc_run [-dhrtv][-r SIZE] [-t SIZE] program parameters
12
13
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
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
64 Run program foo using SMC, requesting a receive buffer size of 512KB
65
66 $ smc_run -r 512k ./foo
67
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)