unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (Debian-3.1)
Page:
Section:
Apropos / Subsearch:
optional field

PTAL-CONNECT(8)             TTF2PT1 Font Converter             PTAL-CONNECT(8)



NAME
       hpoj reference: "ptal-connect" and "ptal-print"

SYNOPSIS
       ptal-connect [devname] action [options...]  ptal-print [devname]
       [options...]

DESCRIPTION
       The "ptal-connect" command-line utility provides access to the various
       stream services on the device.  "ptal-print" is a symlink alias for
       "ptal-connect" that defaults to connecting to the print service.  They
       are similar to a "telnet" client, in that once connected to the service
       on the device, data on standard input is sent to the device over the
       open channel as "forward" data, and any "reverse" data received from
       the device over the open channel is sent to standard output.

OPTIONS
       o   "devname" is the optional PTAL device name

       o   "action" specifies the remote service and is one of:

           o   "-print" -- the print service (the default for "ptal-print")

           o   "-scan" -- the scan service

           o   "-socket socketID" -- a particular remote socket ID

           o   "-service serviceName" -- a particular remote service name

       o   "options..." is zero or more of:

           o   "-eoftimeout seconds" -- Idle timeout before exiting after an
               end-of-file condition is encountered on standard input

           o   "-fwdlen maxForwardDatalen" -- Forward data packet size
               requested to be negotiated with the device

           o   "-revlen maxReverseDatalen" -- Reverse data packet size
               requested to be negotiated with the device

           o   "-retrycount seconds" -- Maximum number of times to retry a
               failed connection (default is 10)

           o   "-noretry" -- Disables retries of failed connections (same as
               ""-retrycount 0"")

           o   "-infretry" -- Retries failed connections forever (same as
               ""-retrycount -1"")

           o   "-retrydelay seconds" -- Delay between each retry (default is
               1)

           o   "-quiet" -- Disables "connecting" message

           o   "-uel", "-nouel" -- Enables/disables print job boundary escape
               sequences (default is disabled)

           o   "-dump" -- Dumps data structures (for debugging)

NOTES
       Service name lookup is part of the 1284.4 protocol, and is simulated by
       "ptal-mlcd" and by the JetDirect firmware for MLC mode.  Therefore, you
       should usually be able to specify the service name for well-known ser-
       vices.  For other services, you may need to specify both "-service" for
       1284.4 mode and "-socket" for MLC mode.  "-print" is used by
       "ptal-cups" (the PTAL CUPS backend) to pass printer-ready data to the
       device.  ""-service ECHO"" is useful for verifying basic device connec-
       tivity, because text you send in the forward direction is echoed in the
       reverse direction.  (However, this service may not work properly on the
       OfficeJet LX and 300 series.)  "-scan" only connects to the scan ser-
       vice on the device and doesn't in an of itself start a scan operation;
       use "libsane-hpoj" for that.  It is not recommended to call ""ptal-con-
       nect -scan"" directly, because in certain cases it may make the scan
       service unusable for subsequent actual scans (due to improper negoti-
       ated packet sizes) until the device is power-cycled or "ptal-mlcd" is
       restarted.  "ptal-mlcd" supports several "virtual" services which do
       not involve the device in any way.  Most if not all devices have a
       limit of one connection to each service at any given time.  Subsequent
       connections will fail.  The "datalen" parameters to "-fwdlen" and
       "-revlen" do not include the 6-byte header inherent in the MLC and
       1284.4 protocols.  The requested sizes are not guaranteed to be hon-
       ored, because the device is permitted to reduce either or both sizes.
       For MLC mode, the negotiated packet sizes for a given service are fixed
       after the first negotiation, and subsequent requests are ignored.  For
       1284.4 mode, different sizes may be honored each time.  Some combina-
       tions of sizes may have erroneous results on some models.  Specifying
       "-infretry" causes failed connection attempts to be retried indefi-
       nitely, even in situations where the connection would never be success-
       ful.  Other (non-negative) retry options may cause fewer retries than
       expected, depending on the nature of the connection failure.  If you're
       connecting through an HP JetDirect print server (i.e. with a PTAL
       device name prefix of "hpjd:"), then the following limitations apply:

       o   "-scan", "-socket", and "-service" require a JetDirect model with
           multi-function peripheral support:

           o   Parallel-port JetDirects: 70X, 170X, 300X, or 500X only

           o   USB JetDirects: 175X and probably later models

       o   "-scan" requires firmware x.07.xx or later.

       o   "-socket" and "-service" require firmware x.08.xx or later.

       o   For parallel-port JetDirects, "-socket" and "-service" are only
           supported for devices running in 1284.4 (not MLC) mode.  For USB
           JetDirects, they are supported in both modes.

       o   A limited number of clients may have "-socket" and "-service" con-
           nections to the same device at any given time, even if they are to
           different services.

       o   "-fwdlen" and "-revlen" requests are ignored.



current                         March 13, 2005                 PTAL-CONNECT(8)