---
name: "coverpg"
section: "1"
platform: "linux"
package: "mgetty-fax"
version: "1.2.1-2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/coverpg"
---

# coverpg(1)

create a fax coverpg on stdout

## NAME

make.coverpg - create a fax coverpg on stdout

## SYNOPSIS

make.coverpg \[options\] \<pages\> \<sender-ID\> \<sender-NAME\> \<receiver-ID\> \<receiver-NAME\> \<date\> \<time\>

## DESCRIPTION

*make.coverpg*  is called from [faxspool(1)](/faxspool/1.md) to generate a cover page for the just-processed fax. It has to create a proper G3 file (e.g. via [pbm2g3(1)](/pbm2g3/1.md) or hp2hig3(1) or [ghostscript(1)](/ghostscript/1.md)) and output that on stdout. If the program doesn't exist, or can't be executed, the fax simply won't get a coverpage (so, if you don't want a fax coverpage, do not install it...)

*make.coverpg* can put anything it wants on the page, but note that there are certain legal requirements in certain countries about the contents that \*have\* to be on the cover page, for example, the fax phone number of the sender and the recepient, the number of pages, or similar things.

*make.coverpg* gets the informations about the fax to be sent from the command line, in the order listed above.

If the environment variable *normal\_res* is set to something non-empty,  *faxspool* requests that *make.coverpg* creates a cover page in normal resolution (98 lpi). Default is fine resolution (196 lpi).

**NO** *make.coverpg* program is installed by default, since everyones needs differ too wildly.

Some sample coverpage programs are provided in the mgetty source tree, in the samples/ subdirectory (coverpg.pbm shows how to do it with  "pbmtext\|pbm2g3", coverpg.ps shows how I do it with ghostscript).

In this directory, you can also find two shell scripts (fax and faxmemo) that will take advantage of one more esoteric feature of my coverpage programs: if called with the option "-m \<memo-file\>", the sample programs will put a text file "\<memo-file\>" on the cover page (used for short notes or such). To make use of it, *faxspool* is called with the option '-C "make.coverpg -m \<memo-file\>"' (the double quotes are needed!).

## OPTIONS

- none

  ## Example

A five-page fax sent from me to my second number could result in a call like this:

make.coverpg 5 "+49-89-3243328" "Gert Doering" "3244814" "myself" "Sep 15 94" "22:10:00"

## FILES

- **/usr/lib/mgetty-fax/make.coverpg**

  the program itself

## SEE ALSO

[faxspool(1)](/faxspool/1.md), [pbm2g3(1)](/pbm2g3/1.md), [ghostscript(1)](/ghostscript/1.md)

## AUTHORS

The idea behind *make.coverpg* is Copyright (C) 1993 by Gert Doering, \<gert@greenie.muc.de\>, the implementation will most likely have yours...