IPB
>  Man Pages > Unix > Solaris 10 11/06 > Section 1 > rsh man page

rsh man page

Section 1 - Solaris 10 11/06 Man Pages

Other operating system man pages available here


Advanced Search

Hopefully, this page is exactly what you are looking for, but if not, you can always find further assistance on Unix/Linux Forum!





User Commands                                              rsh(1)



NAME
     rsh, remsh, remote_shell - remote shell

SYNOPSIS
     rsh [-n] [-a] [-PN | -PO]  [-x] [-f | -F]  [-l username] [-k
     realm] hostname command

     rsh hostname [-n] [-a] [-PN |  -PO]   [-x]  [-f  |  -F]   [-
     l username] [-k realm] command

     remsh [-n] [-a] [-PN | -PO]  [-x] [-f |  -F]   [-l username]
     [-k realm] hostname command

     remsh hostname [-n] [-a] [-PN | -PO]  [-x]  [-f  |  -F]   [-
     l username] [-k realm] command

      hostname [-n]  [-a]  [-PN  |  -PO]   [-x]  [-f  |  -F]   [-
     l username] [-k realm] command

DESCRIPTION
     The rsh utility connects to the specified hostname and  exe-
     cutes  the  specified command. rsh copies its standard input
     to the remote command, the standard  output  of  the  remote
     command  to  its  standard output, and the standard error of
     the remote command to its standard error.  Interrupt,  quit,
     and  terminate signals are propagated to the remote command.
     rsh normally terminates when the remote command does.

     The user can opt for a secure session of rsh which uses Ker-
     beros  V5 for authentication. Encryption of the network ses-
     sion traffic is also possible. The rsh session can  be  ker-
     berized   using  any  of  the  following  Kerberos  specific
     options: -a, -PN or -PO, -x, -f or -F, and -k realm. Some of
     these  options  (-x,  -PN  or -PO, and -f or -F) can also be
     specified in the [appdefaults] section of krb5.conf(4).  The
     usage  of  these  options  and the expected behavior is dis-
     cussed in the OPTIONS section below.  If Kerberos  authenti-
     cation  is  used, authorization to the account is controlled
     by rules in krb5_auth_rules(5). If this authorization fails,
     fallback  to  normal rsh using rhosts occurs only if the -PO
     option is used explicitly on the command line or  is  speci-
     fied  in  krb5.conf(4).  Also, the -PN or -PO, -x, -f or -F,
     and -k realm options are just supersets of the -a option.

     If you omit command, instead of executing a single  command,
     rsh logs you in on the remote host using rlogin(1).

     rsh does not return the exit status code of command.

     Shell metacharacters which are not quoted are interpreted on
     the  local  machine,  while quoted metacharacters are inter-
     preted on the remote machine. See EXAMPLES.



SunOS 5.10          Last change: 26 May 2004                    1






User Commands                                              rsh(1)



     If there is no locale setting in the initialization file  of
     the  login  shell (.cshrc, . . .) for a particular user, rsh
     always executes the command in the  "C"  locale  instead  of
     using the default locale of the remote machine.

     The command is sent unencrypted to the  remote  system.  All
     subsequent network session traffic is encrypted. See -x.

OPTIONS
     The following options are supported:

     -a              Explicitly  enable  Kerberos  authentication
                     and  trusts  the  .k5login  file for access-
                     control.  If  the  authorization  check   by
                     in.rshd(1M)  on the server-side succeeds and
                     if the .k5login  file  permits  access,  the
                     user is allowed to carry out the command.



     -f              Forward a  copy  of  the  local  credentials
                     (Kerberos  Ticket  Granting  Ticket)  to the
                     remote system.  This  is  a  non-forwardable
                     ticket  granting  ticket.  Forward  a ticket
                     granting ticket if you need to  authenticate
                     yourself  to  other  Kerberized network ser-
                     vices on the remote host. An  example  would
                     be if your home directory on the remote host
                     is NFS mounted by way  of  Kerberos  V5.  If
                     your  local credentials are not forwarded in
                     this case, you  cannot  access   your   home
                     directory. This option is mutually exclusive
                     with the -F option.



     -F              Forward a  forwardable  copy  of  the  local
                     credentials    (Kerberos   Ticket   Granting
                     Ticket) to the remote system. The -F  option
                     provides  a  superset  of  the functionality
                     offered by the -f option. For example,  with
                     the  -f  option,  if, after you connected to
                     the  remote  host,   your   remote   command
                     attempted     to     invoke    /usr/bin/ftp,
                     /usr/bin/telnet,     /usr/bin/rlogin,     or
                     /usr/bin/rsh, with the -f or -F options,
                      the attempt would fail. Thus, you would  be
                     unable  to  push your single network sign on
                     trust beyond one   system.  This  option  is
                     mutually exclusive with the -f option.





SunOS 5.10          Last change: 26 May 2004                    2






User Commands                                              rsh(1)



     -k realm        Causes rsh to obtain tickets for the  remote
                     host  in  realm instead of the remote host's
                     realm as determined by krb5.conf(4).



     -l username     Uses username as the remote username instead
                     of  your  local  username. In the absence of
                     this option, the remote username is the same
                     as your local username.



     -n              Redirect the input of rsh to /dev/null.  You
                     sometimes  need  this option to avoid unfor-
                     tunate  interactions  between  rsh  and  the
                     shell which invokes it.  For example, if you
                     are running rsh and  invoke  a  rsh  in  the
                     background  without  redirecting  its  input
                     away from the terminal, it blocks even if no
                     reads are posted by the remote command.  The
                     -n option prevents this.



     -PO             Explicitly request new (-PN)  or  old  (-PO)
     -PN             version of the Kerberos "rcmd" protocol. The
                     new protocol avoids many  security  problems
                     prevalant  in  the  old  one and is regarded
                     much more secure, but is  not  interoperable
                     with  older (MIT/SEAM) servers. The new pro-
                     tocol is used by default, unless  explicitly
                     specified  using  these  options  or through
                     krb5.conf(4).  If   Kerberos   authorization
                     fails  when  using  the old "rcmd" protocol,
                     there is fallback to regular, non-kerberized
                     rsh. This is not the case when the new, more
                     secure "rcmd" protocol is used.




     -x              Cause the  network  session  traffic  to  be
                     encrypted. See DESCRIPTION.



     The type of remote shell (sh, rsh, or other)  is  determined
     by  the  user's  entry in the file /etc/passwd on the remote
     system.





SunOS 5.10          Last change: 26 May 2004                    3






User Commands                                              rsh(1)



OPERANDS
     The following operand is supported:

     command         The command to be executed on the  specified
                     hostname.



USAGE
     See largefile(5) for the description of the behavior of  rsh
     and remsh when encountering files greater than or equal to 2
     Gbyte ( 2**31 bytes).

     The rsh and remsh commands are  IPv6-enabled.  See  ip6(7P).
     IPv6 is not currently supported with Kerberos V5 authentica-
     tion.

     Hostnames are given in the hosts database, which can be con-
     tained  in  the  /etc/hosts  file,  the Internet domain name
     database, or both. Each host  has  one  official  name  (the
     first name in the database entry) and optionally one or more
     nicknames. Official hostnames or nicknames can be  given  as
     hostname.

     If the name of the file from which rsh is executed  is  any-
     thing  other  than  rsh, rsh takes this name as its hostname
     argument. This allows you to create a symbolic link  to  rsh
     in the name of a host which, when executed, invokes a remote
     shell on that host. By creating a directory  and  populating
     it  with symbolic links in the names of commonly used hosts,
     then including the directory in your  shell's  search  path,
     you can run rsh by typing hostname to your shell.

     If rsh is invoked with the basename remsh,  rsh  checks  for
     the  existence  of  the  file  /usr/bin/remsh.  If this file
     exists, rsh behaves as if remsh is an  alias  for  rsh.   If
     /usr/bin/remsh  does not exist, rsh behaves as if remsh is a
     host name.

     For the kerberized rsh session, each user can have a private
     authorization  list  in a file .k5login in their home direc-
     tory. Each line in this file should contain a Kerberos prin-
     cipal name of the form principal/instance@realm. If there is
     a ~/.k5login file, then access is granted to the account  if
     and  only  if the originater user is authenticated to one of
     the principals named in the ~/.k5login file. Otherwise,  the
     originating  user  is  granted  access to the account if and
     only if the authenticated principal name of the user can  be
     mapped  to  the  local account name using the authenticated-
     principal-name  ->  local-user-name   mapping   rules.   The
     .k5login file (for access control) comes into play only when
     Kerberos authentication is being done.



SunOS 5.10          Last change: 26 May 2004                    4






User Commands                                              rsh(1)



     For the non-secure rsh session, each remote machine can have
     a  file  named /etc/hosts.equiv containing a list of trusted
     hostnames with which it shares  usernames.  Users  with  the
     same  username on both the local and remote  machine can run
     rsh  from  the  machines  listed  in  the  remote  machine's
     /etc/hosts.equiv file. Individual users can set up a similar
     private equivalence list with the file .rhosts in their home
     directories.  Each  line  in this file contains two names: a
     hostname and a username separated by a space. The entry per-
     mits  the user named username who is logged into hostname to
     use rsh to access the remote machine as the remote user.  If
     the   name   of   the   local  host  is  not  found  in  the
     /etc/hosts.equiv file on the remote machine, and  the  local
     username  and  hostname  are  not found in the remote user's
     .rhosts file, then  the  access  is  denied.  The  hostnames
     listed in the /etc/hosts.equiv and .rhosts files must be the
     official hostnames listed in the hosts  database;  nicknames
     can not be used in either of these files.

     You cannot log in using rsh as a trusted user from a trusted
     hostname if the trusted user account is locked.

     rsh does not prompt for a password if access  is  denied  on
     the remote machine unless the command argument is omitted.

EXAMPLES
     Example 1: Using rsh to Append Files

     The following command appends the  remote  file  lizard.file
     from   the   machine   called  lizard  to  the  file  called
     example.file on the machine called example:

     example% rsh lizard cat lizard.file >> example.file

     The following command appends the file  lizard.file  on  the
     machine  called  lizard  to the file lizard.file2 which also
     resides on the machine called lizard:

     example% rsh lizard cat lizard.file ">>" lizard.file2

EXIT STATUS
     The following exit values are returned:

     0        Successful completion.



     1        An error occurred.







SunOS 5.10          Last change: 26 May 2004                    5






User Commands                                              rsh(1)



FILES
     /etc/hosts              Internet host table



     /etc/hosts.equiv        Trusted remote hosts and users



     /etc/passwd             System password file



     $HOME/.k5login          File containing Kerberos  principals
                             that are allowed access



     /etc/krb5/krb5.conf     Kerberos configuration file



ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWrcmdc                   |
    |_____________________________|_____________________________|
    | CSI                         | enabled                     |
    |_____________________________|_____________________________|


SEE ALSO
     on(1), rlogin(1), telnet(1), vi(1),  in.rshd(1M),  hosts(4),
     hosts.equiv(4),   ipnodes(4),  krb5.conf(4),  attributes(5),
     krb5_auth_rules(5), largefile(5), ip6(7P)

NOTES
     When a system is listed in hosts.equiv, its security must be
     as  good  as  local  security. One insecure system listed in
     hosts.equiv can compromise the security of the  entire  sys-
     tem.

     You cannot run an interactive command (such as  vi(1)).  Use
     rlogin if you wish to do this.

     Stop signals stop the local rsh process only. This is  argu-
     ably  wrong,  but currently hard to fix for reasons too com-
     plicated to explain here.



SunOS 5.10          Last change: 26 May 2004                    6






User Commands                                              rsh(1)



     The current local environment is not passed  to  the  remote
     shell.

     Sometimes the -n option is needed for reasons that are  less
     than obvious. For example, the command:

     example% rsh somehost dd if=/dev/nrmt0 bs=20b | tar xvpBf -

     puts your shell into a strange  state.  Evidently,  the  tar
     process  terminates  before the rsh process. The rsh command
     then tries to write into the ``broken pipe'' and, instead of
     terminating  neatly, proceeds to compete with your shell for
     its standard input. Invoking rsh with the -n  option  avoids
     such incidents.

     This bug occurs only when rsh is at the beginning of a pipe-
     line  and  is  not reading standard input. Do not use the -n
     option if rsh actually needs to  read  standard  input.  For
     example:

     example% tar cf - . | rsh sundial dd of=/dev/rmt0 obs=20b

     does not produce the bug. If you were to use the  -n  option
     in  a  case  like  this,  rsh  would  incorrectly  read from
     /dev/null instead of from the pipe.






























SunOS 5.10          Last change: 26 May 2004                    7





Man(1) output converted with man2html and wrapped by fishsponge

This page was generated on Wed Sep 12 11:25:21 GMT 2007

Your favourite pages:

No pages logged yet.
Trying to save cookie...

Top 10 most popular pages:

sqlite3 man page (5059 hits)
(openSUSE 10.2)

adv_cap_autoneg man page (4731 hits)
(Solaris 10 11_06)

CPAN man page (4452 hits)
(Suse Linux 10.1)

ssh man page (4241 hits)
(Suse Linux 10.1)

svn man page (4118 hits)
(FreeBSD 6.2)

startproc man page (2159 hits)
(Suse Linux 10.1)

ssh-socks5-proxy-connect man page (2104 hits)
(Solaris 10 11_06)

netcat man page (2088 hits)
(Suse Linux 10.1)

signal man page (1950 hits)
(Suse Linux 10.1)

pprosetup man page (1949 hits)
(Solaris 10 11_06)

Useful Links

Go Back

Visitor Statistics


Valid XHTML 1.0 Transitional     Valid CSS!

Partners: Cambridge Plus :: PYRENEES ACTIVITY HOLIDAYS :: Electronic Circuit Design :: <Link Available>
Unix Man Pages / Linux Man Pages :: HiFi Forum :: SIP VoIP Phone & Provider Reviews :: UNIX/Linux Forum Archives

More info on advertising on Unix/Linux Forum