xtlpc - LPD protocol server driver

# NAME

xtlpc - LPD protocol server driver

# SYNOPSIS

xtlpc -H hostname -f ctrlfile [ -F fifo ] [ -S host ] [ -P ptrname ] [ -N ] [ file ]

# DESCRIPTION

xtlpc is a terminal server program for use by GNUspool where the destination is an LPD protocol server. Input is usually taken from standard input, or from the supplied file name.

# OPTIONS

-H hostname

  This is the host name or IP address to be used to access the printer. In GNUspool setup files, it may be appropriate to substitute `$SPOOLDEV` or `$SPOOLPTR` here.

-f ctrlfile

  This specifies the location of the control file, typically xtlpc-ctrl in the internal programs directory.

-S hostname

  This is the host name or IP address of the sending host, in the cases where `gethostname(3)` does not yield an appropriate answer.

-P ptrname

  The LPD protocol supplies a name to the printer. By default, this is taken from SPOOLPTR, i.e. the name given as the name of the printer under GNUspool. Some terminal servers require a specific name to be given to the printer, perhaps to select which printer, or printer option of several is to be specified. This option overrides this printer name in the protocol.

-F fifo

  Take input from the named fifo rather than standard input or the supplied file.

  This is useful in situations where the LPD protocol has to be run from a command line, i.e. a console session, and files sent to it by having GNUspool write to the fifo.

-N

  Avoid sending zero length files, which confuse some servers.

# DIAGNOSTICS

xtlpc generates any appropriate diagnostics on standard error.

# EXIT CODES

Normal termination is denoted by an exit code of zero.

1. Usage error, invalid option etc.

2. No control file given.

3. No destination host given.

4. Cannot open input file.

5. Unknown host name.

6. Cannot open control file.

7. Syntax errors in control file.

8. No spool directory defined.

9. Cannot select spool directory.

10. Control card format not given in control file

11. Invalid format control card in control file

12. Cannot write to spool directory

13. Cannot create spool file

14. Cannot allocate file name.

15. Cannot open FIFO.

16. Name given is not a FIFO.

17. Cannot specify input and FIFO.

18. Cannot create sequence file

19. No port name in control file

20. TCP protocol missing

21. Cannot find named port in service file

22. Cannot open socket.

23. Cannot bind port

24. Cannot allocate TCP device

25. Cannot make connection

26. Cannot allocate TCP space or change stream

27. Write failure writing to socket

28. Lost spool file

29. Read failure ack packet.

30. Error return from remote.

31. Cannot determine own host name

32. Invalid host name

33. Exit on signal.

# FILES

xtlpc-ctrl control file

/var/spool/gnuspool/xtlpc spool directory (may be changed in xtlpc-ctrl)

# SEE ALSO

xilp(8), xtelnet(8), xtftp(8), xtlhp(8).

# COPYRIGHT

Copyright (c) 2009 Free Software Foundation, Inc. This is free software. You may redistribute copies of it under the terms of the GNU General Public License <http://www.gnu.org/licenses/gpl.html>. There is NO WARRANTY, to the extent permitted by law.

# AUTHOR

John M Collins, Xi Software Ltd.