channels.conf

NAME
DESCRIPTION
EXAMPLE
AUTHORS
SEE ALSO

NAME

channels.conf − Gigapxy channel−group configuration file.

DESCRIPTION

gws(1) uses channel−group configuration to define channel sources that could be referenced not by absolute address but via an alias. An alias is a name prepended by a dollar−sign character. gws, as it processes a URL, recognizes an alias and translates it to an absolute−address URL to be used as a source.

An alias creates a name−to−URL mapping for user requests.

An example channel−group configuration is provided with the installation at /usr/share/doc/gigapxy under Linux or /usr/local/share/doc/gigapxy under BSD. channels is the top−level section, under which channel groups are listed/defined. The parameters used in configuring a single channel group are as below:

alias
This is the name to be used in URLs with the dollar−sign prefix. The name/alias will be translated into one of the URLs from the set defined for the given group.

urls
The URL to resolve the alias to. A URL may contain an alias but only to be resolved remotely (by the gigapxy daisy−chained to the current one). In the future, more than one URL (with a load−balancing option) may be supported for this setting.

EXAMPLE

This is what contents of a channels.conf file may look like:

channels = (
{ alias = "TV5"; urls = ["file:///opt/prog/tv5/channel-down.ts"]; },
{ alias = "NightLife"; urls = ["udp://10.0.24.16:5054"]; } );

Aliases are used with a dollar-sign prefix. A request to TV5 channel thus may look as:
a) http://acme.com:8080/$TV9

Or, in src/dst format, with a custom key parameter:
b) http://acme.com:8080/src/$TV9?key=BF094744c5/dst

AUTHORS

Pavel V. Cherenkov

SEE ALSO

gigapxy(1),gws(1),gws.conf(5)