rlpcmd(1)


rlpcmd -- print on a remote system using TCP/IP

Synopsis

/usr/spool/lp/bin/rlpcmd rsh_args

/usr/spool/lp/bin/rlpcmd node lp lp_args

Description

rlpcmd sets the real user ID to lp and then runs rsh(1) with the arguments rsh_args.

Typically, the network printer interface script uses rlpcmd for remote printing using TCP/IP. In this case, rsh_args specify the remote machine node, the lp(1) command and its option arguments (see ``Examples'').

You must establish user equivalence for lp on the remote machine with lp on the local machine. One way to do this is to create a .rhosts file in the home directory of lp on the remote machine (see hosts(4tcp)). lp or root must own the .rhosts file, and this must not be writable by other groups or users.

Files


/usr/bin/rlpcmd
full pathname of rlpcmd

/usr/spool/lp/.rhosts
permissions file for remote login by lp

/usr/spool/lp/remote
remote printer definitions used by the network interface script

/usr/lib/lp/model/network
interface script for remote printing

Exit codes

rlpcmd returns the exit value of rsh(1) if it executes successfully; it returns 1 if it cannot determine the user ID of user lp; it returns an error code if the real user ID cannot be set to the current user, or if rsh cannot be executed.

References

rlpconf(1M), rlpstat(1), rsh(1)

Notices

rlpcmd requires the inet package to have been installed.

rlpcmd should work from UnixWare systems to any system which understands the TCP/IP rsh protocol. However, this is not guaranteed.

Examples

Local printer p_here prints on remote printer p_there attached to host machine m_there. The printer p_here should be configured using rlpconf(1M). network, the interface script for p_here on the local machine m_here, reads the following entry in the printer definitions file /usr/spool/lp/remote:
   p_here: /usr/spool/lp/bin/rlpcmd m_there lp -dp_there -onobanner -oraw
In practice, the -o options that you would specify to lp depend on the configuration of the remote printer.

The entry in the /usr/spool/lp/.rhosts file on m_there would be:

   m_here	lp

Standards compliance

rlpcmd is not part of any currently supported standard; it is an extension of AT&T System V provided by The Santa Cruz Operation, Inc.
© 2004 The SCO Group, Inc. All rights reserved.
UnixWare 7 Release 7.1.4 - 25 April 2004