Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
RCMDSH(3)		 BSD Library Functions Manual		     RCMDSH(3)

NAME
     rcmdsh -- return a	stream to a remote command without superuser

SYNOPSIS
     #include <unistd.h>

     int
     rcmdsh(char **ahost, int inport, const char *locuser,
	 const char *remuser, const char *cmd, const char *rshprog);

DESCRIPTION
     The rcmdsh() function is used by normal users to execute a	command	on a
     remote machine using an authentication scheme based on reserved port num-
     bers using	rshd(8)	or the value of	rshprog	(if non-NULL).

     The rcmdsh() function looks up the	host *ahost using gethostbyname(3),
     returning -1 if the host does not exist.  Otherwise *ahost	is set to the
     standard name of the host and a connection	is established to a server re-
     siding at the well-known Internet port "shell/tcp"	(or whatever port is
     used by rshprog).	The inport argument is ignored;	it is only included to
     provide an	interface similar to rcmd(3).

     If	the connection succeeds, a socket in the UNIX domain of	type
     SOCK_STREAM is returned to	the caller, and	given to the remote command as
     stdin, stdout, and	stderr.

RETURN VALUES
     The rcmdsh() function returns a valid socket descriptor on	success.  Oth-
     erwise, -1	is returned and	a diagnostic message is	printed	on the stan-
     dard error.

SEE ALSO
     rsh(1), socketpair(2), rcmd(3), rshd(8)

HISTORY
     The rcmdsh() function first appeared in OpenBSD 2.0, and made its way
     into FreeBSD 4.6.

BUGS
     If	rsh(1) encounters an error, a file descriptor is still returned	in-
     stead of -1.

BSD			       September 1, 1996			   BSD

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUES | SEE ALSO | HISTORY | BUGS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=rcmdsh&sektion=3&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help