BMAIL(8)

NAME
`NJELIB'/bmail - bitnet mail send tool

SYNOPSIS

bmail
    [ -nd Gateway-address ] [ -b(smtp) Gateway-address ] [ -tag RSCS-TAG ] [ -u origuser ]
    FromUser@FromNode ToUser@ToNode [ ToUser@ToNode... ]

DESCRIPTION

bmail command is actually a special purpose sendfile (Historically: code of sendfile reused a lot of bmail code) for mail transport, and thus is not a general user program. Its input is a ready-made mail file, and it generates a BSMTP envelope, when so requested.

Options for bmail are:

-b(smtp) gateway@host
    informing that the feed in mail shall be wrapped into a BSMTP/PUNCH envelope with "MAIL FROM:<>" getting the first argument, and "RCPT TO:<>" getting the rest (1 to many..) This option has two alternate names: "-b", and "-bsmtp". Line length is limited to 80 chars on this mode! Wrapping of longer lines is attempted, but it might not always be successfull.

-nd gateway@host
    informing that the feed in mail shall be wrapped into a BSMTP/NETDATA envelope with "MAIL FROM:<>" getting the first argument, and "RCPT TO:<>" getting the rest (1 to many..) This accept indefinite length lines, minimum being 80 chars, true value is calculated while preparing the BSMTP envelope into a temporary file.

-tag RSCS-TAG
    defines the 136 bytes (padded/truncated to that length) RSCS TAG data. Usually not needed with bmail.

-u origuser
    Can be used to define local mail-sender pseudo-id. For BSMTP modes the default value is MAILER. For others it is local user.

When bmail's `From' argument contains a `.' in it, the file sender is changed to be "MAILER@localname", however possible BSMTP will contain entered `From' information.

INTERFACING TO SYSTEM MAILER
In case of zmailer(8z) by Rayan Zachariassen, interface goes as follows:

   $MAILSHARE/db/routes.bitnet contains:
	academic         bsmtp3!mailer!academic
	acmvm            bsmtp3!mailer!acmvm
	acusd            defrt1!acusd
	finhutc          bsmtp3nd!mailer!finhutc
   $MAILSHARE/sm.conf  contains:
	#
	# bitnet stuff F=hu not set
	#
	bsmtp3   snmSX /usr/local/lib/huji/bmail  bmail -b $h -u MAILER $g $u
	bsmtp3nd snmSX /usr/local/lib/huji/bmail  bmail -nd $h -u MAILER $g $u
	defrt1   snS   /usr/local/lib/huji/bmail  bmail $g $u
	bitnet2  snS   /usr/local/lib/huji/bmail  bmail $g $u
   $MAILSHARE/scheduler.cf  contains:
	defrt1/*
                command="sm -c $channel defrt1"
	bsmtp3/*
                command="sm -c $channel bsmtp3"
	bsmtp3nd/*
                command="sm -c $channel bsmtp3nd"

Getting this installed into a BSD sendmail(8) should not be very difficult, but definitely different.. Propably `mailer' definitions resemble `sm.conf' above.

ENVIRONMENT
With environment variable EBCDICTBL user can select alternate EBCDIC <-> ASCII translation tables. For more info, see ebcdictbl(5).

FILES
/etc/funetnje.cf
/etc/name.bitnet (For system mailer)

SEE ALSO
bitspool(5), ebcdictbl(5), funetnje(8), mailify(1), qrdr(8), receive(1), sendfile(1), transfer(1)

BUGS

None that we know.

DIAGNOSTICS
These programs show their usage summary, when there is something wrong with input parameters. Subtle usage bugs might not be detected!

WARNINGS
When BSMTP envelope address overflows to longer than 80-characters, and NETDATA is not used, there is no check at it, nor folding... (There is a deliberate TRUNCATE at 80 cols, though..) With the NETDATA the input can be of arbitary long lines (up to 64000 characters each).

AUTHORS

Yehavi Bourvine, Hebrew University of Yerusalem, Israel <yehavi@hujivms.bitnet>.

Matti Aarnio, Finnish University and Research Network - FUNET, Finland <mea@nic.funet.fi> <mea@finfiles.bitnet>.

Original (VMS oriented package) software by Yehavi Bourvine, UNIX features, plenty of modifications, man-pages by Matti Aarnio.