waffle-faq

关于黑客的论坛的下载资料

1.64:       81     44     57     46     18     14
1.65:      266    266    280    286    240    274
1.66:        0      0      0      0      0      1
           ---    ---    ---    ---    ---    ---
           358    320    348    339    258    289

(you can't trust the version numbers -- due to these numbers
being posted, a few people have put out fake w166w headers...
although it looks like the home site is sending them out for real)

the numbers now watch for other waffle-specific newsreaders,
so the `waffle' numbers are lower than the actual number of
waffle sites.

the numbers _have_ been posted regularly, so I haven't updated
this part of the FAQ in a while.


------------------------------

Subject: waffle: Mail
From: [e-mail]

1. How can I route domainized mail for my uucp neighbor directly to them ?

Domain-based mail goes to your smarthost (as defined in static)
unless you override that route with an entry in paths.

If you mail to `[e-mail]' and you're directly
connected to them via UUCP, you can force a direct delivery
with a /waffle/uucp/paths entry of :

        hostname.domain         hostname

2. What should I do with my headers?

Not a lot unless you know what you're doing.

In general, you want your `netmail' and `netnews' parameters in
static to result in valid headers, so that people can reply to you.

If you can do so, get into a domain and domainize all your headers.
It'll make your life easier and will do the same for people who
exchange mail with you.

The important thing to remember is that if you put a domain-style
address out without being domainized, people will probably not be
able to reply to your mail.  Just because an address looks good
doesn't make it valid.  Most notably, `[e-mail]'
is invalid.

3. I'm not in a domain.  What should my headers look like ?

The work you put into getting a real domain address may easily be
less than the work you put into trying to figure out why people
from mismanaged or poorly-equipped sites can't reach you.

In general, you want to have an address that is a known-good route
from a known site.

Some possibilities are:

        All bang-path ===> some_known_host!your_site!you
                (i.e. mailfrom: psuvax1!%u!%A
                   or mailfrom: psuvax1!%n!%A)

        mixed format  ===> you%your_site.uucp@some_internet_site
                (i.e. mailfrom: [e-mail])
                           your_site!you@some_internet_site
                (i.e. mailfrom: %u![e-mail]
                   or mailfrom: %n![e-mail])

        (All of the examples above assume something like:
                node: hogbbs.UUCP
                uucpname: hogbbs
         in your static file)

The actual format that works best for you depends on who you're
connected to and what their mailer can handle.

Note that the all bang-path format is not recommended for news;
sites running B News will mangle your article in such a way that
downstream sites running newer software will drop it on the floor.

4. I'm a single-user site. Should I register in the UUCP maps?

Yes, or get a domain name.  (FQDN==fully qualified domain name)

The bottom line is that if people try to mail to you, you want
your address to be reachable.  From Internet, you want to get
domainized and get a MX record if you can.

HOWEVER:

Until an error in rnews gets fixed, however, putting your FQDN in
news can cause news to not be fed IF your feed's news-header FQDN
is a strict substring of your news-header FQDN -- so you _have_
to go with the registered name in those cases.  (an example:  if
your news feed identifies itself as foo.domain, and your name is
bar.foo.domain, rnews won't send your news out unless you get
tricky with options and your feed gets tricky with config files)

From UUCP-only sites that don't touch Internet and don't care
enough about mail reliability to get a domain name, you need at
least a map entry (or a header that routes you through somebody
with a map entry you can trust).

Also, you shouldn't put anything in your Path: header between
the `!'s other than a FQDN or your _registered_ uucp name.  if
you like the name `foo' but don't register it, don't send out
news that says:

  `Path: foo!user'

since the person who actually did the _right_ thing and registered
foo won't ever see your news -- and neither will the sites beyond
that site, probably.  What you _should_ have in this case is

  `Path: foo.some.org!user'

by setting the `newsname' parameter in the STATIC file.

not to MENTION mail getting mixed up.


5. Can I display something other than the sender when listing mail ?

Yes, as of 1.65 you can specify the header you want to see when
you do a list of messages via the `listmail' item in static.
Unfortunately, this is not configurable per-user, only per-site.

6. Does Waffle support mail folders ?

Yes, as of 1.65.

If you have no new mail in your mailbox, you can say `mail *' to
get a list of mailboxes to read.

7. Can I use (my favorite mail program) ?

Some people have had luck with `readmail' for reading only,
and at 1.65 either mush or pc-elm should work for read/write.

Version 1.65 has MMDF-style mailboxes with messages separated
by four control-A's, so mush and pc-elm should be able to
read/write these messages, though you'll have to reindex your
mailbox with `makebox' or the like if you write to it.

8. Can I keep a record of all mail that comes into the system ?

Yes, create a file called `inbox' in \waffle\admin and all
incoming mail will be copied there. You can stash this file
elsewhere via the rr.inbox variable in the static file.
See rmail.doc for more information...

9. Can I get FidoNet Netmail on my Waffle?

See question 12 under NEWS, for information about Erin/Amanda.


------------------------------

Subject: waffle: Files section
From: [e-mail]

1. How can I set the prompt in the files section ?

Use the `fileprom' static file parameter.  Try `fileprom : [$f] :'
as an example.  (it was undocumented before v1.65)

2. I use a Fossil driver and a 16550 UART with FIFOs enabled. After
     someone transfers a file, why does it seem as if characters are not
     being transmitted?

If you use DSZ, it directly accesses the UART, and uses the
FIFOs.  By default, it turns them OFF when it finishes. Since
Waffle doesn't reset the Fossil driver, it tries stuffing
characters into a buffer that's turned off.

The fix is to use the `F' flag on DSZ's command line in
\waffle\extern\_send and _receive:

Z /command="C:\waffle\bin\dsz F port %d est 0 %b sz -m %i",

or to use the new (as of 1.65) /reset flag on the extern to 
make Waffle reset the FOSSIL:

Z /command="C:\waffle\bin\dsz port %d est 0 %b sz -m %i" /reset

This can also affect file transfers using the built-in
editor.

3. People with priv 9 can access the file section fine, but people with
    normal access get `Validation is required to use the FILES section.'

Check your /waffle/system/dirs file.  This error occurs if
the user does not have access to the root file directory
(`files:' in the static file).  A sample from hogbbs's (working)
configuration:

        /waffle/system/static:

                files: f:/file

        /waffle/system/dirs:

                1 /dir="f:/file" /access=1


------------------------------

Subject: waffle: Externals
From: [e-mail]

1. How do they all work ?

Simple.  There's \waffle\extern\_system for the normal
commands, and you can add any command you want with any access
you want by adding a corresponding file to the \waffle\extern
directory.  The file that you create corresponds to the name of
the new command.  Be very careful regarding security, though,
as externs can be the least secure part of Waffle.

2. I use 4DOS, yet Waffle shells out to DOS, not 4DOS...

You need to change the command interpreter in \waffle\extern\_system
to use 4DOS rather than command.com

3. If I implement Waffle as a door from another BBS, how can users exit
    from Waffle without dropping carrier?

First, disable the `exit' command in Waffle by adding the
following line to your static file.

        disable: exit

Then provide an external implementation of the exit command by
creating extern\exit with the following contents.

        /access=0 /logout=exit /log /exit=81

This causes Waffle to exit, without dropping the modem connection,
with errorlevel 81 (or whatever level you want to specify).  The
/access=0 ensures that all Waffle users can get back out once they
get in.  Then you just trap errorlevel 81 in the batch file that
started Waffle to go back to the other BBS.


------------------------------

Subject: waffle: Editors
From: [e-mail]

1. What editors can I use ?

Locally, any editor your little 'ol heart desires that works
in pure ASCII (ie, you could use WordPerfectOffice, but not
WordPerfect itself since that saves in a non-ASCII format normally).

Remotely, you have to be careful to use an editor that is ANSI
oriented and that doesn't do direct DOS screen I/O. Some editors
that are frequently used (and are available on SimTel and other
fine archive sites) include:

        MEANSI     - MicroEmacs compiled to use ANSI mode.
        BBStevie   - vi clone
        FSED       - a very configurable editor that can be made to
                        look like just about any editor you want
        WWIVEDIT   - the editor for WWIV

Be aware that if you set up external editors for your remote users,
you might have a security risk on your hands.  Be sure that you
know whether your editor will let a remote user shell out to the
operating system or not, and that you're giving exactly the
privileges you mean to give out.

BBStevie in particular is designed to be configurable so that you
can prevent folks from getting to the shell (if you want) and you
can use the same binary to ALLOW some other folks shell access if
you want to do that, based on their Waffle access level.  BBStevie
will also only let users mess with files in their home directory.

2. How can I use different local and remote editors ?

At 1.65, you can define different local and remote editors from
within Waffle, so it's simple.  The STATUS command does not let
you edit your local editor, however; you have to ADMIN T <you>.

Prior to 1.65, you should modify /waffle/extern/_editors to run
a batch file which gets passed the baud rate, and decides based
on that whether to run a local or remote editor.

3. Why does (insert editor here) work locally, but not remotely?

If you try BBStevie locally and it's fine, yet you get a blank
screen when you use it remotely, make sure that you do not have
an ansi driver loaded.  Some people have luck using PC Magazine's
ansi.com, which can be loaded and unloaded as part of a batch file
around your `waffle local username' command, so that there's no
ansi driver loaded by default for remote users.

Version 3.0 of BBStevie can use a FOSSIL driver to do its own 
modem i/o, so that you can use a local ANSI driver to handle 
local use and remote use will take care of itself.

4. How come STATUS / EDITOR still says there are no editors on the system,
    when I just added stuff to /waffle/extern/_edit?

You need to manually edit /waffle/menus/editors to reflect the
editors that are available on your system.  Make sure to include
that the user can select `none' to get back to the internal editor.


------------------------------

Subject: waffle: News
From: [e-mail]

1. Can I keep a copy of all posts ?

Yes, look in static.doc and the USENET file distributed
with Waffle for /spy=monitor.  basically just have
`DEFAULT /spy=monitor' at the top of your waffle/system/usenet
file, and you'll probably be ok (unless you drastically
changed your `forums' static file entry).

2. Can I gateway mail to news ?

Absolutely.  You need to set up an alias in `aliases' that
looks something like the following:

        newsgroup-name  | post newsgroup.name

To go the other way, add

        newsgroup.name /mod="submission-address-of-mailing-list".

For example, I have the Pink Floyd mailing list gatewayed on
hogbbs to mail.echoes .  I got the list maintainer to send
the mailint list to [e-mail], and have
the following entry in `aliases':

        echoes-list  | post mail.echoes

My definition for mail.echoes in my USENET file looks like:

        mail.echoes /name="The Pink Floyd Mailing List"
                    /mod=[e-mail]

(That should all be on one line; it was split for inclusion
in the FAQ.)

3. Does Waffle provided threaded newsreading ?

Not at this time.  See the section on Aftermarket add-ons
for info on external newsreaders which do provide threaded
newsreading.

4. Does Waffle support kill files ?

Not at this time.  Meanwhile, check the section on Aftermarket
add-ons, as above.

5. Why do I see multiple copies of the same article ?

Because Waffle has no `real-news'-like history mechanism
at this time.  Waffle considers an article to be a duplicate
only if the local site is already in the path.  Even then, it
gets it wrong (substrings match where they shouldn't).

If you get a newsfeed of the same newsgroup from several Waffle
sites into your DOS Waffle, expect to see lots of duplicates :-(

History mechanism is currently planned (rumored) for v1.66.  It