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 revisionBoth sides next revision
service:finger [2010/02/22 16:42] – deuceservice:finger [2017/12/29 21:35] – Created digital man
Line 1: Line 1:
 ====== Finger Service ====== ====== Finger Service ======
  
-[[RFC>1288|RFC1288]] Implementation+This service (implemented in ''[[dir:exec]]/fingerservice.js'') supports the following protocols: 
 +  * [[wp>Finger]] over TCP ([[RFC>1288|RFC 1288]]) 
 +  * Finger over UDP (non-standard) 
 +  * Active Users (a.k.a. [[wp>SYSTAT (protocol)]]) over TCP and UDP ([[RFC>866|RFC 866]])
  
-TODO+**Note:** 
 +Active Users over UDP is required for inter-bbs [[module:sbbsimsg|Instant Message]] support. 
 + 
 +===== Configuration ===== 
 +Example configurations (in ''[[dir:ctrl]]/[[config:services.ini]]''): 
 + 
 +<file> 
 +[Finger] 
 +Port=79 
 +Options=NO_HOST_LOOKUP 
 +Command=fingerservice.js 
 +</file> 
 + 
 +<file> 
 +[Finger-UDP] 
 +Port=79 
 +Options=UDP | NO_HOST_LOOKUP 
 +Command=fingerservice.js 
 +</file> 
 + 
 +<file> 
 +[ActiveUser] 
 +Port=11 
 +Options=NO_HOST_LOOKUP 
 +Command=fingerservice.js -u 
 +</file> 
 + 
 +<file> 
 +[ActiveUser-UDP] 
 +Port=11 
 +Options=UDP | NO_HOST_LOOKUP 
 +Command=fingerservice.js -u 
 +</file> 
 + 
 + 
 +==== Command-line options ==== 
 + 
 +Add to the command lines shown above to change the behavior of the Finger service: 
 + 
 +^ Option ^ Description ^ 
 +| ''-n''  | Eliminate user age and gender information from the query results | 
 +| ''-a''  | Report aliases only (no real names) | 
 +| ''-ff'' | Enable the findfile feature (requires a "guest" account) |  
 +| ''-u''  | Report users currently online only (ignore any request), a.k.a. //Active Users// protocol | 
 + 
 +===== Plan Files =====  
 + 
 +Each BBS user may have their own finger-readable ''plan'' file stored as ''[[dir:data]]/user/####.plan'' where #### is the user's account number on the BBS. This file can be viewed, edited, or deleted on the BBS ([[server:Terminal]] Server) by using the ''PLAN'' string command (e.g. type the '';PLAN'' command, using most command shells). 
 + 
 +===== Special Requests ===== 
 + 
 +The normal Finger protocol usage is to request information on a specific user-ID/name (sent by the client). The Synchronet Finger Service (when **not** run in //Active Users// protocol mode), supports the following //Special Requests// as well: 
 + 
 +^ Request        ^ Description ^ 
 +| ''?ver''       | Synchronet version information | 
 +| ''?uptime''    | Current system up-time | 
 +| ''?time''      | Current system time | 
 +| ''?logon.lst'' | BBS Logon list | 
 +| ''?auto.msg''  | BBS auto-message | 
 +| ''?sockopts''  | Current socket options | 
 +| ''?stats''     | BBS Statistics | 
 +| ''?nodelist''  | BBS node list | 
 +| ''?services''  | Other TCP/IP Services enabled/running | 
 +| ''?findfile''  | Find a file (enabled with the ''-ff'' option) | 
 + 
 +==== Additional Special Requests ==== 
 + 
 +You can have additional files available for query via Finger //Special Request// by placing the files in the ''[[dir:data]]/finger'' directory. Such files may be request remotely with a request to finger ''?//filename//'', where //filename// is the name of the file to be sent. 

Trace: