man remctl (Commandes) - Remote execution tool

NAME

remctl - Remote execution tool

SYNOPSIS

remctl [-dhv] [-p port] [-s service] host type service [parameters ...]

DESCRIPTION

remctl is a program that allows a user to execute commands remotely on a server that is running the remctld deamon. remctl does not interpret the commands given to it, it passes them to the server and displays the return message. The commands must be defined on the server-side before a remctl client can execute them, and the user running remctl must be authorized to execute the particular command on the server.

Access to remote commands is authenticated via Kerberos v5 over GSSAPI, so a user must have a ticket granting ticket to use remctl. All transmissions to and from the remctld server are encrypted using GSSAPI's security layer.

host is the hostname of the target server. type and service together specify the command to run and correspond to the command names in the configuration file on the server. parameters are any additional command-line parameters to pass to the remote command.

OPTIONS

-d
Turn on extra debugging output of the client-server interaction.
-h
Show a brief usage message and then exit.
-p port
Connect to the server on port rather than the default of 4444.
-s service
Authenticate to the server with a service ticket for service rather than the default server identity of host/hostname. This may be necessary with, for instance, a server where remctld is not running as root.
-v
Print the version of remctl and exit.

EXAMPLES

Release an afs volume called ls.tripwire:

    remctl lsdb afs release ls.tripwire

SEE ALSO

kinit(1), remctld(1)

The current version of this program is available from its web page at <http://www.eyrie.org/~eagle/software/remctl/>.

AUTHOR

Anton Ushakov <antonu@stanford.edu> is the original author. Updates and current maintenance are done by Russ Allbery <rra@stanford.edu>.

COPYRIGHT AND LICENSE

Copyright 2002, 2003, 2004, 2005, 2006 Board of Trustees, Leland Stanford Jr. University. All rights reserved.

Permission to use, copy, modify, and distribute this software and its documentation for any purpose and without fee is hereby granted, provided that the above copyright notice appear in all copies and that both that copyright notice and this permission notice appear in supporting documentation, and that the name of Stanford University not be used in advertising or publicity pertaining to distribution of the software without specific, written prior permission. Stanford University makes no representations about the suitability of this software for any purpose. It is provided as is without express or implied warranty.

THIS SOFTWARE IS PROVIDED AS IS AND WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.