HOSE

Section: User Commands (1)
Updated: Mar 30 1992
Index Return to Main Contents
 

NAME

hose - the client end of a BSD network pipe  

SYNOPSIS

hose hostname port command (in|out|err) [unix] [localport port]

 

DESCRIPTION

hose attempts to provide the functionality of pipes over the network. It behaves as the client end of a server-client connection. When used with faucet(1) it can function as a replacement for

tar -cf - . | rsh other "cd destdir; tar -xf -"

faucet and hose are especially useful when you don't have easy access to the destination machine.

hose creates a BSD socket and, if the localport option is used, binds it to the port number (or service name) specified immediately afterwards. hose then tries to connect to the foreign machine hostname with foreign port port
 .  If successful hose redirects stdin, stdout, and/or stderr according to the in out err flags. hose then exec(2)s a csh -f "command". The unix flag specifies that the port is not an internet port number or service name, but instead it is a filename for a UNIX domain socket. This option may be simulated by using -unix- as the host name to connect to, or by renaming the hose program to uhose.

 

EXAMPLES

This will connect to port 3000 on the machine reef and connect the socket to the stdin of a tar command.

example% hose reef 3000 "tar -xf - ." in

The command actually exec(2)ed by the hose program is

/bin/csh -c "tar -xf - ."

The in option means that the input of the child process will have been redirected into the socket connected to reef.

This connects to a UNIX domain socket in the current directory

example% hose u-socket "dd of=sample.pgm" in

 

SEE ALSO

faucet(1), socket(2), bind(2), listen(2), accept(2), services(5), gethostbyaddr(3)

 

NOTES

Doubtless there are bugs in this program, especially in the unix domain socket portions. I welcome problem reports and would like to make these programs as "clean" (no leftover files, sockets) as possible.

 

COPYRIGHT

Copyright (C) 1992 Robert Forsman

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

 

AUTHOR


 Robert Forsman
 thoth@lightning.cis.ufl.edu
 University of Florida
 Department of Computer and Information Science


 

Index

NAME
SYNOPSIS
DESCRIPTION
EXAMPLES
SEE ALSO
NOTES
COPYRIGHT
AUTHOR

This document was created by man2html, using the manual pages.
Time: 21:51:16 GMT, February 02, 2023