NAME
tcmodchain - Query compatibily of transcode modules chains.
SYNOPSIS
tcmodchain [ -m path ] [ -C ] [ -L ] [ -d verbosity ] [ -v ] module1
module2
COPYRIGHT
tcmodchain is Copyright (C) by Transcode Team
DESCRIPTION
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.
OPTIONS
-m path
Look in Path instead of the compiled-in module path while trying
to load a module.
-C Enable check mode.
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.
see RETURN VALUES below.
-L Enable list mode.
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.
see RETURN VALUES below.
-d verbosity
Specify the verbosiness level to use, like transcode does.
Default value is 1 (TC_INFO verbosiness).
-v Print version information and exit.
MODULE IDENTIFIERS
tcmodchain identifies modules using a type:name naming scheme.
Currently, as in transcode 1.1.0, only encode and multiplex module
types are supported. name can refer to the name of any avalaible
transcode modules, using the same rules of tcmodinfo(1) -i option. The
wildcard character * is supported in the name section of module
identifier. Wildcard meaning is `any of avalaible modules' and is
honoured only when list mode (-L option) is used. Using wildcard
character for both module identifiers will lead to an error.
EXAMPLES
$ tcmodchain -C encode:null multiplex:null -d 1
[encode_null.so] v0.0.3 (2005-06-05) null (fake) A/V encoder
[multiplex_null.so] v0.0.2 (2005-12-29) discard each encoded frame
[tcmodchain] encode:null | multiplex:null [OK]
[tcmodchain] module chain OK
$ tcmodchain -L 'encode:*' multiplex:null
copy
faac
lame
lzo
null
x264
xvid
PLEASE NOTE that output of this example may vary depending of your
installation.
At least null and copy modules will be showed on your output.
$ tcmodchain -L encode:null 'multiplex:*'
avi
null
raw
y4m
RETURN VALUES
tcmodchain uses following return values:
0 successfull
1 bad parameter or command line option
2 error while (un)loading a module
3 given module pair isn't compatible
4 error while looking for module(s)
AUTHORS
tcmodchain was written by Francesco Romani
<fromani@gmail.com> with contributions from many others. See AUTHORS
for details.
SEE ALSO
transcode(1) tcmodinfo(1)