git.sur5r.net Git - bacula/bacula/blob - bacula/manpages/bsmtp.1

   1 .\"                                      Hey, EMACS: -*- nroff -*-
   2 .TH BACULA\-SMTP 1 "26 September 2009" "Kern Sibbald" "Network backup"
   3 .\" Please adjust this date whenever revising the manpage.
   4 .SH NAME
   5  bsmtp \- Bacula's SMTP (mail delivery program)
   6 .SH DESCRIPTION
   7 bsmtp is a simple mail transport program that permits more flexibility
   8 than the standard mail programs typically found on Unix systems. It can even
   9 be used on Windows machines.
  10
  11 It is called:
  12
  13 Usage: bsmtp [-f from] [-h mailhost] [-s subject] [-c copy] [recipient ...]
  14        -8          set the charset to UTF-8
  15        -c          set the Cc: field
  16        -dnn        set debug level to nn
  17        -dt         print a timestamp in debug output
  18        -f          set the From: field
  19        -h          use mailhost:port as the bsmtp server
  20        -s          set the Subject: field
  21        -r          set the Reply-To: field
  22        -l          set the maximum number of lines that should be sent (default: unlimited)
  23        -?          print this message.
  24
  25 If the  -f option is not specified, bsmtp will use your userid. If
  26 the option is not specified bsmtp will use the value in the environment
  27 variable bsmtpSERVER or if there is none localhost. By default
  28 port 25 is used.
  29
  30 recipients is a space separated list of email recipients.
  31
  32 The body of the email message is read from standard input.
  33
  34 An example of the use of bsmtp would be to put the following statement
  35 in the Messages resource of your bacula-dir.conf file. Note, these
  36 commands should appear on a single line each.
  37
  38   mailcommand = "/home/bacula/bin/bsmtp -h mail.domain.com -f \"\(Bacula\) %r\"
  39                  -s \"Bacula: %t %e of %c %l\" %r"
  40   operatorcommand = "/home/bacula/bin/bsmtp -h mail.domain.com -f \"\(Bacula\) %r\"
  41                     -s \"Bacula: Intervention needed for %j\" %r"
  42
  43 Where you replace home/bacula/bin with the path to your Bacula
  44 binary directory, and you replace mail.domain.com with the fully
  45 qualified name of your bsmtp (email) server, which normally listens on port
  46
  47 It is HIGHLY recommended that you test one or two cases by hand to make sure
  48 that the mailhost that you specified is correct and that it will accept
  49 your email requests. Since bsmtp always uses a TCP connection rather
  50 than writing in the spool file, you may find that your from address is
  51 being rejected because it does not contain a valid domain, or because your
  52 message is caught in your spam filtering rules. Generally, you should specify
  53 a fully qualified domain name in the from field, and depending on
  54 whether your bsmtp gateway is Exim or Sendmail, you may need to modify the
  55 syntax of the from part of the message. Please test.
  56
  57 When running bsmtp by hand, you will need to terminate the message by
  58 entering a ctl-d in column 1 of the last line.
  59
  60 If you are getting incorrect dates (e.g. 1970) and you are
  61 running with a non-English language setting, you might try adding
  62 a LANG="en_US" immediately before the bsmtp call.
  63 .br
  64 .SH AUTHOR
  65 This manual page was written by Jose Luis Tallon
  66 .nh
  67 <jltallon@adv\-solutions.net>.