FXP.One: Difference between revisions

Latest revision as of 08:01, 28 March 2018

There are further settings that will modify FXP.One's engine behavior which are not part of the definition of a site. Since we are allowed to define any variable name, which is automatically stored, some extra definitions have been created.

Since essentially Extra Site and Client Site commands are the same thing, they are separated because Extra Site lists additional commands which the FXP.One engine will act on. Where as Client Site commands are stored by clients, for clients. The FXP.One engine does not parse these key/value pairs.

USE_XDUPE
STARTDIR
FXP_TLS
IMPLICIT_TLS
LISTARGS
FEAT_CCSN
FEAT_SSCN
FEAT_PRET

Details

 USE_XDUPE=<yna>
 * Auto - If XDUPE is reported in the FEAT reply code, it will be enabled and used.
 * Yes  - Forced on, regardless of FEAT reply.
 * No   - Forced off, regardless of FEAT reply.

 STARTDIR=<str>
 * Optional extra for clients to issue CWD to <str> upon connection, instead of staying in default root "/".

 FXP_TLS=<yna>
 * Auto - Use secure (SSL) data transfers if possible, otherwise plain-text, using CCSN or SSCN.
 * Yes  - Always attempt secure (SSL) data transfers, fail if not possible.
 * No   - Do not attempt secure data transfers, always use plain-text.

The FXP_TLS option is added in addition to data_TLS as it was deemed insufficient for those who would like to force directory listings to use secure methods, but disable secure data transfers, even if sites supported such transfers. If FXP_TLS is not defined, FXP.One engine will use the default behavior as specified by data_TLS.

 IMPLICIT_TLS=<yna>
 * Auto - Do not use Implicit SSL/TLS 
 * No   - Do not use Implicit SSL/TLS
 * Yes  - Attempt implicit SSL challenge immediately upon connecting, before FTP commands.

 LISTARGS=<str>
 * Usually, FXP.Ones uses default LIST arguments ("-lL") but you can over-ride that per site by setting LISTARGS.
 * For example, LISTARGS=-sl, or even "LISTARGS= " for no arguments.

FEAT_CCSN=<str>
FEAT_SSCN=<str>
FEAT_PRET=<str>
* Allow to override the value received in reply to CCSN, SSCN, and PRET.
* If a site replies it supports SSCN, but its FTPD is faulty, you can set
* FEAT_SSCN=n to tell FXP.Oned to ignore it.

Future

 MAX_SESSIONS=<int>
 * Limit number of sessions allowed for one site. Attempts to create another session will be presented with an error.

 MAX_QUEUES=<int>
 * Limit the number of active queues a site is allowed to be involved with. When GO commands are received
 * check the total active queues, and if already over the limit, leave queue in IDLE state. Automatically start queue
 * once an active queue goes to IDLE.

@@ Line 1: / Line 1: @@
-[[Image:synology_logo.gif|Synoogy Inc. logo]] <br>
+There are further settings that will modify '''FXP.One''''s engine behavior which are not part of the definition of a site. Since we are allowed to define any variable name, which is automatically stored, some extra definitions have been created.
-<p>The Synology NAS can host the [[llink]] media streaming server. If you don't compile it yourself, please note below which binary you should use for your model. The binary packages are not made to be integrated with the admin web interface.</p>
+Since essentially '''Extra Site''' and '''Client Site''' commands are the same thing, they are separated because [[Extra Site]] lists additional commands which the '''FXP.One''' engine will act on. Where as [[Client Site]] commands are stored by clients, for clients. The '''FXP.One''' engine does not parse these key/value pairs.
+* USE_XDUPE
+* STARTDIR
+* FXP_TLS
+* IMPLICIT_TLS
+* LISTARGS
+* FEAT_CCSN
+* FEAT_SSCN
+* FEAT_PRET
-=== Binaries ===
-'''Latest binaries'''<br>
+==Details==
-This contains a [[Llink:synology_autostart|startup script]], a Synology installation guide ([[Llink:synology_readme|README-Synology.txt]]) and a prepared llink.conf that points to the Synology default /volume1/video share. Place this binary in the /volume1 directory, untar and open the <code>README-synology.txt</code> file with a text editor for further assistance. Note: the startup script and the installation guide was written for the synology_x06_ppc in mind.
-[http://forum.synology.com/wiki/index.php/Is_my_NAS_an_ARM_or_a_PowerPC_CPU_model] Is_my_NAS_an_ARM_or_a_PowerPC_CPU_model
+  USE_XDUPE=<yna>
+  * Auto - If XDUPE is reported in the FEAT reply code, it will be enabled and used.
+  * Yes  - Forced on, regardless of FEAT reply.
+  * No   - Forced off, regardless of FEAT reply.
-The following models uses ''x06_ppc'' version per default: (PowerPC ppc_6xx Freescale MPC8245 603e core MPC8241 603e core)
+  STARTDIR=<str>
- DS-101g+, DS-106j, DS-106e, DS-106, DS-106x , CS-406, RS-406 and CS-406e
+  * Optional extra for clients to issue '''CWD''' to <str> upon connection, instead of staying in default root "/".
-The following x07-models share the same cpu family as x06 and should also use the ''x06_ppc''-version of llink:
+  FXP_TLS=<yna>
-  DS-107e, DS-107, DS-207, DS-207.128 and CS-407e
+  * Auto - Use secure (SSL) data transfers if possible, otherwise plain-text, using CCSN or SSCN.
+  * Yes  - Always attempt secure (SSL) data transfers, fail if not possible.
+  * No   - Do not attempt secure data transfers, always use plain-text.
-Optware feed: http://ipkg.nslu2-linux.org/feeds/optware/ds101g/cross/unstable/
+The '''FXP_TLS''' option is added in addition to '''data_TLS''' as it was deemed insufficient for those who would like to force directory listings to use secure methods, but disable secure data transfers, even if sites supported such transfers. If '''FXP_TLS''' is not defined, '''FXP.One''' engine will use the default behavior as specified by '''data_TLS'''.
+  IMPLICIT_TLS=<yna>
+  * Auto - Do not use Implicit SSL/TLS
+  * No   - Do not use Implicit SSL/TLS
+  * Yes  - Attempt implicit SSL challenge immediately upon connecting, before FTP commands.
-The following models should use the ''x07_arm'': (ARM armv5tejl Marvell Orion 88F5281)
- DS-107+, DS-107+.128, DS-207+, CS-407 and RS-407
-Optware feed: http://ipkg.nslu2-linux.org/feeds/optware/syno-x07/cross/unstable/
+  LISTARGS=<str>
+  * Usually, FXP.Ones uses default LIST arguments ("-lL") but you can over-ride that per site by setting LISTARGS.
+  * For example, LISTARGS=-sl, or even "LISTARGS= " for no arguments.
+ FEAT_CCSN=<str>
+ FEAT_SSCN=<str>
+ FEAT_PRET=<str>
+ * Allow to override the value received in reply to CCSN, SSCN, and PRET.
+ * If a site replies it supports SSCN, but its FTPD is faulty, you can set
+ * FEAT_SSCN=n to tell FXP.Oned to ignore it.
-The following models should use the ''e500_ppc'': (PowerPC ppc_85xx Freescale MPC8543 e500v2 core)
- DS-508	RS-408	DS-408	DS-209+
+=== Future ===
-The following models should use the '''x10_arm''':
+  MAX_SESSIONS=<int>
- DS210j DS410j DS110j
+  * Limit number of sessions allowed for one site. Attempts to create another session will be presented with an error.
-The following models should use the '''D510_x86''':
+  MAX_QUEUES=<int>
-+
+  * Limit the number of '''active queues''' a site is allowed to be involved with. When '''GO''' commands are received
+  * check the total active queues, and if already over the limit, leave queue in IDLE state. Automatically start queue
+  * once an active queue goes to IDLE.
-'''Download binary'''
- [http://www.lundman.net/ftp/llink/llink-2.3.2-synology_x10_arm.tar.gz llink-2.3.2-synology_x10_arm.tar.gz] (libdvdnav,ClinkC) for x10 models
- [http://www.lundman.net/ftp/llink/llink-2.3.2-synology_D510_x86.tar.gz llink-2.3.2-synology_D510_x86.tar.gz] (clinkc) 2011-12-27
- [[Media:Llink-2.2.4-synology_x06_ppc.tar.gz|llink-2.2.4-synology_x06_ppc.tar.gz]] build 1756 (Thu Jul 29 11:50:38 2010) (libdvdnav), added 2010-12-06
- [http://www.lundman.net/ftp/llink/llink-2.3.2-synology_x07_arm.tar.gz llink-2.3.2-synology_x07_arm.tar.gz]  (libdvdnav,ClinkC) for x07 ARM
- [http://www.lundman.net/ftp/llink/llink-2.2.2-synology_e500_ppc.tar.gz llink-2.2.2-synology_e500_ppc.tar.gz] build 1609 (libdvdnav) for x09 models
-'''Older binaries'''
- [http://www.lundman.net/ftp/llink/llink-2.2.3-synology_x10_arm.tar.gz llink-2.2.3-synology_x10_arm.tar.gz] build 1609 (libdvdnav) for x10 models
- [http://www.lundman.net/ftp/llink/llink-2.2.4-synology_x10_arm.tar.gz llink-2.2.4-synology_x10_arm.tar.gz] build 1609 (libdvdnav) for x10 models
- [[Media:Llink-2.2.0-synology_x06_ppc.tar.gz|llink-2.2.0-synology_x06_ppc.tar.gz]] build 1305 (Mon Oct 27 12:30:29 2008) (libdvdnav), added 2008-11-02
- [http://www.lundman.net/ftp/llink/llink-2.2.0-synology_e500_ppc.tar.gz llink-2.2.0-synology_e500_ppc.tar.gz] build 1305 (libdvdnav)
- [[Media:Llink-2.1.1-synology_x07_arm.tar.gz|llink-2.1.1-synology_x07_arm.tar.gz]] build 1000 (Tue Aug 12 11:09:44 2008) (libdvdread), added 2008-08-08
- [[Media:Llink-2.1.2-synology_x06_ppc.tar.gz|llink-2.1.2-synology_x06_ppc.tar.gz]] build 1103 (Fri Aug 29 20:51:03 2008) (libdvdnav), added 2008-09-01
- [[Media:Llink-2.1.1-synology_x06_ppc.tar.gz|llink-2.1.1-synology_x06_ppc.tar.gz]] build 1000 (Tue Aug 12 11:09:44 2008) (libdvdread), added 2008-08-08
- [[Media:Llink-2.1.0-synology_x06_ppc.tar.gz|llink-2.1.0-synology_x06_ppc.tar.gz]] build 961 (Fri Aug  8 11:09:44 2008) (libdvdread), added 2008-08-08
- [[Media:Llink-2.1.0-synology_x07_arm.tar.gz|llink-2.1.0-synology_x07_arm.tar.gz]] build 961 (Fri Aug  8 11:09:44 2008) (libdvdread), added 2008-08-08
- [http://www.lundman.net/ftp/llink/llink-2.0.6-synology_x07_arm.tar.gz llink-2.0.6-synology_x07_arm.tar.gz] build 750 (Fri May 21 16:17:40 2008), added 2008-05-21
- [http://www.lundman.net/wiki/images/1/1f/Llink-2.0.8-synology_x06_ppc.tar.gz llink-2.0.8-synology_x06_ppc.tar.gz‎]] build 904 (Fri Jun 20 12:40:12 2008) (libdvdread), added 2008-06-20
- [[Media:Llink-2.0.7-synology_x06_ppc.tar.gz|llink-2.0.7-synology_x06_ppc.tar.gz]] build 830 (Mon Jun  2 11:09:44 2008) (libdvdread), added 2008-06-06
- [[Media:Llink-2.0.6-syno_x06.tar.gz|llink-2.0.6-syno_x06.tar.gz]] build 750 (Fri May 16 16:17:45 2008), added 2008-05-17
- [[Media:Llink-2.0.4-syno_x06.tar.gz|llink-2.0.4-syno_x06.tar.gz]] build 709 (Mon Apr 21 10:06:04 2008), added 2008-04-24
- [[Media:Llink-2.0.3-syno_x06.tar.gz|llink-2.0.3-syno_x06.tar.gz]] build 709 added 2008-04-21
- [[Media:Llink-2.0.2-syno_x06.tar.gz|llink-2.0.2-syno_x06.tar.gz]]
- [http://www.lundman.net/ftp/llink/llink-1.9.2-synology.tar.gz llink-1.9.2-synology.tar.gz]
-Once you've installed the binary you have to update the llink.conf file so it points to your media files, uses the right port etc.
-=== Installation pre-requisites ===
-Telnet/SSH-patch installed on the NAS.
-If you want to autostart llink from boot, you can use this [[Llink:synology_autostart|script]].<br>
-Otherwise you must enter via telnet and start manually after shutdown or restart.
-If you have ''Optware'' enabled you can use the appropriate feed to automagically download and install llink, from version 2.0.9. See feed links above.
-=== Toolchains ===
-==== x06 ====
-For the synology_x06 compiles, the toolchain for the DS1010g has been used successfully, found  at [http://www.nslu2-linux.org/wiki/DS101/HomePage NSLU2-linux.org].
-==== x07 ====
-If you use a Synology NAS from the x07-series there is a toolchain available for compiling source at [http://www.synology.com/wiki/index.php/Mods_for_Marvell_mv5281_ARM-based_Synology_Products#Toolchain Synology.com]
-Unfortunately, this toolchain is missing the Linux headers required. asm->asm-arm, linux and asm-generic. One way to solve this is go download Linux-2.6.15 linux kernel. (There is one on NMT forum, probably one in my ftp somewhere - anyway, it is GPL and available everywhere).
-Issue the following commands:
- # sudo bash
- # cd /usr/local/arm-marvell-linux-gnu/arm-marvell-linux-gnu/include/
- # rsync -arv $YOUR_PATH/linux-2.6.15/include/asm-arm/ asm/
- # rsync -arv $YOUR_PATH/linux-2.6.15/include/asm-generic/ asm-generic/
- # rsync -arv $YOUR_PATH/linux-2.6.15/include/linux/ linux/
-==== e500 ====
-[http://sourceforge.net/project/downloading.php?group_id=238526&filename=gcc343_glibc234_854x.tar.gz&a=89364623 e500 gcc for toolchain]]
-==== x10 ====
-DS410j etc. Toolchain here: [http://downloads.sourceforge.net/project/dsgpl/Tool%20Chain/Marvell%2088F6281%20Linux%202.6.24/gcc421_glibc25_88f6281.tar.gz?use_mirror=jaist]
-=== Additional resources and references ===
-NSLU2-Linux.org [http://www.nslu2-linux.org/wiki/Optware/Packages?from=Unslung.Packages]<br>
-flipflip's Diskstation site [http://oinkzwurgl.org/diskstation]<br>
-Synology's official forum [http://www.synology.com/enu/forum/]