@@@ man wip
[mLib] / test / tvec-remote.3
CommitLineData
d056fbdf
MW
1.\" -*-nroff-*-
2.de VS
3.sp 1
4.RS
5.nf
6.ft B
7..
8.de VE
9.ft R
10.fi
11.RE
12.sp 1
13..
14.de hP
15.IP
16.ft B
17\h'-\w'\\$1\ 'u'\\$1\ \c
18.ft P
19..
20.ie t \{\
21. ds o \(bu
22. de VP
23. sp .4v
24..
25\}
26.el \{\
27. ds o o
28. de VP
29. sp
30..
31\}
32..
33.TH tvec-remote 3 "11 March 2024" "Straylight/Edgeware" "mLib utilities library"
34.SH NAME
35tvec-remote \- test vector framework remote invocation
36.\" @TVEC_REMOTEENV
37.\" @TVEC_FORK
38.\" @TVEC_EXEC
39.\" @tvec_fork
40.\" @tvec_exec
41.
42.\" @tvec_setprogress
43.\" @tvec_setprogress_v
44.
45.\" @tvec_remoteserver
46.
47.SH SYNOPSIS
48.nf
49.B "#include <mLib/tvec.h>"
50.PP
51.ta \w'\fBtypedef int tvec_connectfn('u
52.BI "typedef int tvec_connectfn(pid_t *" kid_out ", int *" infd_out ,
53.BI " int *" outfd_out ", int *" errfd_out ,
54.BI " struct tvec_state *" tv ,
55.BI " const struct tvec_remoteenv *" env );
56.PP
57.ta 2n
58.B "struct tvec_remoteenv_slots {"
59.B " tvec_connectfn *connect;"
60.B " const struct tvec_env *env;"
61.B " unsigned dflt_reconn;"
62.B "};"
63.B "struct tvec_remoteenv {"
64.B " struct tvec_env _env;"
65.B " struct tvec_remoteenv_slots r;"
66.B "};"
67.B "#define TVEC_REMOTEENV ..."
68.PP
69.B "#define TVXF_VALMASK ..."
70.B "#define TVXF_SIG ..."
71.B "#define TVXF_CAUSEMASK ..."
72.B "#define TVXST_RUN ..."
73.B "#define TVXST_EXIT ..."
74.B "#define TVXST_KILL ..."
75.B "#define TVXST_CONT ..."
76.B "#define TVXST_STOP ..."
77.B "#define TVXST_DISCONN ..."
78.B "#define TVXST_UNK ..."
79.B "#define TVXST_ERR ..."
80.PP
81.B "struct tvec_remotefork_slots {"
82.B " const struct tvec_test *tests;"
83.B "};"
84.B "struct tvec_remotefork {"
85.B " struct tvec_env _env;"
86.B " struct tvec_remoteenv_slots r;"
87.B " struct tvec_remotefork_slots f;"
88.B "};"
89.B "tvec_connectfn tvec_fork;"
90.BI "#define TVEC_REMOTEFORK(" subenv ", " tests ") ..."
91.PP
92.B "struct tvec_remoteexec_slots {"
93.B " const char *const *args;"
94.B "};"
95.B "struct tvec_remoteexec {"
96.B " struct tvec_env _env;"
97.B " struct tvec_remoteenv_slots r;"
98.B " struct tvec_remoteexec_slots x;"
99.B "};"
100.B "tvec_connectfn tvec_exec;"
101.BI "#define TVEC_REMOTEEXEC(" subenv ", " args ") ..."
102.PP
103.BI "void tvec_setprogress(const char *" status ", ...);"
104.BI "void tvec_setprogress_v(const char *" status ", va_list *" ap );
105.PP
106.ta \w'\fBint tvec_remoteserver('u
107.BI "int tvec_remoteserver(int " infd ", int " outfd ,
108.BI " const struct tvec_config *" config );
109.fi