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
Next revisionBoth sides next revision
util:sexyz [2019/07/07 21:36] – [RZ/SZ Style] typo digital manutil:sexyz [2020/12/05 11:52] – [Command-line Syntax] Updated command-line usage digital man
Line 62: Line 62:
 usage: sexyz <socket> [-opts] <cmd> [file | path | @list] usage: sexyz <socket> [-opts] <cmd> [file | path | @list]
  
-socket = TCP socket descriptor (or leave blank for "stdio" mode on Unix)+socket = TCP socket descriptor (leave blank for stdio mode)
  
 opts   = -y  allow overwriting of existing files when receiving opts   = -y  allow overwriting of existing files when receiving
-         -o  disable ZMODEM CRC-32 mode (force CRC-16 mode instead) 
-         -s  disable ZMODEM streaming (Slow ZMODEM) 
          -k  enable X/YMODEM-1K send mode          -k  enable X/YMODEM-1K send mode
          -c  enable XMODEM-CRC receive mode          -c  enable XMODEM-CRC receive mode
          -g  enable X/YMODEM-G receive mode (no error recovery)          -g  enable X/YMODEM-G receive mode (no error recovery)
 +         -o  disable ZMODEM CRC-32 mode (use CRC-16)
 +         -s  use segmented ZMODEM (disable streaming)
          -2  set maximum ZMODEM block size to 2K          -2  set maximum ZMODEM block size to 2K
          -4  set maximum ZMODEM block size to 4K          -4  set maximum ZMODEM block size to 4K
          -8  set maximum ZMODEM block size to 8K (ZedZap)          -8  set maximum ZMODEM block size to 8K (ZedZap)
-         -m# set maximum receive file size to # bytes (0=unlimited, default=0)+         -w# set maximum ZMODEM transmit window size (default=0, unlimited) 
 +         -m# set maximum receive file size to # bytes (default=0, unlimited) 
 +         -l  lowercase received filenames
          -!  to pause after abnormal exit (error)          -!  to pause after abnormal exit (error)
-         -telnet to enable Telnet mode (the default) +         -telnet to enable Telnet mode (the default except in stdio mode) 
-         -rlogin to enable RLogin (pass-through) mode+         -rlogin or -ssh or -raw to disable Telnet mode
  
 cmd    = v  to display detailed version information cmd    = v  to display detailed version information
Line 108: Line 110:
  
  
-===== Installation =====+===== Install =====
  
  
-Copy ''sexyz[.exe]'' into your Synchronet ''[[dir:exec]]'' directory.+Copy ''sexyz[.exe]'' into your Synchronet ''[[dir:exec]]'' directory, if it's not already. Installation for other uses/systems likely just means copying the executable file somewhere that may be invoked from the application or server as needed.
  
  
-===== Configuration for Synchronet =====+===== Configure =====
  
-Synchronet v3.14++==== Synchronet ====
  
-SCFG:File Options->Transfer Protocols:+In Synchronet v3.14+ SCFG:File Options->Transfer Protocols:
  
 <code> <code>
 [File Transfer Protocol] [File Transfer Protocol]
  1: Mnemonic (Command Key)        X  1: Mnemonic (Command Key)        X
- 2: Protocol Name                 XMODEM (SEXYZ)+ 2: Protocol Name                 XMODEM-Original (SEXYZ) 
 + 3: Access Requirements            
 + 4: Upload Command Line           %!sexyz%. %h -%p rx %f 
 + 5: Download Command Line         %!sexyz%. %h -%p sx %f 
 + 6: Batch Upload Command Line 
 + 7: Batch Download Command Line 
 + 8: Bi-dir Command Line 
 + 9: Native (32-bit) Executable    Yes 
 +10: Supports DSZLOG               Yes 
 +11: Socket I/O                    Yes 
 + 
 +[File Transfer Protocol] 
 + 1: Mnemonic (Command Key)        1 
 + 2: Protocol Name                 XMODEM-1K/CRC (SEXYZ)
  3: Access Requirements             3: Access Requirements           
  4: Upload Command Line           %!sexyz%. %h -%p rC %f  4: Upload Command Line           %!sexyz%. %h -%p rC %f
Line 172: Line 187:
 10: Supports DSZLOG               Yes 10: Supports DSZLOG               Yes
 11: Socket I/O                    Yes 11: Socket I/O                    Yes
 +</code>
  
-Optional/Advanced:+=== Optional/Advanced ===
  
 +<code>
 [File Transfer Protocol] [File Transfer Protocol]
  1: Mnemonic (Command Key)        8  1: Mnemonic (Command Key)        8
Line 187: Line 204:
 10: Supports DSZLOG               Yes 10: Supports DSZLOG               Yes
 11: Socket I/O                    Yes 11: Socket I/O                    Yes
 +
 +[File Transfer Protocol]
 + 1: Mnemonic (Command Key)        S
 + 2: Protocol Name                 ZMODEM-Synchronous(SEXYZ)
 + 3: Access Requirements           
 + 4: Upload Command Line           %!sexyz%. %h -%p rz %f
 + 5: Download Command Line         %!sexyz%. %h -%p -s sz %f
 + 6: Batch Upload Command Line     %!sexyz%. %h -%p rz %g
 + 7: Batch Download Command Line   %!sexyz%. %h -%p -s sz @%f
 + 8: Bi-dir Command Line
 + 9: Native (32-bit) Executable    Yes
 +10: Supports DSZLOG               Yes
 +11: Socket I/O                    Yes
 +
 </code> </code>
 NOTE: It is suggested you remove existing FDSZ, CE-XYZ, or sz/rz transfer protocol entries as they are no longer needed. NOTE: It is suggested you remove existing FDSZ, CE-XYZ, or sz/rz transfer protocol entries as they are no longer needed.
 +
 +=== Synchronet for Unix ===
 +
 +Synchronet for Unix (prior to v3.14) did not support socket-based file
 +transfer protocols, so SEXYZ is only currently supported on Synchronet for
 +Unix (v3.13 and older) in "stdio" mode.
 +
 +You can use "stdio" mode in SEXYZ by removing '%h' (the socket descriptor)
 +from the above command-lines. If you're using Synchronet for Unix v3.14 or
 +later, socket I/O mode is preferred (do not use "stdio" mode).
  
  
-===== Configuration for Mystic =====+==== Mystic ====
  
 Example configuration for Mystic BBS v1.08-Win32 Example configuration for Mystic BBS v1.08-Win32
Line 212: Line 253:
 </code> </code>
  
-===== Configuration for EleBBS =====+==== EleBBS ====
  
 Example configuration for EleBBS-Win32 Example configuration for EleBBS-Win32
Line 245: Line 286:
 and set ''Quotes=true'' in the ''[DSZLOG]'' section of your ''sexyz.ini'' file or use and set ''Quotes=true'' in the ''[DSZLOG]'' section of your ''sexyz.ini'' file or use
 the secret ''-quotes'' command-line option. the secret ''-quotes'' command-line option.
- 
- 
-===== Synchronet for Unix ===== 
- 
-Synchronet for Unix (prior to v3.14) did not support socket-based file 
-transfer protocols, so SEXYZ is only currently supported on Synchronet for 
-Unix (v3.13 and older) in "stdio" mode. 
- 
-You can use "stdio" mode in SEXYZ by removing '%h' (the socket descriptor) 
-from the above command-lines. If you're using Synchronet for Unix v3.14 or 
-later, socket I/O mode is preferred (do not use "stdio" mode). 
  
 ===== Optional Initialization File (sexyz.ini) ===== ===== Optional Initialization File (sexyz.ini) =====
Line 271: Line 301:
  
 Example .ini file (with default values given): Example .ini file (with default values given):
-<file sexyz.ini>+<code ini>
 Telnet=TRUE                 ; set to FALSE to change the default mode Telnet=TRUE                 ; set to FALSE to change the default mode
 TCP_NoDelay=TRUE            ; disable the TCP Nagle algorithm TCP_NoDelay=TRUE            ; disable the TCP Nagle algorithm
Line 321: Line 351:
 Short=false         ; use Micros~1 short path/filename in log (Windows) Short=false         ; use Micros~1 short path/filename in log (Windows)
 Quotes=false        ; enclose filename in "quotes" (for EleBBS) Quotes=false        ; enclose filename in "quotes" (for EleBBS)
-</file>+</code> 
 + 
 +**Note:**\\ 
 +Older versions of SEXYZ did not support comments on some of the ''sexy.ini'' lines shown above.
  
 ===== Compatibility ===== ===== Compatibility =====

Trace: