This file is indexed.

/usr/share/doc/sendpage-common/docs/sendmail.txt is in sendpage-common 1.0.3-1.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
$Id: sendmail.txt 316 2008-01-03 20:21:19Z keescook $


Just to note, this documentation assumes you're using sendmail version 8.8.x
or better.


To get sendpage working with sendmail, there are a few things you'll need:

	1) set up sendpage (and test)
	2) get yourself a paging domain
	3) configure sendmail to use your domain
	4) configure email2page.conf
	5) test your set up
	6) add stuff to your sendmail.cf file


Step 1: Set up sendpage (and test)
----------------------------------

	Assuming you've already configured sendpage, and tested it with
"snpp", and you've gotten your page, you're ready to move on to step 2.


Step 2: Get yourself a paging domain
------------------------------------

	Since I get most of my email from "outflux.net", I decided I'd
make my paging domain "pager.outflux.net".  So I added this to my DNS
information, and refreshed my DNS server.  Once you have a domain resolving
with your DNS server, continue to step 3.


Step 3: Configure sendmail to use your domain
---------------------------------------------

	Add your domain to either the "Cw" line in sendpage, or add it
to the /etc/sendmail.cw file (recommended).  Restart sendmail, and
continue to step 4.


Step 4: Configure email2page.conf
---------------------------------

	Take a look at /etc/email2page.conf and set up the header rules
to suite your needs.  The file is fairly well documented.  When finished,
continue to step 5.


Step 5: Test your set up
------------------------

	Send a page by piping an email (with headers) into "sendmail2snpp".
This tool should run "email2page" and "snpp" for you.  Once you get it 
working, continue to step 6.


Step 6: Add stuff to your sendmail.cf file
------------------------------------------

	I recommend using style a), but you can choose either:

	a) add stuff to your sendmail.mc file (and regenerate your sendmail.cf
	   file).  Change "pager.outflux.net" and the sendmail2snpp path, if
	   you need to:

		dnl
		dnl Kees' changes for sendpage
		dnl
		# for pager gateway
		CGpager.outflux.net
		LOCAL_RULE_0
		# sendpage
		R$+<@$=G.>	$#sendpage $:$1
		define(`SENDPAGE_MAILER_PATH',`/usr/local/bin/sendmail2snpp')
		define(`SENDPAGE_MAILER_FLAGS',`lsPn')
		define(`SENDPAGE_MAILER_ARGS',`sendmail2snpp -f $f')
		MAILER_DEFINITIONS
		Msendpage, P=SENDPAGE_MAILER_PATH, F=SENDPAGE_MAILER_FLAGS,
			S=10, R=20, A=SENDPAGE_MAILER_ARGS $u

	-or-

	b) add stuff to your sendmail.cf file directly.  Change
	   "pager.outflux.net" and the sendmail2snpp path, if you need
	   to.

		Near the top:

			# for pager gateway
			CGpager.outflux.net

		At the end of rule "S98":

			# sendpage
			R$+<@$=G.>	$#sendpage $:$1

		Near your mailer definitions:

			Msendpage, P=/usr/local/bin/sendmail2snpp, F=lsPn,
				S=10, R=20, A=sendmail2snpp -f $f $u



Once that's done, restart sendmail with your new .cf file, and you should
be ready to rock and roll.


Troubleshooting
---------------
On RedHat systems, or machines using "smrsh", try this:

	Here is how to get smrsh to work:
	cd /etc/smrsh
	ln -s /usr/bin/sendmail2snpp sendmail2snpp
	restart sendmail
	edit /etc/aliases to include:
	ALIAS: "|/etc/smrsh/sendmail2snpp PIN@PC"
	run newaliases

From Brett Carroll.


-Kees Cook
 kees@outflux.net