1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
|
.TH tcmodchain 1 "5 January 2006" "tcmodchain(1)"
.SH NAME
tcmodchain \- Query compatibily of transcode modules chains.
.SH SYNOPSIS
.na
.B tcmodchain
[
.B -m
.I path
] [
.B -C
] [
.B -L
] [
.B -d
.I verbosity
] [
.B -v
] module1 module2
.SH COPYRIGHT
\fBtcmodchain\fP is Copyright (C) by Transcode Team
.SH DESCRIPTION
.B tcmodchain
allow to inspect transcode(1) modules, as well as it's companion,
tcmodinfo(1). While tcmodinfo(1) focus on single modules, tcmodchain
is intended to help in exploring/experimenting module interactions.
.SH OPTIONS
.TP
\fB-m\fP \fIpath\fP
Look in \fIPath\fP instead of the compiled-in module path while
trying to load a module.
.TP
.B -C
Enable \fIcheck\fP mode.
.br
In check mode tcmodchain expects exactly two
module identifiers. tcmodchain will check compatibilty between two
given modules. Result will be logged out or not depending of
verbosity level. Anyway, if two modules are compatible, tcmodchain
will exit succesfully; otherwise, tcmodchain will exit with error.
.br
see RETURN VALUES below.
.TP
.B -L
Enable \fIlist\fP mode.
.br
In list mode tcmodchain expects exactly two
module identifiers, exactly one of which containing a wildcard.
tcmodchain will inspect all avalaible installed modules matching
the wildcard and will print out module names that are compatible
with the other given one. if at least one compatible module is found,
tcmodchain will exit succesfully; otherwise, tcmodchain will exit
with error.
.br
see RETURN VALUES below.
.TP
\fB-d\fP \fIverbosity\fP
Specify the verbosiness level to use, like transcode does. Default value
is 1 (TC_INFO verbosiness).
.TP
.B -v
Print version information and exit.
.SH MODULE IDENTIFIERS
.B tcmodchain
identifies modules using a
\fItype:name\fP
naming scheme. Currently, as in transcode 1.1.0, only \fIencode\fP and \fImultiplex\fP
module \fItype\fPs are supported. \fIname\fP can refer to the name of any avalaible
transcode modules, using the same rules of tcmodinfo(1) \fI-i\fP option.
The wildcard character \fI*\fP is supported in the \fIname\fP section of module
identifier. Wildcard meaning is `any of avalaible modules' and is honoured only
when \fIlist\fP mode (-L option) is used. Using wildcard character for \fIboth\fP
module identifiers will lead to an error.
.SH EXAMPLES
.PP
.B $ tcmodchain -C encode:null multiplex:null -d 1
.PP
[encode_null.so] v0.0.3 (2005-06-05) null (fake) A/V encoder
.br
[multiplex_null.so] v0.0.2 (2005-12-29) discard each encoded frame
.br
[tcmodchain] encode:null | multiplex:null [OK]
.br
[tcmodchain] module chain OK
.PP
.B $ tcmodchain -L 'encode:*' multiplex:null
.PP
copy
.br
faac
.br
lame
.br
lzo
.br
null
.br
x264
.br
xvid
\fBPLEASE NOTE\fP that output of this example may vary depending of your installation.
.br
At least \fInull\fP and \fIcopy\fP modules will be showed on your output.
.PP
.B $ tcmodchain -L encode:null 'multiplex:*'
.PP
avi
.br
null
.br
raw
.br
y4m
.SH RETURN VALUES
.B tcmodchain
uses following return values:
.br
0 successfull
.br
1 bad parameter or command line option
.br
2 error while (un)loading a module
.br
3 given module pair isn't compatible
.br
4 error while looking for module(s)
.br
.SH AUTHORS
.B tcmodchain
was written by Francesco Romani
.br
<fromani@gmail.com> with contributions from
many others. See AUTHORS for details.
.SH SEE ALSO
.BR transcode (1)
.BR tcmodinfo (1)
|
