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

postio 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                                           postio(1)



NAME
     postio - serial interface for PostScript printers

SYNOPSIS
     postio -l line [-D] [-i] [-q] [-t] [-S] [-b speed]  [-B num]
     [-L file] [-P string] [-R num] [file...]

     /usr/lib/lp/postscript/postio

DESCRIPTION
     postio sends files to the  PostScript  printer  attached  to
     line. If no files are specified the standard input is sent.

OPTIONS
     The first group of options should  be  sufficient  for  most
     applications:

     -D              Enable debug mode.  Guarantees  that  every-
                     thing  read on line will be added to the log
                     file (standard error by default).



     -q              Prevents  status  queries  while  files  are
                     being  sent  to  the  printer.  When  status
                     queries are  disabled  a  dummy  message  is
                     appended  to  the log file before each block
                     is transmitted.



     -b speed        Transmit data over line at baud rate  speed.
                     Recognized  baud rates are 1200, 2400, 4800,
                     9600, and 19200. The default speed is   9600
                     baud.



     -B num          Set the internal buffer size for reading and
                     writing  files  to num bytes. By default num
                     is  2048 bytes.



     -l line         Connect to the printer attached to line.  In
                     most  cases  there is no default  and postio
                     must be able to read and write line. If  the
                     line  does  not  begin  with  a  / it may be
                     treated as a Datakit destination.






SunOS 5.10           Last change: 9 Sep 1996                    1






User Commands                                           postio(1)



     -L file         Data received on line gets put in file.  The
                     default  log file is standard error. Printer
                     or status messages that don't show a  change
                     in  state  are  not normally written to file
                     but can be forced out using the -D option.



     -P string       Send string to the printer before any of the
                     input  files.  The  default string is simple
                     PostScript code that disables timeouts.



     -R num          Run postio as a single process if num  is  1
                     or  as  separate read and write processes if
                     num is 2. By default postio runs as a single
                     process.



     The next two options are provided for users  who  expect  to
     run  postio  on  their  own.  Neither is suitable for use in
     spooler interface programs:

     -i       Run the program in interactive mode. Any files  are
              sent  first  and  followed  by  the standard input.
              Forces separate read and write processes and  over-
              rides  many other options. To exit interactive mode
              use your interrupt or  quit  character.  To  get  a
              friendly  interactive  connection  with the printer
              type executive on a line by itself.



     -t       Data received on line and not recognized as printer
              or  status  information  is written to the standard
              output. Forces separate read and  write  processes.
              Convenient  if  you  have a PostScript program that
              will be returning useful data to the host.



     The last option is not generally recommended and should only
     be used if all else fails to provide a reliable connection:

     -S       Slow the  transmission  of  data  to  the  printer.
              Severely  limits  throughput, runs as a single pro-
              cess, disables the -q option, limits  the  internal
              buffer  size  to  1024  bytes, can use an excessive
              amount of CPU time, and does nothing in interactive
              mode.



SunOS 5.10           Last change: 9 Sep 1996                    2






User Commands                                           postio(1)



     The best performance will usually be  obtained  by  using  a
     large  internal  buffer  (the  -B option) and by running the
     program as separate read  and  write  processes  (the  -R  2
     option).  Inability  to  fork  the additional process causes
     postio to continue as a single read/write process. When  one
     process  is used, only data sent to the printer is flow con-
     trolled.

     The options are not all mutually exclusive.  The  -i  option
     always  wins,   selecting  its  own settings for whatever is
     needed to run interactive mode, independent of anything else
     found on the command line. Interactive mode runs as separate
     read and write processes and few of the other options accom-
     plish  anything  in  the  presence  of the -i option. The -t
     option  needs a reliable two way connection to  the  printer
     and  therefore  tries  to  force  separate  read  and  write
     processes. The -S option relies on the status query  mechan-
     ism, so -q is disabled and the program runs as a single pro-
     cess.

     In most cases postio starts by making a connection  to  line
     and  then attempts to force the printer into the  IDLE state
     by sending an appropriate sequence of  ^T (status query), ^C
     (interrupt),  and   ^D  (end  of  job)  characters. When the
     printer goes IDLE, files are transmitted along with an occa-
     sional   ^T  (unless  the -q option was used). After all the
     files are sent the program waits until it's reasonably  sure
     the  job  is  complete.  Printer  generated  error  messages
     received at any time  except while establishing the  initial
     connection  (or when running interactive mode) cause  postio
     to exit with a non-zero status. In addition to  being  added
     to  the  log file, printer error messages are also echoed to
     standard error.

EXAMPLES
     Example 1: Examples of the postio command.

     Run as a single process at 9600 baud  and  send   file1  and
     file2 to the printer attached to /dev/tty01:

     example% postio -l /dev/tty01 file1 file2

     Same as above except two processes are  used,  the  internal
     buffer  is  set  to  4096  bytes,  and  data returned by the
     printer gets put in file log:

     example% postio -R 2 -B 4096 -l/dev/tty01 -L log file1 file2

     Establish an interactive connection  with   the  printer  at
     Datakit destination my/printer:





SunOS 5.10           Last change: 9 Sep 1996                    3






User Commands                                           postio(1)



     example% postio -i -l my/printer

     Send file program to the printer connected  to   /dev/tty22,
     recover  any  data in file results,  and put log messages in
     file log:

     example% postio -t -l /dev/tty22 -L log program >results

EXIT STATUS
     The following exit values are returned:

     0               Successful completion.



     non-zero        An error occurred.



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

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWpsf                     |
    |_____________________________|_____________________________|


SEE ALSO
     download(1), dpost(1), postdaisy(1), postdmd(1),  postmd(1),
     postprint(1), postreverse(1), posttek(1), attributes(5)

NOTES
     The input files are handled  as  a  single  PostScript  job.
     Sending several different jobs, each with their own internal
     end of job mark (^D) is not  guaranteed  to  work  properly.
     postio may quit before all the jobs have completed and could
     be restarted before the last one finishes.

     All the capabilities described above may not be available on
     every  machine or even across  the different versions of the
     UNIX system that are currently supported by the program.

     There may be no default line, so using  the  -l  option   is
     strongly recommended. If omitted, postio may attempt to con-
     nect to the printer using the standard output. If Datakit is
     involved,  the -b option may be ineffective  and attempts by
     postio to impose flow control over data in  both  directions
     may not work.  The -q option can help if the printer is con-
     nected  to  RADIAN.  The  -S  option    is   not   generally



SunOS 5.10           Last change: 9 Sep 1996                    4






User Commands                                           postio(1)



     recommended and should be used only if all other attempts to
     establish a reliable connection fail.





















































SunOS 5.10           Last change: 9 Sep 1996                    5





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

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

Your favourite pages:

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

Top 10 most popular pages:

sqlite3 man page (5333 hits)
(openSUSE 10.2)

svn man page (5208 hits)
(FreeBSD 6.2)

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

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

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

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

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

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

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

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

Useful Links

Go Back

Visitor Statistics


Valid XHTML 1.0 Transitional     Valid CSS!

Partners: Cambridge Plus :: Pyrenees Area :: 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