Cups

packages:
	cups
	system-config-printer

daemons:
	cups (or cupsd)

configs:
	/etc/cups/cupsd.conf - cups configuration
	/etc/cups/printers.conf - printers configuration
	/etc/cups/lpoptions - printer options configuration
	/home/user/.lpoptions- personal printer options configuration

arguments:
	Listen <addr>:<port> - listen on address:port. can give multiple Listen arguments.
	<Location /path> - set allow/deny settings for a location. close with </Location>
		Order allow,deny - the allow/deny order
		Allow from <addr>

ports:
	631 - allow outgoing. allow incoming on a print server. Manage printers in a browser via http://server:631
	5353 - multicast DNS (mDNS). must allow incoming and outgoing.

protocols:
	lpd:// - LPD/LPR
	ipp:// - IPP (native)
	socket:// - HP JetDirect

commands:
	lp - print to default printer in CUPS
		-d <printer> - specify printer by name
		-h <host:port> - alternate server
		-E - use encryption
		-n <#> - number of copies
		-m - mail confirmation
		-q <#> - priority from 1 (low) to 100 (high)
	lpadmin - manage printers
		-p <name> - name of printer. arbitrary.
		-v <uri> - device to configure. (example parallel:/dev/lp0, ipp://host/printer, socket://192.168.0.1(printer address))
		-m <ppd file> - ppd file in /usr/share/cups/model
		-P <file path> - alternatively specify absolute path to ppd file
		-c <class> - add printer to class. if class doesn't exist it is created automatically.
		-r <class> - removes printer from class. empty classes will be deleted.
		-D <text> - printer description
		-L <text> - location. similar to description.
		-E - enable the printer
		-U <user> - specify user
		-u <allow/deny> - examples: -u allow:user,user,@group -u deny:user -u allow:all -u deny:none
		-o <option> - must give "-o" for each option (ie. -o option -o option)
			job-page-limit=<#> - max pages per user
			job-quota-period=<#> - time in seconds the quota is valid. (ie. 86400 = 24 hours)
			printer-is-shared=<true/false> - default is true
			printer-error-policy=<policy> - how to deal with print errors
				stop-printer (default)
				abort-job
				retry-job
		examples:
			lpadmin -E -p HPJet -v socket:/192.168.0.1 -m HP_LaserJet.ppd.gz -u allow:all
			lpadmin -u allow:root,user1 -u deny:all -d printer1
	lpoptions -d <printer> - sets the printer as the default printer
	lpinfo - information about printing devices	and drivers
		-h <host:port> - alternate server
		-E - use encryption
		-v - verbose
		-m - list installed ppd files
	lpstat - printer status. without arguments, shows all print lobs in queue
		-a - shows printers that are accepting jobs
		-d - shows default printer
		-o <printer> - shows jobs for specific printer
		-p - shows printers that are enabled
		-r - shows whether cups is running
		-t - show status of all printers
		-h <host:port> - alternate server
		-E - use encryption
	lprm - cancel printer jobs
		-h <host:port> - alternate server
		-E - use encryption
	cupsenable <options> <printer name> - enables printer
		-h <host:port> - alternate server
		-E - use encryption
		-c - cancel all jobs
		--hold - hold remaining jobs
		--release - releases held jobs
		-r <text> - reason for down state
	cupsdisable <options> <printer name> - disables printer, still accepts print jobs into queue
		-h <host:port> - alternate server
		-E - use encryption
		-c - cancel all jobs
		--hold - hold remaining jobs
		--release - releases held jobs
		-r <text> - reason for down state
	cupsaccept <options> <printer name> - accepts print jobs into queue
		-h <host:port> - alternate server
		-E - use encryption
		-U <username>
		-r <text> - reason for down state
	cupsreject <options> <printer name> - rejects print jobs into queue
		-h <host:port> - alternate server
		-E - use encryption
		-U <username>
		-r <text> - reason for down state
	cancel <options> <job name> - cancel print jobs. jobs viewable with lpstat
		-h <host:port> - alternate server
		-E - use encryption
		-U <username>
		-a - cancel all jobs

LDP printing system:
	lpr - print to default printer in LPD system
		-H <host:port> - alternate server
		-E - use encryption
		-#<#> - number of copies
		-q - hold job for printing
	lpc status - view status of printers
	lpq - show print jobs in queue
		-h <host:port> - alternate server
		-E - use encryption
		-U <username>
		-P <printer>
		-l - verbose
		-a - show all
	lprm <options> <#> - remove print jobs
		-h <host:port> - alternate server
		-E - use encryption
		-U <username>
		-a - cancel all jobs