Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

tcmodchain(1) [debian man page]

tcmodchain(1)						      General Commands Manual						     tcmodchain(1)

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 succes-
	      fully; 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)

tcmodchain(1)							  5 January 2006						     tcmodchain(1)

Check Out this Related Man Page

QUERY_MODULE(2) 					       Linux Module Support						   QUERY_MODULE(2)

NAME

       query_module - query the kernel for various bits pertaining to modules.

SYNOPSIS

       #include <linux/module.h>

       int query_module(const char *name, int which,
       void *buf, size_t bufsize, size_t *ret);

DESCRIPTION

       query_module  requests  information  related  to  loadable  modules  from the kernel.  The precise nature of the information and its format
       depends on the which sub function.  Some functions require name to name a currently loaded module, some allow name to  be  NULL	indicating
       the kernel proper.

   VALUES OF WHICH
       0      Always returns success.  Used to probe for the system call.

       QM_MODULES
	      Returns  the names of all loaded modules.  The output buffer format is adjacent null-terminated strings; ret is set to the number of
	      modules.

       QM_DEPS
	      Returns the names of all modules used by the indicated module.  The output buffer format is adjacent null-terminated strings; ret is
	      set to the number of modules.

       QM_REFS
	      Returns  the names of all modules using the indicated module.  This is the inverse of QM_DEPS.  The output buffer format is adjacent
	      null-terminated strings; ret is set to the number of modules.

       QM_SYMBOLS
	      Returns the symbols and values exported by the kernel or the indicated module.  The buffer format is an array of:

	      struct module_symbol
	      {
		unsigned long value;
		unsigned long name;
	      };

	      followed by null-terminated strings.  The value of name is the character offset of the string relative to the start of buf;  ret	is
	      set to the number of symbols.

       QM_INFO
	      Returns miscellaneous information about the indicated module.  The output buffer format is:

	      struct module_info
	      {
		unsigned long address;
		unsigned long size;
		unsigned long flags;
	      };

	      where  address  is  the  kernel address at which the module resides, size is the size of the module in bytes, and flags is a mask of
	      MOD_RUNNING, MOD_AUTOCLEAN, et al that indicates the current status of the module.  ret is  set  to  the	size  of  the  module_info
	      struct.

RETURN VALUE

       On success, zero is returned.  On error, -1 is returned and errno is set appropriately.

ERRORS

       ENOENT No module by that name exists.

       EINVAL Invalid which, or name indicates the kernel for an inappropriate sub function.

       ENOSPC The buffer size provided was too small.  ret is set to the minimum size needed.

       EFAULT At least one of name, buf, or ret was outside the program's accessible address space.

SEE ALSO

       create_module(2), init_module(2), delete_module(2).

Linux 2.1.17							    26 Dec 1996 						   QUERY_MODULE(2)
Man Page