Gnome Library Reference Manual
<<< Previous Page | Home | Up | Next Page >>>

# gnome-remote

## Name

gnome-remote -- User preference routines for executing commands on a remote host

## Synopsis

    #include <gnome.h>

    void        gnome_remote_get_command        (const char *host,
                                                 gint *argcp,
                                                 char ***argvp);
    void        gnome_remote_set_command        (const char *host,
                                                 gint argc,
                                                 const char *const argv[]);

## Description

These routines are used to select and manage the user preferences for remote command execution.

## Details

### gnome_remote_get_command ()

    void        gnome_remote_get_command        (const char *host,
                                                 gint *argcp,
                                                 char ***argvp);

Given a host, this function will return the user's desired `rsh'-like command to use to contact that host. This lets the user choose how to log in on a host-by-host basis. If `host` is `NULL`, then the user's default remote shell command is chosen.

`host` : | Host where command should be run
`argcp` : | Result parameter; number of elements in rsh command
`argvp` : | Result parameter; the actual rsh command to use

### gnome_remote_set_command ()

    void        gnome_remote_set_command        (const char *host,
                                                 gint argc,
                                                 const char *const argv[]);

This sets the appropriate options in the config database so that subsequent calls to gnome_remote_get_command() will return `argv`. If `host` is `NULL`, then the user's default remote shell is set. If `argc` is `0`, then this instance of the command is deleted.

`host` : | Name of host
`argc` : | Number of elements in argument vector
`argv` : | Command line to use to contact host

<<< Previous Page | Home | Up | Next Page >>>
gnome-regex | gnome-score