emo/busybox
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

lpr: add more accurate comments

Browse Source 
*: trailing whitespace removal
This commit is contained in:
Denis Vlasenko 2008-03-24 02:05:58 +00:00
parent 39c77c3738
commit 42cc304e90
10 changed files with 35 additions and 28 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

9
printutils/lpd.c
View File

@ -34,6 +34,9 @@
* where XXX is the job number and HHHH is the client hostname. Unless a printing helper application * where XXX is the job number and HHHH is the client hostname. Unless a printing helper application
* is specified lpd is done at this point. * is specified lpd is done at this point.
* *
* NB: file names are produced by peer! They actually may be anything at all!
* lpd only sanitizes them (by removing most non-alphanumerics).
*
* If HELPER-PROG (with optional arguments) is specified then lpd continues to process client data: * If HELPER-PROG (with optional arguments) is specified then lpd continues to process client data:
* 1. it reads and parses control file (cfA...). The parse process results in setting environment * 1. it reads and parses control file (cfA...). The parse process results in setting environment
* variables whose values were passed in control file; when parsing is complete, lpd deletes * variables whose values were passed in control file; when parsing is complete, lpd deletes
@ -50,12 +53,16 @@
* $M = the user to whom a mail should be sent if a problem occurs * $M = the user to whom a mail should be sent if a problem occurs
* $l = name of datafile ("dfAxxx") - file whose content are to be printed * $l = name of datafile ("dfAxxx") - file whose content are to be printed
* *
* lpd also provides $DATAFILE environment variable - the ACTUAL name
* of the datafile under which it was saved.
* $l is not reliable (you are at mercy of remote peer), DON'T USE IT.
*
* Thus, a typical helper can be something like this: * Thus, a typical helper can be something like this:
* #!/bin/sh * #!/bin/sh
* cat "$l" >/dev/lp0 * cat "$l" >/dev/lp0
* mv -f "$l" save/ * mv -f "$l" save/
*
*/ */
#include "libbb.h" #include "libbb.h"
// strip argument of bad chars // strip argument of bad chars