cvs/os2/rcmd.h

13571821Stholo/* rcmd.h --- interface to executing commands on remote hosts
13571821Stholo   Karl Fogel <kfogel@cyclic.com> --- November 1995  */
13571821Stholo
*2770ece5Stholo/* This program is free software; you can redistribute it and/or modify
*2770ece5Stholo   it under the terms of the GNU General Public License as published by
*2770ece5Stholo   the Free Software Foundation; either version 2, or (at your option)
*2770ece5Stholo   any later version.
*2770ece5Stholo
*2770ece5Stholo   This program is distributed in the hope that it will be useful,
*2770ece5Stholo   but WITHOUT ANY WARRANTY; without even the implied warranty of
*2770ece5Stholo   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
*2770ece5Stholo   GNU General Public License for more details.  */
*2770ece5Stholo
13571821Stholo/* Run the command CMD on the host *AHOST, and return a file descriptor for
13571821Stholo   a bidirectional stream socket connected to the command's standard input
13571821Stholo   and output.
13571821Stholo
13571821Stholo   rcmd looks up *AHOST using gethostbyname, and sets *AHOST to the host's
13571821Stholo   canonical name.  If *AHOST is not found, rcmd returns -1.
13571821Stholo
13571821Stholo   rcmd connects to the remote host at TCP port INPORT.  This should
13571821Stholo   probably be the "shell" service, port 514.
13571821Stholo
13571821Stholo   LOCUSER is the name of the user on the local machine, and REMUSER is
13571821Stholo   the name of the user on the remote machine; the remote machine uses this,
13571821Stholo   along with the source address of the TCP connection, to authenticate
13571821Stholo   the connection.
13571821Stholo
13571821Stholo   CMD is the command to execute.  The remote host will tokenize it any way
13571821Stholo   it damn well pleases.  Welcome to Unix.
13571821Stholo
13571821Stholo   FD2P is a feature we don't support, but there's no point in making mindless
13571821Stholo   deviations from the interface.  Callers should always pass this argument
13571821Stholo   as zero.  */
13571821Stholoextern int rcmd (const char **AHOST,
13571821Stholo		 unsigned short INPORT,
13571821Stholo		 char *LOCUSER,
13571821Stholo		 char *REMUSER,
13571821Stholo		 char *CMD,
13571821Stholo		 int *fd2p);