From the UTillyty dokuwiki
This is an old revision of the document!
fileservity
Fileservity is a thin http file server, opensource and cross platform. With this program you can share files and folders accross the web in a drag and drop!
Download
last stable version:
1.0.0, 23 Oct 2009
You can get fileservity from http://sourceforge.net/projects/fileservity
Install
Download and extract the last release archive in your local system.
In the extracted folder you'll find
- the README text file
- the LICENCE text file
- the fileservity executable
Just double click fileservity to run.
Fileservity requires the latest Microsoft C runtime library (MSVCRT). This comes as part of the Windows system (authomatic) updates, or you can get it directly here:
Usage
Fileservity GUI consists of a triple splitted window, with filesystem tree-view on the left side, shares list-view and monitoring controls on the right side; those include a log viewer and a downloads list. Basic usage operations follow.
Share items
Drag and drop a node (file or directory) from the left tree to the right list, or select the node and then click the “Add” button/menu or type Ctrl++. To remove a shared item select it from the list and click the remove button/menu.
Start the service
The server will accept incoming requests to the port number in the textbox labeled “port” on the toolbar. You can put any port number between 1025 and 65535.
Click the start button/menu.
The server will try to find your public IP address and start
accepting incoming request.
You'll notice that the start buttons will be disabled and the
stop button enabled.
If something went wrong (the service is not publicly visible)
you'll be warned with a log message.
If an address (port) is already in use, try a different number.
After service is started all incoming requests will be served as applicable. You can monitor http traffic with the log and downloads views.
Let 'em know
Choose an IP from the middle-top combo and select a shared item in the right list: the address displayed in the top-right text box is the public URL! You can copy-paste it using the rightmost button.
Notice that most routers won't allow public IP addressing to LAN host.
To make a test with your local web browser you can put the “localhost” name or the 127.0.0.1 loopback IP.
On the client side
Users will consume your service via a browser.
To test what thay can see copy and paste the share URL
in your browser.
Notice that most routers won't allow public IP addressing to LAN host,
so remeber using your LAN address or the loopback ip
(127.0.0.1 or “localhost”).
Save your sharings
You can save the current share list with the save menu.
To open a previously saved list use the open menu.
The open button is disabled when the service is listening (started).
Licence
Copyright (C) 2009 Attilio Pavone <tilly@utillyty.eu> Fileservity is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. Fileservity is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You can find a copy of the GNU General Public License in the file LICENSE, or can see <http://www.gnu.org/licenses/>.
This software uses the following open source libraries:
- utillyty (http://www.utillyty.eu)
- FOX toolkit (http://www.fox-toolkit.org) version 1.6.35
- libpng (http://www.libpng.org) version 1.2.35
- zlib (http://www.zlib.net) version 1.2.3
Develope
You can get the last source distribution from the sourceforge project files page:
https://sourceforge.net/projects/fileservity/files/
or access the current developing sources via cvs:
cvs -d:pserver:anonymous@fileservity.cvs.sourceforge.net:/cvsroot/fileservity login
Fileservity is statically linked to utillyty.cpp:
cvs -d:pserver:anonymous@u-omnibus.cvs.sourceforge.net:/cvsroot/u-omnibus login
and FOX toolkit 1.6.35:
http://www.fox-toolkit.org/ftp/fox-1.6.36.zip (windows)
http://www.fox-toolkit.org/ftp/fox-1.6.36.tar.gz (linux)
To build FOX you also need libpng (http://www.libpng.org) version 1.2.35 and zlib (http://www.zlib.net) version 1.2.3.
In the source distribution you can find a Visual C++ and a Code::Blocks
project under the <build> directory.
Projects directory layout is:
+ .. + _opensource * fox-1.6.35 * libpng-1.2.35 * zlib-1.2.3 + UTillyty * fileservity * utillyty.cpp
Revision history
version 0.1.0 (beta-1), 16 Oct 2009
This is the first open beta version. Project has been alpha tested in Windows XP professional SP2 and Ubuntu 8.04. There are still some multithreading issues, but it's working ;).
version 1.0.0, 23 Oct 2009
- NEW: download restoring
added management for restoring interrupted downloads
- BUG: SIGPIPE
On linux there was an unhandled SIGPIPE signal when connection was closed remotely.
- BUG: root list
Files in the root (virtual) directory where listed as directories.
You are here: utillyty » docs » fileservity