Synchronet v3.19b-Win32 (install) has been released (Jan-2022).

You can donate to the Synchronet project using PayPal.

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
howto:freq [2021/03/19 10:07] – better describe the zone hex extension all in one place wkitty42howto:freq [2021/03/19 10:26] (current) – footnotes instead of notes wkitty42
Line 5: Line 5:
 This page describes how to create a FTN style FREQ (FileREQ) and send it to a destination system. There are at least two methods this can be done with. Currently we will describe only one of those methods. This page describes how to create a FTN style FREQ (FileREQ) and send it to a destination system. There are at least two methods this can be done with. Currently we will describe only one of those methods.
  
-The first step is to create a .req file. This file contains the filenames of the files you are requesting, one filename per line.+The first step is to create a .req (REQuest) file. This file contains the filenames of the files you are requesting, one filename per line.
  
 eg:<code>echo filenameiwant.foo >> /sbbs/tmp/myfreq.req eg:<code>echo filenameiwant.foo >> /sbbs/tmp/myfreq.req
 echo anotherfile.bar >> /sbbs/tmp/myfreq.req</code> echo anotherfile.bar >> /sbbs/tmp/myfreq.req</code>
  
-Now that we have the filenames in a .req file, we want to send it to a destination system. One way this is done is to add myfreq.req to a .FLO file. This requires some understanding of how BSO (Binkley Style Outbound) works so we can determine the proper FLO file name of the destination system. Basically, the zone is determined by the outbound directory in your BSO tree. The outbound directory for your default zone has no extension. The extensions on your other outbound directories are zero padded to three HEX characters. The net and node of the destination are zero-padded HEX to four places.+Now that we have the filenames in a .req file, we want to send it to a destination system. One way this is done is to add myfreq.req to a .FLO file. This requires some understanding of how BSO (Binkley Style Outbound) works so we can determine the proper FLO file name of the destination system. Basically, the zone is determined by the outbound directory in your BSO tree. The outbound directory for your default zone has no extension. The extensions on your other outbound directories are zero-padded HEX to three places. The net and node of the destination are zero-padded HEX to four places.
  
 eg: 1:3634/12 breaks down like this. eg: 1:3634/12 breaks down like this.
Line 17: Line 17:
 the node 12  : 000c</code> the node 12  : 000c</code>
  
-So we would create or update a file named 0e32000c.flo in our outbound directory for fidonet zone 1. Inside this file we would list myfreq.req. If our default zone is zone 1 and our BSO is outbound, then we would create or update the file like so.+So we would create or update a file named 0e32000c.flo in our outbound directory for fidonet zone 1. Inside this file we would list myfreq.req. If our default zone is zone 1 and our BSO is outbound, then we would create or update the file like so. ((The '^' (caret) tells your BSO mailer to delete the req file after it has been sent. More details about FLO file formatting are available in the original Binkleyterm Mailer documentation.)) ((We used the ">>" method of redirection to add the echoed data to the files. This is so we do not destroy what may already be in them.))
  
 <code>echo ^/sbbs/tmp/myfreq.req >> /sbbs/ftn/outbound/0e32000c.flo</code> <code>echo ^/sbbs/tmp/myfreq.req >> /sbbs/ftn/outbound/0e32000c.flo</code>
- 
-The '^' (caret) tells your BSO mailer to delete the req file after it has been sent. 
  
 If our default zone is not zone fidonet zone 1, then the outbound directory will be outbound.001 and we'd create our flo file there. If our default zone is not zone fidonet zone 1, then the outbound directory will be outbound.001 and we'd create our flo file there.
Line 27: Line 25:
 <code>echo ^/sbbs/tmp/myfreq.req >> /sbbs/ftn/outbound.001/0e32000c.flo</code> <code>echo ^/sbbs/tmp/myfreq.req >> /sbbs/ftn/outbound.001/0e32000c.flo</code>
  
-When your BSO mailer scans its outbound directories and sees the file 0e32000c.flo, it will attempt to connect to 1:3634/12 and deliver the myfreq.req fileIf 1:3634/12 has FREQ enabled, it will read the filenames from the .req file and queue them to send back to you during the current connection.+Let's say we want to send a FREQ to a system in Micronet. Micronet is zone 618. In HEX that is 26a so the outbound would be outbound.26aSo, a request to 618:3634/12 would look like this.
  
-If the destination system is in another zone, then the outbound directory for that zone has an extension like we show above where outbound.001 is the outbound for zone 1 if you are not in zone 1. Let's say we want to send a FREQ to a system in Micronet. Micronet is zone 618. In HEX that is 26a and since the extensions in BSO are limited to three charcters, the outbound would be outbound.26a.+<code>echo ^/sbbs/tmp/myfreq.req >> /sbbs/ftn/outbound.26a/0e32000c.flo</code>
  
-Soa request to 618:3634/12 would look like this. +When your BSO mailer scans its outbound directories and sees the file 0e32000c.floit will attempt to connect to 1:3634/12 and deliver the myfreq.req fileIf 1:3634/12 has FREQ enabled, it will read the filenames from the .req file, and queue those files to send back to you during the current connection.
- +
-<code>echo ^/sbbs/tmp/myfreq.req >> /sbbs/ftn/outbound.26a/0e32000c.flo</code>+
  
-NOTE: In the above you will note that we used the ">>" method of redirection to add the echoed data to the files. This is so we do not destroy what may already be in them. 
  
 ===== See Also ===== ===== See Also =====