Click here to Skip to main content
14,573,826 members

An LPR Client in C#

Rate this:
4.30 (18 votes)
Please Sign up or sign in to vote.
4.30 (18 votes)
27 Dec 2006
An article on printing with LPR in C#

screenshot of the demo application

Introduction

This article presents a printer class that supports the LPR print protocol in C#. With this class, it is possible to send a print file in ASCII, PostScript, PCL, etc., directly to a network printer or print server that communicates by means of the LPR (LPD) protocol. The printer class also implements the LPQ, the LPRM, and the Restart request.

Background

The LPR/LPD protocol is a 15 year old print protocol from the TCP/IP suite that is still important in the area of network printers and print servers. It is described in detail in RFC 1179. Augmented variations of the protocol exist, like LPRNG also known as LPR Next Generation.

In an application, I needed to send PostScript files to an LPD enabled printer. It was possible to use the command line lpr.exe which is included in Windows but I didn't want to be dependant on lpr.exe, so I searched for a free C# implementation of LPR. As I could not find one, it was time to build such a class myself.

How to Use the Code

The printer class is straightforward. The constructor is called with three parameters, the hostname, the queue name, and the username. As these parameters are reused again and again with every LPR and LPQ request, I decided to place them in the constructor. Just a choice.

To print a file, one only needs to call LPR with the filename as argument, and to get the content of the spool queue, just call LPQ. The boolean parameter of LPQ indicates a long or small listing. The output format of LPQ depends on the implementation of the LPD daemon in the printer, so there might be no difference.

So the core code to print a postscript file could look like:

if (openFileDialog1.ShowDialog() == DialogResult.OK)
{
    LPD.Printer printer1 = 
         new LPD.Printer("saturnus","queue","rob");
    string fname = openFileDialog1.FileName;
    if (fname.EndsWith(".ps"))
    {
        printer1.LPR(fname);
        textBox1.Text = printer1.LPQ(false);
    }
    else
    {
        // display appropriate error message
        // ...
    }
}

Points of Interest

To use the printer class, one should have a network printer with an LPD daemon, or start the TCP/IP Print Service on a computer (print server). Then, you can send files to any Windows printer defined on the computer. Use the PC name as hostname and the name of the printer as queue name. Be aware that the name of the printers may not contain spaces as the LPR/LPD protocol uses spaces as separators.

LPR does not wait until the file is printed, it starts a thread in the background for every file. LPQ and LPRM do not use a background thread.

The Restart method seems not to be supported in the Windows LPD daemon as I get no acknowledgement. Nevertheless, I kept it in the code (use it at your own risk :).

Some things to improve the class include (no deadline):

  • improve error handling
  • implement status and some other properties
  • fix some todos in the code
  • overload LPR to print from a stream
  • call back when file prints (e.g. for progress indicator)
  • refactor ad fundum

History

  • 2006/12/24 - Version 1.06 - Added some comments, a status string, InternalQueueSize, and filesSend
  • 2006/12/24 - Version 1.03 - Added delete flag (thanks to Dion Slijp)
  • 2006/11/09 - Version 1.02 - Patched code with remarks of Karl Fleischmann
  • 2006/01/14 - Version 1.01 - Added host, queue + user name to demo
  • 2006/01/02 - Version 1.00 - Published on CodeProject
  • 2006/01/02 - Version 0.96 - Added Restart, fixed minor bugs, updated CP page
  • 2005/12/31 - Version 0.92 - Added WriteLog, added LPRM
  • 2005/12/30 - Version 0.90 - Refactoring protocode, writing initial CP page
  • 2005/??/?? - Started with the Printer class

Usage Rights

Everybody is allowed to use this code as long as you refer to the original work, and I would appreciate that enhancements are published at CodeProject too.

License

This article has no explicit license attached to it, but may contain usage terms in the article text or the download files themselves. If in doubt, please contact the author via the discussion board below. A list of licenses authors might use can be found here.

Share

About the Author

rob tillaart
Web Developer
Netherlands Netherlands
No Biography provided

Comments and Discussions

 
Questionanyone tried this with .NET v4.6.1? Pin
David Uhl25-Feb-19 14:05
MemberDavid Uhl25-Feb-19 14:05 
QuestionUnable to print .ps/.pdf files (as well formatted documents) Pin
Member 1203861918-Oct-15 8:00
MemberMember 1203861918-Oct-15 8:00 
QuestionHow to print with unknown file size? Pin
Fuzzy Logician2-Oct-15 11:19
MemberFuzzy Logician2-Oct-15 11:19 
QuestionOption to implement -C parameter ? Pin
Karthikcse19-Jan-15 22:26
MemberKarthikcse19-Jan-15 22:26 
QuestionDownload now working Pin
stevenboz17-Oct-13 18:05
Memberstevenboz17-Oct-13 18:05 
AnswerRe: Download now working Pin
rob tillaart17-Oct-13 22:00
Memberrob tillaart17-Oct-13 22:00 
GeneralThank you! Pin
vicopocho23-Jul-12 4:36
Membervicopocho23-Jul-12 4:36 
GeneralMy vote of 5 Pin
xinshg5-Jul-12 15:16
Memberxinshg5-Jul-12 15:16 
QuestionIs it possible to specify the tray in PostScript? Pin
zhangzq716-Feb-12 23:03
Memberzhangzq716-Feb-12 23:03 
AnswerRe: Is it possible to specify the tray in PostScript? Pin
rob tillaart8-Feb-12 8:31
Memberrob tillaart8-Feb-12 8:31 
GeneralRe: Is it possible to specify the tray in PostScript? Pin
zhangzq718-Feb-12 15:51
Memberzhangzq718-Feb-12 15:51 
GeneralRe: Is it possible to specify the tray in PostScript? Pin
rob tillaart9-Feb-12 9:51
Memberrob tillaart9-Feb-12 9:51 
GeneralRe: Is it possible to specify the tray in PostScript? Pin
zhangzq719-Feb-12 15:36
Memberzhangzq719-Feb-12 15:36 
QuestionWindows 7 64-bit Pin
bobrocks7920-Jul-11 9:27
Memberbobrocks7920-Jul-11 9:27 
AnswerRe: Windows 7 64-bit [modified] Pin
rob tillaart21-Jul-11 0:14
Memberrob tillaart21-Jul-11 0:14 
QuestionNeed Help To Develop IPHONE Printing Pin
Murugan.mcse22-Jun-11 7:03
MemberMurugan.mcse22-Jun-11 7:03 
AnswerRe: Need Help To Develop IPHONE Printing Pin
rob tillaart22-Jun-11 22:16
Memberrob tillaart22-Jun-11 22:16 
GeneralRe: Need Help To Develop IPHONE Printing Pin
Murugan.mcse23-Jun-11 5:23
MemberMurugan.mcse23-Jun-11 5:23 
GeneralRe: Need Help To Develop IPHONE Printing Pin
rob tillaart23-Jun-11 7:11
Memberrob tillaart23-Jun-11 7:11 
Generalsupport for lpr binary mode (lpr -o l) added Pin
justin.killen29-Apr-10 5:50
Memberjustin.killen29-Apr-10 5:50 
GeneralRe: support for lpr binary mode (lpr -o l) added Pin
rob tillaart3-May-10 7:46
Memberrob tillaart3-May-10 7:46 
GeneralUsing PCL to print Pin
vanhungit6-Apr-10 20:52
Membervanhungit6-Apr-10 20:52 
GeneralRe: Using PCL to print Pin
rob tillaart6-Apr-10 22:04
Memberrob tillaart6-Apr-10 22:04 
GeneralPerformance tweaks Pin
Rowland Shaw14-Dec-09 4:15
MemberRowland Shaw14-Dec-09 4:15 
GeneralRe: Performance tweaks Pin
rob tillaart6-Apr-10 22:05
Memberrob tillaart6-Apr-10 22:05 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

Article
Posted 11 Jan 2006

Stats

198.3K views
7.6K downloads
54 bookmarked