"Fossies" - the Fresh Open Source Software Archive

Member "sfk-1.9.6/README" (22 Feb 2020, 8913 Bytes) of package /linux/misc/sfk-1.9.6.tar.gz:


As a special service "Fossies" has tried to format the requested text file into HTML format (style: standard) with prefixed line numbers. Alternatively you can here view or download the uninterpreted source code file.

    1 
    2 This is the Swiss File Knife (SFK), a command line multi function tool
    3 created by StahlWorks Technologies, http://stahlworks.com/
    4 
    5 SFK was made to make things easy.
    6 
    7 File exchange between machines, find duplicates, find and replace text,
    8 list directory tree sizes, and tons of other functions for daily tasks -
    9 it's all contained within a single, truely portable executable.
   10 
   11 Forget about installing dozens of tools on every new machine,
   12 battling with missing or wrong versioned DLL's, missing admin rights,
   13 missing package dependencies, user account configurations,
   14 spammed registries and endless time wasting in general.
   15 
   16 On every new Windows/Linux PC, Notebook, Workstation or Server,
   17 just download or copy the SFK binary and use it - INSTANTLY.
   18 
   19 How to get SFK up and running anywhere
   20 --------------------------------------
   21 
   22    Download the executables for Windows, Linux/lib6 or Linux/lib5
   23 
   24    By browser:
   25 
   26    -  http://stahlworks.com/sfk/
   27 
   28       then click on one of the top links to either download
   29       binaries instantly, or look further on sourceforge:
   30 
   31    -  http://sourceforge.net/projects/swissfileknife/
   32 
   33    OR
   34 
   35    On a Linux text console, use one of these:
   36 
   37       Instant binaries:
   38 
   39       -  wget http://stahlworks.com/sfkux             (Linux lib6)
   40       -  wget http://stahlworks.com/sfkuxold          (Linux lib5)
   41       -  wget http://stahlworks.com/sfkarm            (ARM Linux)
   42 
   43       Whole distribution package in a .zip (insert version for nnn):
   44 
   45       -  wget http://stahlworks.com/dev/sfk/sfknnn.zip
   46 
   47       Make sure your system has the real Info-ZIP unzip command,
   48       in version 5.50 or higher (just type "unzip" to find out).
   49       If nothing is available, get one of these:
   50 
   51       -  wget http://stahlworks.com/unzipux           (Linux lib6)
   52       -  wget http://stahlworks.com/unzipuxold        (Linux lib5)
   53 
   54    OR
   55 
   56    Apple Macintosh:
   57 
   58       The Mac binaries are available from:
   59 
   60       -  curl -o sfkmac http://stahlworks.com/sfkmac     (Intel i686)
   61       -  curl -o sfkmac http://stahlworks.com/sfkmacold  (PowerPC)
   62 
   63       Alternatively, a self compile under Mac is done by
   64       getting the sources as described below, then type
   65 
   66          g++ -DMAC_OS_X sfk.cpp sfkext.cpp sfkpack.cpp -o sfk
   67 
   68    OR
   69 
   70    64-bit Linux in general:
   71 
   72    -  there are no binary distributions so far, but you may compile
   73       the source code easily, even if you're no software developer.
   74 
   75       first, type "g++" to find out if a compiler exists on your system.
   76       if so, download the source code, contained in the sfknnn.zip, from
   77 
   78       http://sourceforge.net/projects/swissfileknife/
   79 
   80       then extract that by "unzip sfknnn.zip",
   81       and take a look into do-compile-unix.bat or type:
   82 
   83          Linux 64-bit compile:
   84 
   85             g++ sfk.cpp sfkext.cpp sfkpack.cpp -o sfk
   86 
   87    OR
   88 
   89    -  working on a machine without internet access, network folders,
   90       non-functioning USB ports, missing admin rights, and a thousand
   91       other reasons why you cannot copy a single file?
   92 
   93       if the machine has ANY connection to a local network, try this:
   94 
   95       SFK Instant HTTP Server for easy file exchange
   96 
   97          -  on another machine where you have SFK already, type
   98    
   99             sfk httpserv -port=9090
  100    
  101          -  then, on the target machine, try to open a web browser
  102             and to access
  103    
  104                http://othermachine:9090/
  105    
  106             OR type
  107    
  108                wget http://othermachine:9090/sfknnn.zip
  109    
  110             provided that you have the SFK distribution zip file 
  111             located in the directory where you typed "sfk httpserv"
  112 
  113       If that fails (no browser, no gui, no wget command),
  114       check if there exists an "ftp" command on the target.
  115       If so, try:
  116 
  117       SFK Instant FTP Server for easy file exchange
  118 
  119          -  on another machine where you have SFK already, type
  120    
  121             sfk ftpserv
  122    
  123          -  then, on the target machine, type
  124    
  125                ftp othermachine
  126 
  127             and if the login succeeds, try
  128 
  129                dir
  130                bin
  131                get sfknnn.zip
  132 
  133             provided that you have the SFK distribution zip file 
  134             located in the directory where you typed "sfk ftpserv".
  135             Of course you may also try
  136 
  137                get sfkux
  138                get sfkuxold
  139                get sfk-linux.exe       (sfkux in the zip package)
  140                get sfk-linux-lib5.exe  (sfkuxold in the zip package)
  141 
  142             if your target machine is a linux system.
  143 
  144          -  if ftp connections fail to work, check if the "ftp"
  145             client on the target accepts the command
  146 
  147                passive
  148 
  149             then try to "get" again (ftp creates a new connection
  150             per file download, which is often blocked by firewalls.
  151             the passive command changes the way in which those
  152             connections are created.)
  153 
  154 
  155 How to prepare the SFK binary under Linux:
  156 
  157    -  after download, you have to type
  158 
  159          mv sfkux sfk
  160          chmod +x sfk
  161 
  162       to enable execution (the 'x' flag) of sfk.
  163       Then simply type
  164 
  165          ./sfk
  166 
  167       to get it running (the "./" is often needed as
  168       the PATH may not contain the current directory ".").               
  169 
  170 Where to place the SFK executable:
  171 
  172    Recommendation for Windows:
  173 
  174       -  create a directory structure
  175 
  176             c:\app\bin
  177 
  178          then rename sfknnn.exe to sfk.exe, and copy that to c:\app\bin .
  179 
  180          If you use the "sfk alias" command later, the created alias
  181          batch files will also be placed into "c:\app\bin".
  182 
  183       -  extend the Windows Shell Path
  184 
  185             set PATH=%PATH%;c:\app\bin
  186 
  187       -  make sure your Windows Shell supports command autocompletion
  188          and Copy/Paste of text (the QuickEdit and Insert setting),
  189          otherwise it is very hard to use! read more by typing
  190 
  191             sfk help shell
  192 
  193       -  further tools can be installed parallel to "bin" into c:\app
  194 
  195       This way you avoid the long, blank-character-contaminated,
  196       inefficient default paths like "C:\Program Files".
  197 
  198    Recommendation for Linux:
  199 
  200       -  type "cd" then "pwd" to find out what your account's
  201          home directory is.
  202 
  203       -  within your home directory (e.g. /home/users/youruserid/)
  204          create a directory "tools"
  205 
  206             mkdir tools
  207 
  208          then rename sfk-linux.exe to sfk, and copy that
  209          into the tools dir.
  210 
  211       -  extend the PATH like
  212 
  213             export PATH=$PATH:/home/users/youruserid/tools
  214 
  215       -  then you should be able to run sfk by typing "sfk".
  216 
  217       By default, there are no colors, as it is not possible
  218       to autodetect the background color under Linux.
  219 
  220       If you like colorful output, type "sfk help color"
  221       and read on how to set the "SFK_COLORS" variable
  222       (read it careful! if you set a wrong "def:" value,
  223        you may end up with white text on white background)
  224 
  225 
  226 License:
  227 ========
  228 
  229    -  Swiss File Knife Base is provided completely for free,
  230       and can be used unlimited, without any warranty.
  231 
  232    -  the source code provided in the sfknnn.zip download packages
  233       is provided under BSD license, and therefore free for unlimited
  234       use also in commercial projects, without any warranty.
  235 
  236    Read the file bsd-license.txt for details.
  237 
  238 
  239 See also:
  240 =========
  241 
  242    -  Swiss File Knife Extended Edition (XE) is the commercial version
  243       of SFK, allowing direct reading of (nested) .zip, .tar.gz and
  244       .tar.bz2 file contents, and high performance replace of patterns
  245       in text and binary files. Read more under:
  246 
  247          http://stahlworks.com/sfkxe.html
  248 
  249    -  The whole SFK source code and documentation was created with
  250       Depeche View, the world's fastest text file browser and editor. 
  251       A free demo is available under:
  252 
  253          http://stahlworks.com/depeche-view.html
  254 
  255    -  The whole SFK documentation is available as the paperback book
  256       "100 Command Line Tools" on Amazon
  257 
  258    -  The whole SFK documentation is available as an e-book,
  259       optimized for reading on mobile devices.
  260       For details see www.stahlworks.com
  261 
  262 
  263 The SFKTray GUI Status Display
  264 ==============================
  265 
  266    is a small Windows tool installed by sfktray-set-up.exe.
  267    the Freeware edition displays four independent status lights
  268    in the system tray which can be controlled by the sfk status 
  269    command like:
  270 
  271       sfk status local "v1 slot=1 color=green text='service ok'"
  272 
  273    type "sfk status" for the full syntax.
  274    a status can be sent from the local or a remote machine by UDP.
  275    the full edition with 9 status lights is available from:
  276    
  277       http://stahlworks.com/sfktray
  278