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
Last revisionBoth sides next revision
howto:freq [2021/03/19 10:07] – better describe the zone hex extension all in one place wkitty42howto:freq [2021/03/19 10:24] – a little refinement 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 20: Line 20:
  
 <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 file. If 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.+NOTES: 
 +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. 
 + 
 +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 =====