To understand this document

This document assumes you are familar with the standard UNIX™ shell, sh(1), have coded several scripts, and have some understanding of TPC/IP network serices.

It also assumes that you can read the manual page for any other example command.

What is muxcat?

muxcat downloads a stream of bytes from a specifed service on network peer. The service is assumed to follow the IETF RFC 1078 protocol specification.

Typically muxcat is a data-source for a shell pipeline. The inverse flow is supported by muxsend (see that HTML document).

Basic examples

As an example we might request the name of a local NTP servers from a configuration management server with:
$ muxcat $CM ntp-list
dallas.npcguild.org
bishop.npcguild.org
crowe.npcguild.org
The variable CM holds the name of the local configuration management server, the service name ntp-list is an arbitrary name assigned to the local service that returns the list of stratum 2 servers.

Local site policy specifies most of the configuration for these services: few of the standard "well known services" (e.g. smtp, nnpt, or shell) are ever presented as mux services. Locally assigned names have a specific service for each installation; due to the lack of credentials required, few tcpmux services are "standard".

This does not imply the few are useful! I use many tcpmux services on every host under my administration. For example

$ muxcat localhost help 
dump-usr_msrc
dump-var
dump-usr
dump-slash
msrcmux
nodelist
inrr
The dump-filesystem services provide an archive of each filesystem listed to any client that is listed in a local DNS record. The msrcmux service is described in this HTML document. The nodelist and inrr services are local configuration management data sources.

See the tcpmux HTML document for a longer list of npcguild's services.

More to the point: these services form the back-bone of my control loops. The feedback from anonymous data services provide most of the data sources for my automated monitoring.

What not to put up via the mux

Anything that you wouldn't publish on the local bulletin-board. Never send passwords, or the like unless the connection is from a locally known peer on a secure network. I send my dumps over the mux, but I use a private network to do that.

See also

muxsend and that HTML document.
$Id: muxcat.html,v 1.1 2012/08/20 20:42:15 ksb Exp $