From e814174d7b99db450da8eaa64db2f04400fa803c Mon Sep 17 00:00:00 2001 From: Sergiusz 'q3k' Bazanski Date: Wed, 14 Nov 2012 12:53:40 +0100 Subject: [PATCH] Get rid of stupid shit. --- COPYING | 21 - ChangeLog | 273 ---------- MANIFEST.in | 3 - Makefile | 16 - README | 106 ---- doc/Makefile | 94 ---- doc/conf.py | 194 ------- doc/index.rst | 114 ---- doc/rfc1350.txt | 551 ------------------- doc/rfc2347.txt | 395 -------------- doc/rfc2348.txt | 283 ---------- doc/rfc2349.txt | 283 ---------- html/index.html | 150 ----- html/main.css | 31 -- html/sphinx/_sources/index.txt | 114 ---- html/sphinx/_static/basic.css | 528 ------------------ html/sphinx/_static/default.css | 256 --------- html/sphinx/_static/doctools.js | 247 --------- html/sphinx/_static/file.png | Bin 392 -> 0 bytes html/sphinx/_static/jquery.js | 154 ------ html/sphinx/_static/minus.png | Bin 199 -> 0 bytes html/sphinx/_static/plus.png | Bin 199 -> 0 bytes html/sphinx/_static/pygments.css | 62 --- html/sphinx/_static/searchtools.js | 518 ------------------ html/sphinx/_static/sidebar.js | 148 ----- html/sphinx/_static/underscore.js | 16 - html/sphinx/genindex.html | 282 ---------- html/sphinx/index.html | 841 ----------------------------- html/sphinx/objects.inv | Bin 866 -> 0 bytes html/sphinx/py-modindex.html | 143 ----- html/sphinx/search.html | 102 ---- html/sphinx/searchindex.js | 1 - lib/tftpy_twisted.py | 17 - notes/sfshell.txt | 12 - rpm/python-tftpy.spec | 52 -- setup.py | 22 - t/100KBFILE | Bin 102400 -> 0 bytes t/foo/100KBFILE | Bin 102400 -> 0 bytes t/test.py | 338 ------------ 39 files changed, 6367 deletions(-) delete mode 100644 COPYING delete mode 100644 ChangeLog delete mode 100644 MANIFEST.in delete mode 100644 Makefile delete mode 100644 README delete mode 100644 doc/Makefile delete mode 100644 doc/conf.py delete mode 100644 doc/index.rst delete mode 100644 doc/rfc1350.txt delete mode 100644 doc/rfc2347.txt delete mode 100644 doc/rfc2348.txt delete mode 100644 doc/rfc2349.txt delete mode 100644 html/index.html delete mode 100644 html/main.css delete mode 100644 html/sphinx/_sources/index.txt delete mode 100644 html/sphinx/_static/basic.css delete mode 100644 html/sphinx/_static/default.css delete mode 100644 html/sphinx/_static/doctools.js delete mode 100644 html/sphinx/_static/file.png delete mode 100644 html/sphinx/_static/jquery.js delete mode 100644 html/sphinx/_static/minus.png delete mode 100644 html/sphinx/_static/plus.png delete mode 100644 html/sphinx/_static/pygments.css delete mode 100644 html/sphinx/_static/searchtools.js delete mode 100644 html/sphinx/_static/sidebar.js delete mode 100644 html/sphinx/_static/underscore.js delete mode 100644 html/sphinx/genindex.html delete mode 100644 html/sphinx/index.html delete mode 100644 html/sphinx/objects.inv delete mode 100644 html/sphinx/py-modindex.html delete mode 100644 html/sphinx/search.html delete mode 100644 html/sphinx/searchindex.js delete mode 100755 lib/tftpy_twisted.py delete mode 100644 notes/sfshell.txt delete mode 100644 rpm/python-tftpy.spec delete mode 100644 setup.py delete mode 100644 t/100KBFILE delete mode 100644 t/foo/100KBFILE delete mode 100644 t/test.py diff --git a/COPYING b/COPYING deleted file mode 100644 index c9f2c9c..0000000 --- a/COPYING +++ /dev/null @@ -1,21 +0,0 @@ -The MIT License - -Copyright (c) 2009 Michael P. Soulier - -Permission is hereby granted, free of charge, to any person obtaining a copy -of this software and associated documentation files (the "Software"), to deal -in the Software without restriction, including without limitation the rights -to use, copy, modify, merge, publish, distribute, sublicense, and/or sell -copies of the Software, and to permit persons to whom the Software is -furnished to do so, subject to the following conditions: - -The above copyright notice and this permission notice shall be included in -all copies or substantial portions of the Software. - -THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR -IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, -FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE -AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER -LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, -OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN -THE SOFTWARE. diff --git a/ChangeLog b/ChangeLog deleted file mode 100644 index 4e63f7d..0000000 --- a/ChangeLog +++ /dev/null @@ -1,273 +0,0 @@ - -2011-07-24 Michael P. Soulier - 04aaa2e: Fixing issue #3, expanding unit tests. - -2011-07-23 Michael P. Soulier - 40977c6: Fixing some pyflakes complaints - add4440: Fixes issue #23, breaking up TftpStates into TftpStates and TftpContexts. - 949c998: Fixing issue #9, removing blksize option from client if not supplied. - a43773e: Fixing issue #16 on github, server failing to use timeout time in checkTimeout() method. - 1e74abf: Adding retries on timeouts, still have to exhaustively test. Should close issue #21 on github. - -2011-06-02 Michael P. Soulier - 6fd9391: Fixing a file descriptor leak. Closes issue 22. - f6442eb: Adding a server download state test to the unit tests. - -2010-10-18 Kenny Millington - a6cff4f: Fix exceptions propagating out of TftpServer.listen() - 71d827d: Allow dyn_file_func to trigger a FileNotFound error. - -2010-10-13 Michael P. Soulier - 4396124: Forcing decode mode to lower case, fixes bug 17. - -2010-07-20 Michael P. Soulier - 45185ed: Fixing setNextBlock to roll over at 2**16 - 1 instead of 2**16, which was causing problems when uploading large files. - -2010-07-14 Michael P. Soulier - e1b1be2: Updating README for 0.5.1 - 4f61f7f: Updated changelog for 0.5.1. - e35cd2d: Added simple doc examples and install info. - -2010-07-12 Michael P. Soulier - 74f6756: Playing with sphinx formatting - -2010-07-11 Michael P. Soulier - 1caa220: Latest doc updates - ad94976: Replacing epydoc output on website. - 402b2ae: Adding initial Sphinx docs - -2010-05-25 Michael P. Soulier - 0b54068: Fixing typo in unit test - 58623df: Adding support for input/output as stdin/stdout - -2010-05-24 Michael P. Soulier - f4a3ff6: Fixing failure to set default blocksize if options were provided but blksize was not one of them. - -2010-05-12 Patrick Oppenlander - 1a2b556: fix incorrectly assigned state transition - 360b0b9: fix divide by zero in speed calculation for short transfers - -2010-05-10 Michael P. Soulier - 3c40546: Updated site html formatting - 9ed42a8: Website update - 5f0e405: Updating notes - d4c15e1: Fixing the license in the setup.py - 2f0c0db: Updated website - becb299: Updating metadata for 0.5.0 release - faebd44: Fixing buffering issue in upload. Uploads work now. - a071549: Updated README - 2bb8326: First working upload with new state machine. Not usable yet, upload fails to always send all data for some reason. - 4a4f53a: Fixed an obvious error introduced with the dyn_file_func merge - -2010-04-24 Michael P. Soulier - 8a56d94: Merge commit 'angry-elf/master' into merge - -2010-02-18 Michael P. Soulier - 8343ccf: Taking patch from "Mike C. Fletcher" , fixing a bad reference to dyn_func_file from a state object. - -2010-02-18 Alexey Loshkarev - 72c4769: Fix dyn_file_func (was broken?) Fix error message (filename was not displayed) - -2009-10-24 Michael P. Soulier - badf18f: Updated epydoc output for website. - -2009-09-24 Michael P. Soulier - a80639c: Changed licenses to the MIT License - ce7fc32: Fixing some log messages and bad variable references. - -2009-08-18 Michael P. Soulier - 781072b: Updated resent_data in metrics. - 3ae3b31: Fixed server metrics summary. - -2009-08-16 Michael P. Soulier - a6a18c1: First successful download with both client and server. - -2009-08-15 Michael P. Soulier - 62b22fb: Did some rework for the state machine in a server context. Removed the handler framework in favour of a TftpContextServer used as the session. - -2009-06-20 Michael P. Soulier - 03e4e74: Fixing up some of the upload code. - -2009-07-21 Michael P. Soulier - 5ee5f63: Adding patch for dynamic content from Alex ? - -2009-04-10 Michael P. Soulier - c61ca17: Fixing a merge error in rebase - 410e14c: Fixed bug in tidport handling, and lack of OACK response. - 874fef5: Fixing OACK handling with new state machine. - 5072f6d: Fixed TftpClient with new state machine. - -2009-04-08 Michael P. Soulier - e7a63bb: Started overhaul of state machine. - -2009-04-10 Michael P. Soulier - 41bf3a2: Improving sample client output on error and fixing default blocksize when server ignores options. - bd2e195: Merged upload patch. - -2009-04-09 Michael P. Soulier - 449f10a: Updating version in setup - -2009-04-08 Michael P. Soulier - 40185e5: Website update - -2009-04-07 Michael P. Soulier - bc55a17: Fixing bogus warnings in options handling. - 74c68b1: Merge branch 'master' of git@github.com:msoulier/tftpy - d058642: Fixing tftproot configured for server as a relative path. - -2009-03-15 Michael P. Soulier - 23b32d0: Updated site with stylesheet - 0cfcea2: Website update - -2009-03-14 Michael P. Soulier - abf0f1f: Adding website - -2008-10-08 Michael P. Soulier - ca7a06a: Fixed the use of the tsize option in RRQ packets. - -2008-10-05 Michael P. Soulier - 0a5df33: Rolling 0.4.6 - -2008-10-04 Michael P. Soulier - 07416bf: Rebased tsize branch and added a --tsize option to the client. Now sending all packets to the progresshook, not just DAT packets, so that the client can see the OACK. Not yet making use of the returned tsize. Need to test this on a server that supports tsize. - -2008-07-30 Michael P. Soulier - 8a0162b: Adding transfer size option patch from Kuba Kończyk. Patch 2018609 in SF tracker. - -2008-10-03 Michael P. Soulier - c408389: Merged from SVN trunk after register to PyPi - -2008-10-04 msoulier - 65ef2d9: Updated for PyPi - -2008-07-30 Michael P. Soulier - 6730280: Adding upload patch from Lorenz Schori - patch 1897344 in SF tracker - -2008-05-28 msoulier - 33b1353: Tagging 0.4.5. - 936e4df: Updated for v0.4.5 release. - caff30d: Fix for bug 1967647, referencing self.sock instead of sock. - -2008-05-20 msoulier - 70f22b1: Fix for [ 1932310 ] security check always fail for windows. - 596af40: Fixed division by zero error in rate calculations in download function of client. Thanks to Stefaan Vanheesbeke for the report. - 3b1bae3: Fix for bug [ 1932330 ] binary downloads fail in Windows. - -2008-01-31 msoulier - 648564c: Updated README. - 792df2d: Updated ChangeLog - 941f5bf: Updating version to 0.4.4 - -2007-12-16 msoulier - f8af287: Fixing 1851544 - server not tolerant of unsupported options Thanks to Landon Jurgens for the report. - -2007-07-17 msoulier - 89a8382: Updated for 0.4.3 release. - -2007-07-16 msoulier - 2a98d72: Removed redundant comparison. - 955ced3: Fixing string/integer comparison. Thanks to Simon P. Ditner, bug #1755146. - -2007-06-05 msoulier - 493dcac: Updated for 0.4.2 - bb47795: Fixed unit test for factory - -2007-03-31 msoulier - d9665e1: Updating docs for epydoc. - b68ceca: Updated build process. - d8730c7: Adding epydoc target. - -2007-03-15 msoulier - 0b41ffb: Updated ChangeLog - -2007-02-23 msoulier - 8f5595c: Simplifying use of optparse. Thanks to Steven Bethard for the suggestions. - -2007-02-17 msoulier - 5c52975: Removed mention of sorceror's apprentice problem. - c8df0fd: Rearranged packaging a bit to fix an importing problem. - c7d86d3: Supplying a default blksize options in the server. Fix for 1633625. - -2007-02-10 msoulier - 07906cd: Added a check for rogue packets in the server. - -2007-02-09 msoulier - f53e68b: Making the lib backwards-compatible to Python 2.3. - -2006-12-17 msoulier - efd248f: Rolling to version 0.4.1. - 95b6a72: Restructuring single lib into a package. - a1ad552: Restructuring single lib into a package. - c43a24c: Restructuring single lib into a package. - 5e6d8fe: Restructuring single lib into a package. - 6eb1501: Fixing install location of library. - -2006-12-16 msoulier - 15023eb: Added server to package. - ac2faa3: Updated ChangeLog, and rolled version to 0.4 - -2006-12-15 msoulier - f79a1e9: Making server exit gracefully. - 16ebbf2: Tweak to EOF handling in server. - 7723705: First working server tests with two clients. - 5cfbae3: Added lots in the server to support a download, with timeouts. Not yet tested with a client, but the damn thing runs. - d5b7276: Fixed a bug in handling block number rollovers. - -2006-12-14 msoulier - 7441f0a: Got handling of file not found working in server. - 3b4d177: Starting on sample server. - 94ef067: Successful test on basic select loop - -2006-12-11 msoulier - 6f186f2: Added some security checks around the tftproot. Further fleshed-out the handler. Still not actually starting the transfer. - -2006-12-10 msoulier - b5a96ec: Fleshing out server handler implementation. - fc2a587: Started on the server - -2006-12-09 msoulier - aece5aa: Added --debug option to sample client. - 204cce4: Adding license - 4fc510b: Adding ChangeLog - 07e2976: Bumped the version. - 104dfe0: Changed the port variables to something more intelligent. - 15c5a0f: Fixing poor TID implementation. - -2006-10-25 msoulier - 8e6cd77: Added testcase for TftpPacketFactory. - -2006-10-13 msoulier - 7486502: Implemented retries on download timeouts. - 0528b1b: Added some info statements regarding option negotiation. - 4c73041: Updated testcases, fixed one error in decode_options - -2006-10-11 msoulier - f2b7d5d: Updated testcases - 837344c: Updated makefile - 08af50a: Adding makefile - -2006-10-10 msoulier - 99b3bbd: Moved LICENSE to COPYING - -2006-10-09 msoulier - 2e42f99: Added test for WRQ packet - 6ebd6fc: Fixed broken decode, and adjusted the client options. - -2006-10-08 msoulier - 6db1b2c: Starting on unit tests - -2006-10-05 msoulier - e771f67: Fixed handling of port - cb75a4b: Updating for production - 19e8f0f: Freezing 0.2 - 0a13eb5: Fixed poor EOF detection - ed15161: Got variable blocksizes working. - -2006-10-04 msoulier - c24bba2: Added confirmation of incoming traffic to known remote host. - c11ac3a: Restructured in preparation for tftp options - 2827cf1: Updated README - c6094b0: Updated README - 09de253: Added seconds to logs - 82821e5: Upping version to 0.2 - 88c387b: Added OACK packet, and factored-out client code. diff --git a/MANIFEST.in b/MANIFEST.in deleted file mode 100644 index 906fba4..0000000 --- a/MANIFEST.in +++ /dev/null @@ -1,3 +0,0 @@ -include LICENSE -include ChangeLog -include COPYING diff --git a/Makefile b/Makefile deleted file mode 100644 index 7c2e735..0000000 --- a/Makefile +++ /dev/null @@ -1,16 +0,0 @@ -PY=/usr/bin/env python -PYTHONPATH=. - -all: test sdist - -sdist: - PYTHONPATH=$(PYTHONPATH) $(PY) setup.py sdist - -test: - PYTHONPATH=$(PYTHONPATH) $(PY) t/test.py - -clean: - rm -rf dist src tftpy-doc* MANIFEST - -flakes: - pyflakes bin/*.py tftpy/*.py diff --git a/README b/README deleted file mode 100644 index a7e576f..0000000 --- a/README +++ /dev/null @@ -1,106 +0,0 @@ -Copyright, Michael P. Soulier, 2010. - -About Release 0.6.0: -==================== -Maintenance update to fix several reported issues, including proper -retransmits on timeouts, and further expansion of unit tests. - -About Release 0.5.1: -==================== -Maintenance update to fix a bug in the server, overhaul the documentation for -the website, fix a typo in the unit tests, fix a failure to set default -blocksize, and a divide by zero error in speed calculations for very short -transfers. - -Also, this release adds support for input/output in client as stdin/stdout - -About Release 0.5.0: -==================== -Complete rewrite of the state machine. -Now fully implements downloading and uploading. - -About Release 0.4.6: -==================== -Feature release to add the tsize option. -Thanks to Kuba Kończyk for the patch. - -About Release 0.4.5: -==================== -Bugfix release for compatability issues on Win32, among other small issues. - -About Release 0.4.4: -==================== -Bugfix release for poor tolerance of unsupported options in the server. - -About Release 0.4.3: -==================== -Bugfix release for an issue with the server's detection of the end of the file -during a download. - -About Release 0.4.2: -==================== -Bugfix release for some small installation issues with earlier Python -releases. - -About Release 0.4.1: -==================== -Bugfix release to fix the installation path, with some restructuring into a -tftpy package from the single module used previously. - -About Release 0.4: -================== -This release adds a TftpServer class with a sample implementation in bin. -The server uses a single thread with multiple handlers and a select() loop to -handle multiple clients simultaneously. - -Only downloads are supported at this time. - -About Release 0.3: -================== -This release fixes a major RFC 1350 compliance problem with the remote TID. - -About Release 0.2: -================== -This release adds variable block sizes, and general option support, -implementing RFCs 2347 and 2348. This is accessible in the TftpClient class -via the options dict, or in the sample client via the --blocksize option. - -About Release 0.1: -================== - -This is an initial release in the spirit of "release early, release often". -Currently the sample client works, supporting RFC 1350. The server is not yet -implemented, and RFC 2347 and 2348 support (variable block sizes) is underway, -planned for 0.2. - -About Tftpy: -============ - -Purpose: --------- -Tftpy is a TFTP library for the Python programming language. It includes -client and server classes, with sample implementations. Hooks are included for -easy inclusion in a UI for populating progress indicators. It supports RFCs -1350, 2347, 2348 and the tsize option from RFC 2349. - -Dependencies: -------------- -Python 2.3+, hopefully. Let me know if it fails to work. - -Trifles: --------- -Home page: http://tftpy.sf.net/ -Project page: http://sourceforge.net/projects/tftpy/ - -License is the MIT License - -See COPYING in this distribution. - -Limitations: ------------- -- Only 'octet' mode is supported. -- The only options supported are blksize and tsize. - -Author: -======= -Michael P. Soulier diff --git a/doc/Makefile b/doc/Makefile deleted file mode 100644 index af2840d..0000000 --- a/doc/Makefile +++ /dev/null @@ -1,94 +0,0 @@ -# Makefile for Sphinx documentation -# - -# You can set these variables from the command line. -SPHINXOPTS = -SPHINXBUILD = sphinx-build -PAPER = -BUILDDIR = _build - -# Internal variables. -PAPEROPT_a4 = -D latex_paper_size=a4 -PAPEROPT_letter = -D latex_paper_size=letter -ALLSPHINXOPTS = -d $(BUILDDIR)/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) . - -.PHONY: help clean html dirhtml pickle json htmlhelp qthelp latex changes linkcheck doctest - -help: - @echo "Please use \`make ' where is one of" - @echo " html to make standalone HTML files" - @echo " dirhtml to make HTML files named index.html in directories" - @echo " pickle to make pickle files" - @echo " json to make JSON files" - @echo " htmlhelp to make HTML files and a HTML help project" - @echo " qthelp to make HTML files and a qthelp project" - @echo " latex to make LaTeX files, you can set PAPER=a4 or PAPER=letter" - @echo " changes to make an overview of all changed/added/deprecated items" - @echo " linkcheck to check all external links for integrity" - @echo " doctest to run all doctests embedded in the documentation (if enabled)" - -clean: - -rm -rf $(BUILDDIR)/* - -html: - $(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html - @echo - @echo "Build finished. The HTML pages are in $(BUILDDIR)/html." - -install-html: html - rm -rf ../html/sphinx - mkdir -p ../html/sphinx - cp -R _build/html/* ../html/sphinx - -dirhtml: - $(SPHINXBUILD) -b dirhtml $(ALLSPHINXOPTS) $(BUILDDIR)/dirhtml - @echo - @echo "Build finished. The HTML pages are in $(BUILDDIR)/dirhtml." - -pickle: - $(SPHINXBUILD) -b pickle $(ALLSPHINXOPTS) $(BUILDDIR)/pickle - @echo - @echo "Build finished; now you can process the pickle files." - -json: - $(SPHINXBUILD) -b json $(ALLSPHINXOPTS) $(BUILDDIR)/json - @echo - @echo "Build finished; now you can process the JSON files." - -htmlhelp: - $(SPHINXBUILD) -b htmlhelp $(ALLSPHINXOPTS) $(BUILDDIR)/htmlhelp - @echo - @echo "Build finished; now you can run HTML Help Workshop with the" \ - ".hhp project file in $(BUILDDIR)/htmlhelp." - -qthelp: - $(SPHINXBUILD) -b qthelp $(ALLSPHINXOPTS) $(BUILDDIR)/qthelp - @echo - @echo "Build finished; now you can run "qcollectiongenerator" with the" \ - ".qhcp project file in $(BUILDDIR)/qthelp, like this:" - @echo "# qcollectiongenerator $(BUILDDIR)/qthelp/TFTPy.qhcp" - @echo "To view the help file:" - @echo "# assistant -collectionFile $(BUILDDIR)/qthelp/TFTPy.qhc" - -latex: - $(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex - @echo - @echo "Build finished; the LaTeX files are in $(BUILDDIR)/latex." - @echo "Run \`make all-pdf' or \`make all-ps' in that directory to" \ - "run these through (pdf)latex." - -changes: - $(SPHINXBUILD) -b changes $(ALLSPHINXOPTS) $(BUILDDIR)/changes - @echo - @echo "The overview file is in $(BUILDDIR)/changes." - -linkcheck: - $(SPHINXBUILD) -b linkcheck $(ALLSPHINXOPTS) $(BUILDDIR)/linkcheck - @echo - @echo "Link check complete; look for any errors in the above output " \ - "or in $(BUILDDIR)/linkcheck/output.txt." - -doctest: - $(SPHINXBUILD) -b doctest $(ALLSPHINXOPTS) $(BUILDDIR)/doctest - @echo "Testing of doctests in the sources finished, look at the " \ - "results in $(BUILDDIR)/doctest/output.txt." diff --git a/doc/conf.py b/doc/conf.py deleted file mode 100644 index d7a5415..0000000 --- a/doc/conf.py +++ /dev/null @@ -1,194 +0,0 @@ -# -*- coding: utf-8 -*- -# -# TFTPy documentation build configuration file, created by -# sphinx-quickstart on Sun Jul 11 18:48:32 2010. -# -# This file is execfile()d with the current directory set to its containing dir. -# -# Note that not all possible configuration values are present in this -# autogenerated file. -# -# All configuration values have a default; values that are commented out -# serve to show the default. - -import sys, os - -# If extensions (or modules to document with autodoc) are in another directory, -# add these directories to sys.path here. If the directory is relative to the -# documentation root, use os.path.abspath to make it absolute, like shown here. -sys.path.append(os.path.abspath('..')) - -# -- General configuration ----------------------------------------------------- - -# Add any Sphinx extension module names here, as strings. They can be extensions -# coming with Sphinx (named 'sphinx.ext.*') or your custom ones. -extensions = ['sphinx.ext.autodoc'] - -# Add any paths that contain templates here, relative to this directory. -templates_path = ['_templates'] - -# The suffix of source filenames. -source_suffix = '.rst' - -# The encoding of source files. -#source_encoding = 'utf-8' - -# The master toctree document. -master_doc = 'index' - -# General information about the project. -project = u'TFTPy' -copyright = u'2010, Michael P. Soulier' - -# The version info for the project you're documenting, acts as replacement for -# |version| and |release|, also used in various other places throughout the -# built documents. -# -# The short X.Y version. -version = '0.6' -# The full version, including alpha/beta/rc tags. -release = '0.6.0' - -# The language for content autogenerated by Sphinx. Refer to documentation -# for a list of supported languages. -#language = None - -# There are two options for replacing |today|: either, you set today to some -# non-false value, then it is used: -#today = '' -# Else, today_fmt is used as the format for a strftime call. -#today_fmt = '%B %d, %Y' - -# List of documents that shouldn't be included in the build. -#unused_docs = [] - -# List of directories, relative to source directory, that shouldn't be searched -# for source files. -exclude_trees = ['_build'] - -# The reST default role (used for this markup: `text`) to use for all documents. -#default_role = None - -# If true, '()' will be appended to :func: etc. cross-reference text. -#add_function_parentheses = True - -# If true, the current module name will be prepended to all description -# unit titles (such as .. function::). -#add_module_names = True - -# If true, sectionauthor and moduleauthor directives will be shown in the -# output. They are ignored by default. -#show_authors = False - -# The name of the Pygments (syntax highlighting) style to use. -pygments_style = 'sphinx' - -# A list of ignored prefixes for module index sorting. -#modindex_common_prefix = [] - - -# -- Options for HTML output --------------------------------------------------- - -# The theme to use for HTML and HTML Help pages. Major themes that come with -# Sphinx are currently 'default' and 'sphinxdoc'. -html_theme = 'default' - -# Theme options are theme-specific and customize the look and feel of a theme -# further. For a list of options available for each theme, see the -# documentation. -#html_theme_options = {} - -# Add any paths that contain custom themes here, relative to this directory. -#html_theme_path = [] - -# The name for this set of Sphinx documents. If None, it defaults to -# " v documentation". -#html_title = None - -# A shorter title for the navigation bar. Default is the same as html_title. -#html_short_title = None - -# The name of an image file (relative to this directory) to place at the top -# of the sidebar. -#html_logo = None - -# The name of an image file (within the static path) to use as favicon of the -# docs. This file should be a Windows icon file (.ico) being 16x16 or 32x32 -# pixels large. -#html_favicon = None - -# Add any paths that contain custom static files (such as style sheets) here, -# relative to this directory. They are copied after the builtin static files, -# so a file named "default.css" will overwrite the builtin "default.css". -html_static_path = ['_static'] - -# If not '', a 'Last updated on:' timestamp is inserted at every page bottom, -# using the given strftime format. -#html_last_updated_fmt = '%b %d, %Y' - -# If true, SmartyPants will be used to convert quotes and dashes to -# typographically correct entities. -#html_use_smartypants = True - -# Custom sidebar templates, maps document names to template names. -#html_sidebars = {} - -# Additional templates that should be rendered to pages, maps page names to -# template names. -#html_additional_pages = {} - -# If false, no module index is generated. -#html_use_modindex = True - -# If false, no index is generated. -#html_use_index = True - -# If true, the index is split into individual pages for each letter. -#html_split_index = False - -# If true, links to the reST sources are added to the pages. -#html_show_sourcelink = True - -# If true, an OpenSearch description file will be output, and all pages will -# contain a tag referring to it. The value of this option must be the -# base URL from which the finished HTML is served. -#html_use_opensearch = '' - -# If nonempty, this is the file name suffix for HTML files (e.g. ".xhtml"). -#html_file_suffix = '' - -# Output file base name for HTML help builder. -htmlhelp_basename = 'TFTPydoc' - - -# -- Options for LaTeX output -------------------------------------------------- - -# The paper size ('letter' or 'a4'). -#latex_paper_size = 'letter' - -# The font size ('10pt', '11pt' or '12pt'). -#latex_font_size = '10pt' - -# Grouping the document tree into LaTeX files. List of tuples -# (source start file, target name, title, author, documentclass [howto/manual]). -latex_documents = [ - ('index', 'TFTPy.tex', u'TFTPy Documentation', - u'Michael P. Soulier', 'manual'), -] - -# The name of an image file (relative to this directory) to place at the top of -# the title page. -#latex_logo = None - -# For "manual" documents, if this is true, then toplevel headings are parts, -# not chapters. -#latex_use_parts = False - -# Additional stuff for the LaTeX preamble. -#latex_preamble = '' - -# Documents to append as an appendix to all manuals. -#latex_appendices = [] - -# If false, no module index is generated. -#latex_use_modindex = True diff --git a/doc/index.rst b/doc/index.rst deleted file mode 100644 index 6e59eba..0000000 --- a/doc/index.rst +++ /dev/null @@ -1,114 +0,0 @@ -.. TFTPy documentation master file, created by - sphinx-quickstart on Sun Jul 11 18:48:32 2010. - You can adapt this file completely to your liking, but it should at least - contain the root `toctree` directive. - -TFTPy -===== - -TFTPy is a pure python TFTP implementation. - -.. toctree:: - :maxdepth: 2 - -* :ref:`genindex` -* :ref:`modindex` -* :ref:`search` - -Requirements -============ -Python 2.3+, I think. I haven't tested in Python 2.3 in a while but it should -still work. Let me know if it doesn't. - -Installation -============ -If you download the source distribution, you can simply use distutils to -install, via:: - - python setup.py build - python setup.py install - -Or, as this has been uploaded to pypi, you can use easy_install or pip:: - - easy_install tftpy - pip install tftpy - -Once installed you should have the sample client and server scripts in bin, -and you should be able to import the `tftpy` module. - -Examples -======== -The simplest tftp client:: - - import tftpy - - client = tftpy.TftpClient('tftp.digitaltorque.ca', 69) - client.download('remote_filename', 'local_filename') - -The simplest tftp server:: - - import tftpy - - server = tftpy.TftpServer('/tftpboot') - server.listen('0.0.0.0', 69) - -See the sample client and server for slightly more complex examples. - -API Documentation -================= - -Front-end Modules ------------------ -These modules are the ones that you will need to use directly to implement a -TFTP client or server. - -The :mod:`tftpy` Module -~~~~~~~~~~~~~~~~~~~~~~~ -.. automodule:: tftpy - :members: - :show-inheritance: - -The `TftpClient` Module -~~~~~~~~~~~~~~~~~~~~~~~ -.. automodule:: tftpy.TftpClient - :members: - :show-inheritance: - -The `TftpServer` Module -~~~~~~~~~~~~~~~~~~~~~~~ -.. automodule:: tftpy.TftpServer - :members: - :show-inheritance: - -Back-end Modules ----------------- - -The `TftpPacketFactory` Module -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.. automodule:: tftpy.TftpPacketFactory - :members: - :show-inheritance: - -The `TftpPacketTypes` Module -~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.. automodule:: tftpy.TftpPacketTypes - :members: - :show-inheritance: - -The `TftpShared` Module -~~~~~~~~~~~~~~~~~~~~~~~ -.. automodule:: tftpy.TftpShared - :members: - :show-inheritance: - -The `TftpContexts` Module -~~~~~~~~~~~~~~~~~~~~~~~~~ -.. automodule:: tftpy.TftpContexts - :members: - :show-inheritance: - -The `TftpStates` Module -~~~~~~~~~~~~~~~~~~~~~~~ -.. automodule:: tftpy.TftpStates - :members: - :show-inheritance: diff --git a/doc/rfc1350.txt b/doc/rfc1350.txt deleted file mode 100644 index f114928..0000000 --- a/doc/rfc1350.txt +++ /dev/null @@ -1,551 +0,0 @@ - - RFC 1350 (RFC1350) - - Internet RFC/STD/FYI/BCP Archives - -[ [1]RFC Index | [2]RFC Search | [3]Usenet FAQs | [4]Web FAQs | [5]Documents - | [6]Cities ] - - Alternate Formats: [7]rfc1350.txt | [8]rfc1350.txt.pdf - - RFC 1350 - The TFTP Protocol (Revision 2) - _________________________________________________________________ - - -Network Working Group K. Sollins -Request For Comments: 1350 MIT -STD: 33 July 1992 -Obsoletes: [9]RFC 783 - - THE TFTP PROTOCOL (REVISION 2) - -Status of this Memo - - This RFC specifies an IAB standards track protocol for the Internet - community, and requests discussion and suggestions for improvements. - Please refer to the current edition of the "IAB Official Protocol - Standards" for the standardization state and status of this protocol. - Distribution of this memo is unlimited. - -Summary - - TFTP is a very simple protocol used to transfer files. It is from - this that its name comes, Trivial File Transfer Protocol or TFTP. - Each nonterminal packet is acknowledged separately. This document - describes the protocol and its types of packets. The document also - explains the reasons behind some of the design decisions. - -Acknowlegements - - The protocol was originally designed by Noel Chiappa, and was - redesigned by him, Bob Baldwin and Dave Clark, with comments from - Steve Szymanski. The current revision of the document includes - modifications stemming from discussions with and suggestions from - Larry Allen, Noel Chiappa, Dave Clark, Geoff Cooper, Mike Greenwald, - Liza Martin, David Reed, Craig Milo Rogers (of USC-ISI), Kathy - Yellick, and the author. The acknowledgement and retransmission - scheme was inspired by TCP, and the error mechanism was suggested by - PARC's EFTP abort message. - - The May, 1992 revision to fix the "Sorcerer's Apprentice" protocol - bug [4] and other minor document problems was done by Noel Chiappa. - - This research was supported by the Advanced Research Projects Agency - of the Department of Defense and was monitored by the Office of Naval - Research under contract number N00014-75-C-0661. - -1. Purpose - - TFTP is a simple protocol to transfer files, and therefore was named - the Trivial File Transfer Protocol or TFTP. It has been implemented - on top of the Internet User Datagram protocol (UDP or Datagram) [2] - - so it may be used to move files between machines on different - networks implementing UDP. (This should not exclude the possibility - of implementing TFTP on top of other datagram protocols.) It is - designed to be small and easy to implement. Therefore, it lacks most - of the features of a regular FTP. The only thing it can do is read - and write files (or mail) from/to a remote server. It cannot list - directories, and currently has no provisions for user authentication. - In common with other Internet protocols, it passes 8 bit bytes of - data. - - Three modes of transfer are currently supported: netascii (This is - ascii as defined in "USA Standard Code for Information Interchange" - [1] with the modifications specified in "Telnet Protocol - Specification" [3].) Note that it is 8 bit ascii. The term - "netascii" will be used throughout this document to mean this - particular version of ascii.); octet (This replaces the "binary" mode - of previous versions of this document.) raw 8 bit bytes; mail, - netascii characters sent to a user rather than a file. (The mail - mode is obsolete and should not be implemented or used.) Additional - modes can be defined by pairs of cooperating hosts. - - Reference [4] (section 4.2) should be consulted for further valuable - directives and suggestions on TFTP. - -2. Overview of the Protocol - - Any transfer begins with a request to read or write a file, which - also serves to request a connection. If the server grants the - request, the connection is opened and the file is sent in fixed - length blocks of 512 bytes. Each data packet contains one block of - data, and must be acknowledged by an acknowledgment packet before the - next packet can be sent. A data packet of less than 512 bytes - signals termination of a transfer. If a packet gets lost in the - network, the intended recipient will timeout and may retransmit his - last packet (which may be data or an acknowledgment), thus causing - the sender of the lost packet to retransmit that lost packet. The - sender has to keep just one packet on hand for retransmission, since - the lock step acknowledgment guarantees that all older packets have - been received. Notice that both machines involved in a transfer are - considered senders and receivers. One sends data and receives - acknowledgments, the other sends acknowledgments and receives data. - - Most errors cause termination of the connection. An error is - signalled by sending an error packet. This packet is not - acknowledged, and not retransmitted (i.e., a TFTP server or user may - terminate after sending an error message), so the other end of the - connection may not get it. Therefore timeouts are used to detect - such a termination when the error packet has been lost. Errors are - - caused by three types of events: not being able to satisfy the - request (e.g., file not found, access violation, or no such user), - receiving a packet which cannot be explained by a delay or - duplication in the network (e.g., an incorrectly formed packet), and - losing access to a necessary resource (e.g., disk full or access - denied during a transfer). - - TFTP recognizes only one error condition that does not cause - termination, the source port of a received packet being incorrect. - In this case, an error packet is sent to the originating host. - - This protocol is very restrictive, in order to simplify - implementation. For example, the fixed length blocks make allocation - straight forward, and the lock step acknowledgement provides flow - control and eliminates the need to reorder incoming data packets. - -3. Relation to other Protocols - - As mentioned TFTP is designed to be implemented on top of the - Datagram protocol (UDP). Since Datagram is implemented on the - Internet protocol, packets will have an Internet header, a Datagram - header, and a TFTP header. Additionally, the packets may have a - header (LNI, ARPA header, etc.) to allow them through the local - transport medium. As shown in Figure 3-1, the order of the contents - of a packet will be: local medium header, if used, Internet header, - Datagram header, TFTP header, followed by the remainder of the TFTP - packet. (This may or may not be data depending on the type of packet - as specified in the TFTP header.) TFTP does not specify any of the - values in the Internet header. On the other hand, the source and - destination port fields of the Datagram header (its format is given - in the appendix) are used by TFTP and the length field reflects the - size of the TFTP packet. The transfer identifiers (TID's) used by - TFTP are passed to the Datagram layer to be used as ports; therefore - they must be between 0 and 65,535. The initialization of TID's is - discussed in the section on initial connection protocol. - - The TFTP header consists of a 2 byte opcode field which indicates - the packet's type (e.g., DATA, ERROR, etc.) These opcodes and the - formats of the various types of packets are discussed further in the - section on TFTP packets. - - --------------------------------------------------- - | Local Medium | Internet | Datagram | TFTP | - --------------------------------------------------- - - Figure 3-1: Order of Headers - -4. Initial Connection Protocol - - A transfer is established by sending a request (WRQ to write onto a - foreign file system, or RRQ to read from it), and receiving a - positive reply, an acknowledgment packet for write, or the first data - packet for read. In general an acknowledgment packet will contain - the block number of the data packet being acknowledged. Each data - packet has associated with it a block number; block numbers are - consecutive and begin with one. Since the positive response to a - write request is an acknowledgment packet, in this special case the - block number will be zero. (Normally, since an acknowledgment packet - is acknowledging a data packet, the acknowledgment packet will - contain the block number of the data packet being acknowledged.) If - the reply is an error packet, then the request has been denied. - - In order to create a connection, each end of the connection chooses a - TID for itself, to be used for the duration of that connection. The - TID's chosen for a connection should be randomly chosen, so that the - probability that the same number is chosen twice in immediate - succession is very low. Every packet has associated with it the two - TID's of the ends of the connection, the source TID and the - destination TID. These TID's are handed to the supporting UDP (or - other datagram protocol) as the source and destination ports. A - requesting host chooses its source TID as described above, and sends - its initial request to the known TID 69 decimal (105 octal) on the - serving host. The response to the request, under normal operation, - uses a TID chosen by the server as its source TID and the TID chosen - for the previous message by the requestor as its destination TID. - The two chosen TID's are then used for the remainder of the transfer. - - As an example, the following shows the steps used to establish a - connection to write a file. Note that WRQ, ACK, and DATA are the - names of the write request, acknowledgment, and data types of packets - respectively. The appendix contains a similar example for reading a - file. - - 1. Host A sends a "WRQ" to host B with source= A's TID, - destination= 69. - - 2. Host B sends a "ACK" (with block number= 0) to host A with - source= B's TID, destination= A's TID. - - At this point the connection has been established and the first data - packet can be sent by Host A with a sequence number of 1. In the - next step, and in all succeeding steps, the hosts should make sure - that the source TID matches the value that was agreed on in steps 1 - and 2. If a source TID does not match, the packet should be - discarded as erroneously sent from somewhere else. An error packet - should be sent to the source of the incorrect packet, while not - disturbing the transfer. This can be done only if the TFTP in fact - receives a packet with an incorrect TID. If the supporting protocols - do not allow it, this particular error condition will not arise. - - The following example demonstrates a correct operation of the - protocol in which the above situation can occur. Host A sends a - request to host B. Somewhere in the network, the request packet is - duplicated, and as a result two acknowledgments are returned to host - A, with different TID's chosen on host B in response to the two - requests. When the first response arrives, host A continues the - connection. When the second response to the request arrives, it - should be rejected, but there is no reason to terminate the first - connection. Therefore, if different TID's are chosen for the two - connections on host B and host A checks the source TID's of the - messages it receives, the first connection can be maintained while - the second is rejected by returning an error packet. - -5. TFTP Packets - - TFTP supports five types of packets, all of which have been mentioned - above: - - opcode operation - 1 Read request (RRQ) - 2 Write request (WRQ) - 3 Data (DATA) - 4 Acknowledgment (ACK) - 5 Error (ERROR) - - The TFTP header of a packet contains the opcode associated with - that packet. - - 2 bytes string 1 byte string 1 byte - ------------------------------------------------ - | Opcode | Filename | 0 | Mode | 0 | - ------------------------------------------------ - - Figure 5-1: RRQ/WRQ packet - - RRQ and WRQ packets (opcodes 1 and 2 respectively) have the format - shown in Figure 5-1. The file name is a sequence of bytes in - netascii terminated by a zero byte. The mode field contains the - string "netascii", "octet", or "mail" (or any combination of upper - and lower case, such as "NETASCII", NetAscii", etc.) in netascii - indicating the three modes defined in the protocol. A host which - receives netascii mode data must translate the data to its own - format. Octet mode is used to transfer a file that is in the 8-bit - format of the machine from which the file is being transferred. It - is assumed that each type of machine has a single 8-bit format that - is more common, and that that format is chosen. For example, on a - DEC-20, a 36 bit machine, this is four 8-bit bytes to a word with - four bits of breakage. If a host receives a octet file and then - returns it, the returned file must be identical to the original. - Mail mode uses the name of a mail recipient in place of a file and - must begin with a WRQ. Otherwise it is identical to netascii mode. - The mail recipient string should be of the form "username" or - "username@hostname". If the second form is used, it allows the - option of mail forwarding by a relay computer. - - The discussion above assumes that both the sender and recipient are - operating in the same mode, but there is no reason that this has to - be the case. For example, one might build a storage server. There - is no reason that such a machine needs to translate netascii into its - own form of text. Rather, the sender might send files in netascii, - but the storage server might simply store them without translation in - 8-bit format. Another such situation is a problem that currently - exists on DEC-20 systems. Neither netascii nor octet accesses all - the bits in a word. One might create a special mode for such a - machine which read all the bits in a word, but in which the receiver - stored the information in 8-bit format. When such a file is - retrieved from the storage site, it must be restored to its original - form to be useful, so the reverse mode must also be implemented. The - user site will have to remember some information to achieve this. In - both of these examples, the request packets would specify octet mode - to the foreign host, but the local host would be in some other mode. - No such machine or application specific modes have been specified in - TFTP, but one would be compatible with this specification. - - It is also possible to define other modes for cooperating pairs of - - hosts, although this must be done with care. There is no requirement - that any other hosts implement these. There is no central authority - that will define these modes or assign them names. - - 2 bytes 2 bytes n bytes - ---------------------------------- - | Opcode | Block # | Data | - ---------------------------------- - - Figure 5-2: DATA packet - - Data is actually transferred in DATA packets depicted in Figure 5-2. - DATA packets (opcode = 3) have a block number and data field. The - block numbers on data packets begin with one and increase by one for - each new block of data. This restriction allows the program to use a - single number to discriminate between new packets and duplicates. - The data field is from zero to 512 bytes long. If it is 512 bytes - long, the block is not the last block of data; if it is from zero to - 511 bytes long, it signals the end of the transfer. (See the section - on Normal Termination for details.) - - All packets other than duplicate ACK's and those used for - termination are acknowledged unless a timeout occurs [4]. Sending a - DATA packet is an acknowledgment for the first ACK packet of the - previous DATA packet. The WRQ and DATA packets are acknowledged by - ACK or ERROR packets, while RRQ - - 2 bytes 2 bytes - --------------------- - | Opcode | Block # | - --------------------- - - Figure 5-3: ACK packet - - and ACK packets are acknowledged by DATA or ERROR packets. Figure - 5-3 depicts an ACK packet; the opcode is 4. The block number in - an ACK echoes the block number of the DATA packet being - acknowledged. A WRQ is acknowledged with an ACK packet having a - block number of zero. - - 2 bytes 2 bytes string 1 byte - ----------------------------------------- - | Opcode | ErrorCode | ErrMsg | 0 | - ----------------------------------------- - - Figure 5-4: ERROR packet - - An ERROR packet (opcode 5) takes the form depicted in Figure 5-4. An - ERROR packet can be the acknowledgment of any other type of packet. - The error code is an integer indicating the nature of the error. A - table of values and meanings is given in the appendix. (Note that - several error codes have been added to this version of this - document.) The error message is intended for human consumption, and - should be in netascii. Like all other strings, it is terminated with - a zero byte. - -6. Normal Termination - - The end of a transfer is marked by a DATA packet that contains - between 0 and 511 bytes of data (i.e., Datagram length < 516). This - packet is acknowledged by an ACK packet like all other DATA packets. - The host acknowledging the final DATA packet may terminate its side - of the connection on sending the final ACK. On the other hand, - dallying is encouraged. This means that the host sending the final - ACK will wait for a while before terminating in order to retransmit - the final ACK if it has been lost. The acknowledger will know that - the ACK has been lost if it receives the final DATA packet again. - The host sending the last DATA must retransmit it until the packet is - acknowledged or the sending host times out. If the response is an - ACK, the transmission was completed successfully. If the sender of - the data times out and is not prepared to retransmit any more, the - transfer may still have been completed successfully, after which the - acknowledger or network may have experienced a problem. It is also - possible in this case that the transfer was unsuccessful. In any - case, the connection has been closed. - -7. Premature Termination - - If a request can not be granted, or some error occurs during the - transfer, then an ERROR packet (opcode 5) is sent. This is only a - courtesy since it will not be retransmitted or acknowledged, so it - may never be received. Timeouts must also be used to detect errors. - -I. Appendix - -Order of Headers - - 2 bytes - ---------------------------------------------------------- - | Local Medium | Internet | Datagram | TFTP Opcode | - ---------------------------------------------------------- - -TFTP Formats - - Type Op # Format without header - - 2 bytes string 1 byte string 1 byte - ----------------------------------------------- - RRQ/ | 01/02 | Filename | 0 | Mode | 0 | - WRQ ----------------------------------------------- - 2 bytes 2 bytes n bytes - --------------------------------- - DATA | 03 | Block # | Data | - --------------------------------- - 2 bytes 2 bytes - ------------------- - ACK | 04 | Block # | - -------------------- - 2 bytes 2 bytes string 1 byte - ---------------------------------------- - ERROR | 05 | ErrorCode | ErrMsg | 0 | - ---------------------------------------- - -Initial Connection Protocol for reading a file - - 1. Host A sends a "RRQ" to host B with source= A's TID, - destination= 69. - - 2. Host B sends a "DATA" (with block number= 1) to host A with - source= B's TID, destination= A's TID. - -Error Codes - - Value Meaning - - 0 Not defined, see error message (if any). - 1 File not found. - 2 Access violation. - 3 Disk full or allocation exceeded. - 4 Illegal TFTP operation. - 5 Unknown transfer ID. - 6 File already exists. - 7 No such user. - -Internet User Datagram Header [2] - - (This has been included only for convenience. TFTP need not be - implemented on top of the Internet User Datagram Protocol.) - - Format - - 0 1 2 3 - 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 - +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ - | Source Port | Destination Port | - +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ - | Length | Checksum | - +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ - - Values of Fields - - Source Port Picked by originator of packet. - - Dest. Port Picked by destination machine (69 for RRQ or WRQ). - - Length Number of bytes in UDP packet, including UDP header. - - Checksum Reference 2 describes rules for computing checksum. - (The implementor of this should be sure that the - correct algorithm is used here.) - Field contains zero if unused. - - Note: TFTP passes transfer identifiers (TID's) to the Internet User - Datagram protocol to be used as the source and destination ports. - -References - - [1] USA Standard Code for Information Interchange, USASI X3.4-1968. - - [2] Postel, J., "User Datagram Protocol," [10]RFC 768, USC/Information - Sciences Institute, 28 August 1980. - - [3] Postel, J., "Telnet Protocol Specification," [11]RFC 764, - USC/Information Sciences Institute, June, 1980. - - [4] Braden, R., Editor, "Requirements for Internet Hosts -- - Application and Support", [12]RFC 1123, USC/Information Sciences - Institute, October 1989. - -Security Considerations - - Since TFTP includes no login or access control mechanisms, care must - be taken in the rights granted to a TFTP server process so as not to - violate the security of the server hosts file system. TFTP is often - installed with controls such that only files that have public read - access are available via TFTP and writing files via TFTP is - disallowed. - -Author's Address - - Karen R. Sollins - Massachusetts Institute of Technology - Laboratory for Computer Science - 545 Technology Square - Cambridge, MA 02139-1986 - - Phone: (617) 253-6006 - - EMail: [13]SOLLINS@LCS.MIT.EDU - - - Comments about this RFC: - * [14]RFC 1350: How to setup TFTP across firewall. Why to spawn - connections on several different... by WahJava (2/7/2006) - * [15]RFC 1350: Since there is no master slave arrangement. What happens - if both ends of the... by pg (3/30/2005) - * [16]RFC 1350: What happens when the TFTP client or server detects that - the ethernet link which... by Sekhar Nori (12/29/2003) - * [17]RFC 1350: This RFC may benefit from an update in the style of PPP or - SSCOP protocol... by Chris (10/4/2004) - * [18]RFC 1350: What happens if the server receives any packet other than - RRQ/WRQ in the initial... by Orgad (10/24/2003) - * [19]RFC 1350: In the following para,it is considered duplication of the - acknowledgment packet... by KiranKumar (1/1/2006) - * [20]RFC 1350: What happens if the data on the file is a multiple 512 - bytes? When will the... by yara (2/23/2005) - * [21]RFC 1350: I tried WhiteHorn TFTP server (www.whitehorns.net) and - really liked it. Does... by bartley (7/29/2005) - * [22]RFC 1350: I'd like to see more discussion about the benefits and - drawbacks of using... by Mike Cepek (4/19/2005) - * [23]RFC 1350: Any words on the ipv6 support in TFTP..It might be not the - correct question here... by Piyush Yaduvanshi (2/23/2006) - - Previous: [24]RFC 1349 - Type of Service in the Internet Protocol Suite - Next: [25]RFC 1351 - SNMP Administrative Model - - _________________________________________________________________ - - [ [26]RFC Index | [27]RFC Search | [28]Usenet FAQs | [29]Web FAQs | - [30]Documents | [31]Cities ] - -References - - 1. http://www.faqs.org/rfcs/ - 2. http://www.faqs.org/rfcs/rfcsearch.html - 3. http://www.faqs.org/faqs/ - 4. http://www.faqs.org/contrib/ - 5. http://www.faqs.org/docs/ - 6. http://www.city-data.com/ - 7. http://www.faqs.org/ftp/rfc/rfc1350.txt - 8. http://www.faqs.org/ftp/rfc/pdf/rfc1350.txt.pdf - 9. http://www.faqs.org/rfcs/rfc783.html - 10. http://www.faqs.org/rfcs/rfc768.html - 11. http://www.faqs.org/rfcs/rfc764.html - 12. http://www.faqs.org/rfcs/rfc1123.html - 13. mailto:SOLLINS@LCS.MIT.EDU - 14. http://www.faqs.org/qa/rfcc-2889.html - 15. http://www.faqs.org/qa/rfcc-1841.html - 16. http://www.faqs.org/qa/rfcc-433.html - 17. http://www.faqs.org/qa/rfcc-1281.html - 18. http://www.faqs.org/qa/rfcc-255.html - 19. http://www.faqs.org/qa/rfcc-2798.html - 20. http://www.faqs.org/qa/rfcc-1734.html - 21. http://www.faqs.org/qa/rfcc-2297.html - 22. http://www.faqs.org/qa/rfcc-1916.html - 23. http://www.faqs.org/qa/rfcc-2933.html - 24. http://www.faqs.org/rfcs/rfc1349.html - 25. http://www.faqs.org/rfcs/rfc1351.html - 26. http://www.faqs.org/rfcs/ - 27. http://www.faqs.org/rfcs/rfcsearch.html - 28. http://www.faqs.org/faqs/ - 29. http://www.faqs.org/contrib/ - 30. http://www.faqs.org/docs/ - 31. http://www.city-data.com/ diff --git a/doc/rfc2347.txt b/doc/rfc2347.txt deleted file mode 100644 index dbc0f8c..0000000 --- a/doc/rfc2347.txt +++ /dev/null @@ -1,395 +0,0 @@ - - - - - - -Network Working Group G. Malkin -Request for Commments: 2347 Bay Networks -Updates: 1350 A. Harkin -Obsoletes: 1782 Hewlett Packard Co. -Category: Standards Track May 1998 - - - TFTP Option Extension - -Status of this Memo - - This document specifies an Internet standards track protocol for the - Internet community, and requests discussion and suggestions for - improvements. Please refer to the current edition of the "Internet - Official Protocol Standards" (STD 1) for the standardization state - and status of this protocol. Distribution of this memo is unlimited. - -Copyright Notice - - Copyright (C) The Internet Society (1998). All Rights Reserved. - -Abstract - - The Trivial File Transfer Protocol [1] is a simple, lock-step, file - transfer protocol which allows a client to get or put a file onto a - remote host. This document describes a simple extension to TFTP to - allow option negotiation prior to the file transfer. - -Introduction - - The option negotiation mechanism proposed in this document is a - backward-compatible extension to the TFTP protocol. It allows file - transfer options to be negotiated prior to the transfer using a - mechanism which is consistent with TFTP's Request Packet format. The - mechanism is kept simple by enforcing a request-respond-acknowledge - sequence, similar to the lock-step approach taken by TFTP itself. - - While the option negotiation mechanism is general purpose, in that - many types of options may be negotiated, it was created to support - the Blocksize option defined in [2]. Additional options are defined - in [3]. - -Packet Formats - - TFTP options are appended to the Read Request and Write Request - packets. A new type of TFTP packet, the Option Acknowledgment - (OACK), is used to acknowledge a client's option negotiation request. - A new error code, 8, is hereby defined to indicate that a transfer - - - -Malkin & Harkin Standards Track [Page 1] - -RFC 2347 TFTP Option Extension May 1998 - - - should be terminated due to option negotiation. - - Options are appended to a TFTP Read Request or Write Request packet - as follows: - - +-------+---~~---+---+---~~---+---+---~~---+---+---~~---+---+--> - | opc |filename| 0 | mode | 0 | opt1 | 0 | value1 | 0 | < - +-------+---~~---+---+---~~---+---+---~~---+---+---~~---+---+--> - - >-------+---+---~~---+---+ - < optN | 0 | valueN | 0 | - >-------+---+---~~---+---+ - - opc - The opcode field contains either a 1, for Read Requests, or 2, - for Write Requests, as defined in [1]. - - filename - The name of the file to be read or written, as defined in [1]. - This is a NULL-terminated field. - - mode - The mode of the file transfer: "netascii", "octet", or "mail", - as defined in [1]. This is a NULL-terminated field. - - opt1 - The first option, in case-insensitive ASCII (e.g., blksize). - This is a NULL-terminated field. - - value1 - The value associated with the first option, in case- - insensitive ASCII. This is a NULL-terminated field. - - optN, valueN - The final option/value pair. Each NULL-terminated field is - specified in case-insensitive ASCII. - - The options and values are all NULL-terminated, in keeping with the - original request format. If multiple options are to be negotiated, - they are appended to each other. The order in which options are - specified is not significant. The maximum size of a request packet - is 512 octets. - - The OACK packet has the following format: - - - - - - - -Malkin & Harkin Standards Track [Page 2] - -RFC 2347 TFTP Option Extension May 1998 - - - +-------+---~~---+---+---~~---+---+---~~---+---+---~~---+---+ - | opc | opt1 | 0 | value1 | 0 | optN | 0 | valueN | 0 | - +-------+---~~---+---+---~~---+---+---~~---+---+---~~---+---+ - - opc - The opcode field contains a 6, for Option Acknowledgment. - - opt1 - The first option acknowledgment, copied from the original - request. - - value1 - The acknowledged value associated with the first option. If - and how this value may differ from the original request is - detailed in the specification for the option. - - optN, valueN - The final option/value acknowledgment pair. - -Negotiation Protocol - - The client appends options at the end of the Read Request or Write - request packet, as shown above. Any number of options may be - specified; however, an option may only be specified once. The order - of the options is not significant. - - If the server supports option negotiation, and it recognizes one or - more of the options specified in the request packet, the server may - respond with an Options Acknowledgment (OACK). Each option the - server recognizes, and accepts the value for, is included in the - OACK. Some options may allow alternate values to be proposed, but - this is an option specific feature. The server must not include in - the OACK any option which had not been specifically requested by the - client; that is, only the client may initiate option negotiation. - Options which the server does not support should be omitted from the - OACK; they should not cause an ERROR packet to be generated. If the - value of a supported option is invalid, the specification for that - option will indicate whether the server should simply omit the option - from the OACK, respond with an alternate value, or send an ERROR - packet, with error code 8, to terminate the transfer. - - An option not acknowledged by the server must be ignored by the - client and server as if it were never requested. If multiple options - were requested, the client must use those options which were - acknowledged by the server and must not use those options which were - not acknowledged by the server. - - - - - -Malkin & Harkin Standards Track [Page 3] - -RFC 2347 TFTP Option Extension May 1998 - - - When the client appends options to the end of a Read Request packet, - three possible responses may be returned by the server: - - OACK - acknowledge of Read Request and the options; - - DATA - acknowledge of Read Request, but not the options; - - ERROR - the request has been denied. - - When the client appends options to the end of a Write Request packet, - three possible responses may be returned by the server: - - OACK - acknowledge of Write Request and the options; - - ACK - acknowledge of Write Request, but not the options; - - ERROR - the request has been denied. - - If a server implementation does not support option negotiation, it - will likely ignore any options appended to the client's request. In - this case, the server will return a DATA packet for a Read Request - and an ACK packet for a Write Request establishing normal TFTP data - transfer. In the event that a server returns an error for a request - which carries an option, the client may attempt to repeat the request - without appending any options. This implementation option would - handle servers which consider extraneous data in the request packet - to be erroneous. - - Depending on the original transfer request there are two ways for a - client to confirm acceptance of a server's OACK. If the transfer was - initiated with a Read Request, then an ACK (with the data block - number set to 0) is sent by the client to confirm the values in the - server's OACK packet. If the transfer was initiated with a Write - Request, then the client begins the transfer with the first DATA - packet, using the negotiated values. If the client rejects the OACK, - then it sends an ERROR packet, with error code 8, to the server and - the transfer is terminated. - - Once a client acknowledges an OACK, with an appropriate non-error - response, that client has agreed to use only the options and values - returned by the server. Remember that the server cannot request an - option; it can only respond to them. If the client receives an OACK - containing an unrequested option, it should respond with an ERROR - packet, with error code 8, and terminate the transfer. - - - - - - - -Malkin & Harkin Standards Track [Page 4] - -RFC 2347 TFTP Option Extension May 1998 - - -Examples - - Read Request - - client server - ------------------------------------------------------- - |1|foofile|0|octet|0|blksize|0|1432|0| --> RRQ - <-- |6|blksize|0|1432|0| OACK - |4|0| --> ACK - <-- |3|1| 1432 octets of data | DATA - |4|1| --> ACK - <-- |3|2| 1432 octets of data | DATA - |4|2| --> ACK - <-- |3|3|<1432 octets of data | DATA - |4|3| --> ACK - - Write Request - - client server - ------------------------------------------------------- - |2|barfile|0|octet|0|blksize|0|2048|0| --> RRQ - <-- |6|blksize|0|2048|0| OACK - |3|1| 2048 octets of data | --> DATA - <-- |4|1| ACK - |3|2| 2048 octets of data | --> DATA - <-- |4|2| ACK - |3|3|<2048 octets of data | --> DATA - <-- |4|3| ACK - -Security Considerations - - The basic TFTP protocol has no security mechanism. This is why it - has no rename, delete, or file overwrite capabilities. This document - does not add any security to TFTP; however, the specified extensions - do not add any additional security risks. - -References - - [1] Sollins, K., "The TFTP Protocol (Revision 2)", STD 33, RFC 1350, - October 1992. - - [2] Malkin, G., and A. Harkin, "TFTP Blocksize Option", RFC 2348, - May 1998. - - [3] Malkin, G., and A. Harkin, "TFTP Timeout Interval and Transfer - Size Options", RFC 2349, May 1998. - - - - - -Malkin & Harkin Standards Track [Page 5] - -RFC 2347 TFTP Option Extension May 1998 - - -Authors' Addresses - - Gary Scott Malkin - Bay Networks - 8 Federal Street - Billerica, MA 01821 - - Phone: (978) 916-4237 - EMail: gmalkin@baynetworks.com - - - Art Harkin - Internet Services Project - Information Networks Division - 19420 Homestead Road MS 43LN - Cupertino, CA 95014 - - Phone: (408) 447-3755 - EMail: ash@cup.hp.com - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -Malkin & Harkin Standards Track [Page 6] - -RFC 2347 TFTP Option Extension May 1998 - - -Full Copyright Statement - - Copyright (C) The Internet Society (1998). All Rights Reserved. - - This document and translations of it may be copied and furnished to - others, and derivative works that comment on or otherwise explain it - or assist in its implementation may be prepared, copied, published - and distributed, in whole or in part, without restriction of any - kind, provided that the above copyright notice and this paragraph are - included on all such copies and derivative works. However, this - document itself may not be modified in any way, such as by removing - the copyright notice or references to the Internet Society or other - Internet organizations, except as needed for the purpose of - developing Internet standards in which case the procedures for - copyrights defined in the Internet Standards process must be - followed, or as required to translate it into languages other than - English. - - The limited permissions granted above are perpetual and will not be - revoked by the Internet Society or its successors or assigns. - - This document and the information contained herein is provided on an - "AS IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING - TASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING - BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION - HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF - MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. - - - - - - - - - - - - - - - - - - - - - - - - -Malkin & Harkin Standards Track [Page 7] - diff --git a/doc/rfc2348.txt b/doc/rfc2348.txt deleted file mode 100644 index b38c56d..0000000 --- a/doc/rfc2348.txt +++ /dev/null @@ -1,283 +0,0 @@ - - - - - - -Network Working Group G. Malkin -Request for Commments: 2348 Bay Networks -Updates: 1350 A. Harkin -Obsoletes: 1783 Hewlett Packard Co. -Category: Standards Track May 1998 - - - TFTP Blocksize Option - -Status of this Memo - - This document specifies an Internet standards track protocol for the - Internet community, and requests discussion and suggestions for - improvements. Please refer to the current edition of the "Internet - Official Protocol Standards" (STD 1) for the standardization state - and status of this protocol. Distribution of this memo is unlimited. - -Copyright Notice - - Copyright (C) The Internet Society (1998). All Rights Reserved. - -Abstract - - The Trivial File Transfer Protocol [1] is a simple, lock-step, file - transfer protocol which allows a client to get or put a file onto a - remote host. One of its primary uses is the booting of diskless - nodes on a Local Area Network. TFTP is used because it is very - simple to implement in a small node's limited ROM space. However, - the choice of a 512-octet blocksize is not the most efficient for use - on a LAN whose MTU may 1500 octets or greater. - - This document describes a TFTP option which allows the client and - server to negotiate a blocksize more applicable to the network - medium. The TFTP Option Extension mechanism is described in [2]. - -Blocksize Option Specification - - The TFTP Read Request or Write Request packet is modified to include - the blocksize option as follows. Note that all fields except "opc" - are NULL-terminated. - - +-------+---~~---+---+---~~---+---+---~~---+---+---~~---+---+ - | opc |filename| 0 | mode | 0 | blksize| 0 | #octets| 0 | - +-------+---~~---+---+---~~---+---+---~~---+---+---~~---+---+ - - opc - The opcode field contains either a 1, for Read Requests, or 2, - for Write Requests, as defined in [1]. - - - -Malkin & Harkin Standards Track [Page 1] - -RFC 2348 TFTP Blocksize Option May 1998 - - - filename - The name of the file to be read or written, as defined in [1]. - - mode - The mode of the file transfer: "netascii", "octet", or "mail", - as defined in [1]. - - blksize - The Blocksize option, "blksize" (case in-sensitive). - - #octets - The number of octets in a block, specified in ASCII. Valid - values range between "8" and "65464" octets, inclusive. The - blocksize refers to the number of data octets; it does not - include the four octets of TFTP header. - - For example: - - +-------+--------+---+--------+---+--------+---+--------+---+ - | 1 | foobar | 0 | octet | 0 | blksize| 0 | 1428 | 0 | - +-------+--------+---+--------+---+--------+---+--------+---+ - - is a Read Request, for the file named "foobar", in octet (binary) - transfer mode, with a block size of 1428 octets (Ethernet MTU, less - the TFTP, UDP and IP header lengths). - - If the server is willing to accept the blocksize option, it sends an - Option Acknowledgment (OACK) to the client. The specified value must - be less than or equal to the value specified by the client. The - client must then either use the size specified in the OACK, or send - an ERROR packet, with error code 8, to terminate the transfer. - - The rules for determining the final packet are unchanged from [1]. - The reception of a data packet with a data length less than the - negotiated blocksize is the final packet. If the blocksize is - greater than the amount of data to be transfered, the first packet is - the final packet. If the amount of data to be transfered is an - integral multiple of the blocksize, an extra data packet containing - no data is sent to end the transfer. - -Proof of Concept - - Performance tests were run on the prototype implementation using a - variety of block sizes. The tests were run on a lightly loaded - Ethernet, between two HP-UX 9000, in "octet" mode, on 2.25MB files. - The average (5x) transfer times for paths with (g-time) and without - (n-time) a intermediate gateway are graphed as follows: - - - - -Malkin & Harkin Standards Track [Page 2] - -RFC 2348 TFTP Blocksize Option May 1998 - - - | - 37 + g - | - 35 + - | - 33 + - | - 31 + - | - 29 + - | - 27 + - | g blocksize n-time g-time - 25 + --------- ------ ------ - s | n 512 23.85 37.05 - e 23 + g 1024 16.15 25.65 - c | 1428 13.70 23.10 - o 21 + 2048 10.90 16.90 - n | 4096 6.85 9.65 - d 19 + 8192 4.90 6.15 - s | - 17 + g - | n - 15 + - | n - 13 + - | - 11 + n - | g - 9 + - | - 7 + n - | g - 5 + n - " - 0 +------+------+--+---+------+------+--- - 512 1K | 2K 4K 8K - 1428 - blocksize (octets) - - The comparisons between transfer times (without a gateway) between - the standard 512-octet blocksize and the negotiated blocksizes are: - - 1024 2x -32% - 1428 2.8x -42% - 2048 4x -54% - 4096 8x -71% - 8192 16x -80% - - - -Malkin & Harkin Standards Track [Page 3] - -RFC 2348 TFTP Blocksize Option May 1998 - - - As was anticipated, the transfer time decreases with an increase in - blocksize. The reason for the reduction in time is the reduction in - the number of packets sent. For example, by increasing the blocksize - from 512 octets to 1024 octets, not only are the number of data - packets halved, but the number of acknowledgement packets is also - halved (along with the number of times the data transmitter must wait - for an ACK). A secondary effect is the efficiency gained by reducing - the per-packet framing and processing overhead. - - Of course, if the blocksize exceeds the path MTU, IP fragmentation - and reassembly will begin to add more overhead. This will be more - noticable the greater the number of gateways in the path. - -Security Considerations - - The basic TFTP protocol has no security mechanism. This is why it - has no rename, delete, or file overwrite capabilities. This document - does not add any security to TFTP; however, the specified extensions - do not add any additional security risks. - -References - - [1] Sollins, K., "The TFTP Protocol (Revision 2)", STD 33, RFC 1350, - October 1992. - - [2] Malkin, G., and A. Harkin, "TFTP Option Extension", RFC 2347, - May 1998. - -Authors' Addresses - - Gary Scott Malkin - Bay Networks - 8 Federal Street - Billerica, MA 10821 - - Phone: (978) 916-4237 - EMail: gmalkin@baynetworks.com - - - Art Harkin - Networked Computing Division - Hewlett-Packard Company - 19420 Homestead Road MS 43LN - Cupertino, CA 95014 - - Phone: (408) 447-3755 - EMail: ash@cup.hp.com - - - - -Malkin & Harkin Standards Track [Page 4] - -RFC 2348 TFTP Blocksize Option May 1998 - - -Full Copyright Statement - - Copyright (C) The Internet Society (1998). All Rights Reserved. - - This document and translations of it may be copied and furnished to - others, and derivative works that comment on or otherwise explain it - or assist in its implementation may be prepared, copied, published - and distributed, in whole or in part, without restriction of any - kind, provided that the above copyright notice and this paragraph are - included on all such copies and derivative works. However, this - document itself may not be modified in any way, such as by removing - the copyright notice or references to the Internet Society or other - Internet organizations, except as needed for the purpose of - developing Internet standards in which case the procedures for - copyrights defined in the Internet Standards process must be - followed, or as required to translate it into languages other than - English. - - The limited permissions granted above are perpetual and will not be - revoked by the Internet Society or its successors or assigns. - - This document and the information contained herein is provided on an - "AS IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING - TASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING - BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION - HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF - MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. - - - - - - - - - - - - - - - - - - - - - - - - -Malkin & Harkin Standards Track [Page 5] - diff --git a/doc/rfc2349.txt b/doc/rfc2349.txt deleted file mode 100644 index 31abb3e..0000000 --- a/doc/rfc2349.txt +++ /dev/null @@ -1,283 +0,0 @@ - - - - - - -Network Working Group G. Malkin -Request for Commments: 2349 Bay Networks -Updates: 1350 A. Harkin -Obsoletes: 1784 Hewlett Packard Co. -Category: Standards Track May 1998 - - - TFTP Timeout Interval and Transfer Size Options - -Status of this Memo - - This document specifies an Internet standards track protocol for the - Internet community, and requests discussion and suggestions for - improvements. Please refer to the current edition of the "Internet - Official Protocol Standards" (STD 1) for the standardization state - and status of this protocol. Distribution of this memo is unlimited. - -Copyright Notice - - Copyright (C) The Internet Society (1998). All Rights Reserved. - -Abstract - - The Trivial File Transfer Protocol [1] is a simple, lock-step, file - transfer protocol which allows a client to get or put a file onto a - remote host. - - This document describes two TFTP options. The first allows the client - and server to negotiate the Timeout Interval. The second allows the - side receiving the file to determine the ultimate size of the - transfer before it begins. The TFTP Option Extension mechanism is - described in [2]. - -Timeout Interval Option Specification - - The TFTP Read Request or Write Request packet is modified to include - the timeout option as follows: - - +-------+---~~---+---+---~~---+---+---~~---+---+---~~---+---+ - | opc |filename| 0 | mode | 0 | timeout| 0 | #secs | 0 | - +-------+---~~---+---+---~~---+---+---~~---+---+---~~---+---+ - - opc - The opcode field contains either a 1, for Read Requests, or 2, - for Write Requests, as defined in [1]. - - - - - - -Malkin & Harkin Standards Track [Page 1] - -RFC 2349 TFTP Timeout Interval and Transfer Size Options May 1998 - - - filename - The name of the file to be read or written, as defined in [1]. - This is a NULL-terminated field. - - mode - The mode of the file transfer: "netascii", "octet", or "mail", - as defined in [1]. This is a NULL-terminated field. - - timeout - The Timeout Interval option, "timeout" (case in-sensitive). - This is a NULL-terminated field. - - #secs - The number of seconds to wait before retransmitting, specified - in ASCII. Valid values range between "1" and "255" seconds, - inclusive. This is a NULL-terminated field. - - For example: - - +-------+--------+---+--------+---+--------+---+-------+---+ - | 1 | foobar | 0 | octet | 0 | timeout| 0 | 1 | 0 | - +-------+--------+---+--------+---+--------+---+-------+---+ - - is a Read Request, for the file named "foobar", in octet (binary) - transfer mode, with a timeout interval of 1 second. - - If the server is willing to accept the timeout option, it sends an - Option Acknowledgment (OACK) to the client. The specified timeout - value must match the value specified by the client. - -Transfer Size Option Specification - - The TFTP Read Request or Write Request packet is modified to include - the tsize option as follows: - - +-------+---~~---+---+---~~---+---+---~~---+---+---~~---+---+ - | opc |filename| 0 | mode | 0 | tsize | 0 | size | 0 | - +-------+---~~---+---+---~~---+---+---~~---+---+---~~---+---+ - - opc - The opcode field contains either a 1, for Read Requests, or 2, - for Write Requests, as defined in [1]. - - filename - The name of the file to be read or written, as defined in [1]. - This is a NULL-terminated field. - - - - - -Malkin & Harkin Standards Track [Page 2] - -RFC 2349 TFTP Timeout Interval and Transfer Size Options May 1998 - - - mode - The mode of the file transfer: "netascii", "octet", or "mail", - as defined in [1]. This is a NULL-terminated field. - - tsize - The Transfer Size option, "tsize" (case in-sensitive). This is - a NULL-terminated field. - - size - The size of the file to be transfered. This is a NULL- - terminated field. - - For example: - - +-------+--------+---+--------+---+--------+---+--------+---+ - | 2 | foobar | 0 | octet | 0 | tsize | 0 | 673312 | 0 | - +-------+--------+---+--------+---+--------+---+--------+---+ - - is a Write Request, with the 673312-octet file named "foobar", in - octet (binary) transfer mode. - - In Read Request packets, a size of "0" is specified in the request - and the size of the file, in octets, is returned in the OACK. If the - file is too large for the client to handle, it may abort the transfer - with an Error packet (error code 3). In Write Request packets, the - size of the file, in octets, is specified in the request and echoed - back in the OACK. If the file is too large for the server to handle, - it may abort the transfer with an Error packet (error code 3). - -Security Considerations - - The basic TFTP protocol has no security mechanism. This is why it - has no rename, delete, or file overwrite capabilities. This document - does not add any security to TFTP; however, the specified extensions - do not add any additional security risks. - -References - - [1] Sollins, K., "The TFTP Protocol (Revision 2)", STD 33, RFC 1350, - October 92. - - [2] Malkin, G., and A. Harkin, "TFTP Option Extension", RFC 2347, - May 1998. - - - - - - - - -Malkin & Harkin Standards Track [Page 3] - -RFC 2349 TFTP Timeout Interval and Transfer Size Options May 1998 - - -Authors' Addresses - - Gary Scott Malkin - Bay Networks - 8 Federal Street - Billerica, MA 01821 - - Phone: (978) 916-4237 - EMail: gmalkin@baynetworks.com - - - Art Harkin - Internet Services Project - Information Networks Division - 19420 Homestead Road MS 43LN - Cupertino, CA 95014 - - Phone: (408) 447-3755 - EMail: ash@cup.hp.com - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -Malkin & Harkin Standards Track [Page 4] - -RFC 2349 TFTP Timeout Interval and Transfer Size Options May 1998 - - -Full Copyright Statement - - Copyright (C) The Internet Society (1998). All Rights Reserved. - - This document and translations of it may be copied and furnished to - others, and derivative works that comment on or otherwise explain it - or assist in its implementation may be prepared, copied, published - and distributed, in whole or in part, without restriction of any - kind, provided that the above copyright notice and this paragraph are - included on all such copies and derivative works. However, this - document itself may not be modified in any way, such as by removing - the copyright notice or references to the Internet Society or other - Internet organizations, except as needed for the purpose of - developing Internet standards in which case the procedures for - copyrights defined in the Internet Standards process must be - followed, or as required to translate it into languages other than - English. - - The limited permissions granted above are perpetual and will not be - revoked by the Internet Society or its successors or assigns. - - This document and the information contained herein is provided on an - "AS IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING - TASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING - BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION - HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF - MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. - - - - - - - - - - - - - - - - - - - - - - - - -Malkin & Harkin Standards Track [Page 5] - diff --git a/html/index.html b/html/index.html deleted file mode 100644 index da9765e..0000000 --- a/html/index.html +++ /dev/null @@ -1,150 +0,0 @@ - - - - - TFTPy - A Pure Python TFTP Protocol Implementation - - - - - -
- -

About TFTPy

-

- TFTPy is a pure Python implementation of the - Trivial FTP protocol. -

-

- I wrote it because the VoIP company that I work for uses TFTP to - pull firmware loads for our sets, and at times when this doesn't - work we use a Windows-based diagnostic tool to troubleshoot the - connection. -

-

- As all of the computers in my home run some flavour of Linux or FreeBSD, this tool - wasn't much use to me, so I started one of my own. I decided to - use Python since it's - comfortable and available for the platforms that I care about, and - was surprised to not find a pre-existing TFTP library for it. So, - I wrote one, and here it is. It's not 1.0 yet, but downloading is - production-ready IMHO, as some of the people using it tell me. -

- - -

Features

-

At this time, it supports the following RFCs: -

    -
  • - 1350 - The TFTP Protocol, revision 2 (octet mode only) -
  • -
  • - 2347 - TFTP Option Extension -
  • -
  • - 2348 - TFTP Blocksize Option -
  • -
  • - 2349 - TFTP Timeout Interval and Transfer Size Options (just the - tsize option right now) -
  • -
-

- - -

Future Plans

-

- I do have plans for this code before a 1.0 release, including the - following: -

    -
  • Full RFC 1350 compliance, including netascii mode (I could - care less about "mail" mode).
  • -
  • Symmetric UDP support. I don't know of an RFC for this but - it's a no-brainer for NAT traversal. In this mode the server - should always respond on the port that the RRQ was sent to, so - stateful firewalls will permit the response.
  • -
  • Documentation!
  • -
-

- -
-

The Code

-

- You can find the latest release at the SourceForge Project Page, as a - source tarball. It should also be in PyPi, so you can use - easy_install if you prefer. -

- -

- The latest code though is always on the master branch in Github. I did use SVN in SourceForge - for a while, but after discovering Git I couldn't go back. To - clone the repository, run the following command using git -

-    git clone git://github.com/msoulier/tftpy.git
-        
- Patches welcome, even if I can't guarantee response time. You can - of course send me the url of a public git repository to pull from - as well. -

- -

The Github project page is right - here.

-

- - -

Support

-

- SourceForge doesn't make the mailing list easy to find, so - here - is a direct link if you'd like to join.

-

- Feel free to email me - with any questions, or contact me through github. -

- -

- To submit a bug report, please use the - issue tracker - in the Github project page. I've shut down the trackers at - sourceforge for now. -

- - -

Documentation

-

- I am working on some documentation via the - Sphinx project. The current - ones are here. -

- -
- -

Last updated: May 10, 2010.

-
- - diff --git a/html/main.css b/html/main.css deleted file mode 100644 index e8079bc..0000000 --- a/html/main.css +++ /dev/null @@ -1,31 +0,0 @@ -.banner { - top: 0; - width: 100%; - height: 100px; - text-align: center; -} - -.menu { - position: absolute; - left: 0; - top: 100px; - width: 200px; - margin: 10px 10px 10px 10px; -} - -.menu li { - list-style-type: circle; -} - -.content { - position: absolute; - left: 200px; - right: 0; - top: 100px; - margin: 10px 10px 10px 10px; -} - -body { - font-family: arial, verdana, sans-serif; - background: white; -} diff --git a/html/sphinx/_sources/index.txt b/html/sphinx/_sources/index.txt deleted file mode 100644 index 6e59eba..0000000 --- a/html/sphinx/_sources/index.txt +++ /dev/null @@ -1,114 +0,0 @@ -.. TFTPy documentation master file, created by - sphinx-quickstart on Sun Jul 11 18:48:32 2010. - You can adapt this file completely to your liking, but it should at least - contain the root `toctree` directive. - -TFTPy -===== - -TFTPy is a pure python TFTP implementation. - -.. toctree:: - :maxdepth: 2 - -* :ref:`genindex` -* :ref:`modindex` -* :ref:`search` - -Requirements -============ -Python 2.3+, I think. I haven't tested in Python 2.3 in a while but it should -still work. Let me know if it doesn't. - -Installation -============ -If you download the source distribution, you can simply use distutils to -install, via:: - - python setup.py build - python setup.py install - -Or, as this has been uploaded to pypi, you can use easy_install or pip:: - - easy_install tftpy - pip install tftpy - -Once installed you should have the sample client and server scripts in bin, -and you should be able to import the `tftpy` module. - -Examples -======== -The simplest tftp client:: - - import tftpy - - client = tftpy.TftpClient('tftp.digitaltorque.ca', 69) - client.download('remote_filename', 'local_filename') - -The simplest tftp server:: - - import tftpy - - server = tftpy.TftpServer('/tftpboot') - server.listen('0.0.0.0', 69) - -See the sample client and server for slightly more complex examples. - -API Documentation -================= - -Front-end Modules ------------------ -These modules are the ones that you will need to use directly to implement a -TFTP client or server. - -The :mod:`tftpy` Module -~~~~~~~~~~~~~~~~~~~~~~~ -.. automodule:: tftpy - :members: - :show-inheritance: - -The `TftpClient` Module -~~~~~~~~~~~~~~~~~~~~~~~ -.. automodule:: tftpy.TftpClient - :members: - :show-inheritance: - -The `TftpServer` Module -~~~~~~~~~~~~~~~~~~~~~~~ -.. automodule:: tftpy.TftpServer - :members: - :show-inheritance: - -Back-end Modules ----------------- - -The `TftpPacketFactory` Module -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.. automodule:: tftpy.TftpPacketFactory - :members: - :show-inheritance: - -The `TftpPacketTypes` Module -~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.. automodule:: tftpy.TftpPacketTypes - :members: - :show-inheritance: - -The `TftpShared` Module -~~~~~~~~~~~~~~~~~~~~~~~ -.. automodule:: tftpy.TftpShared - :members: - :show-inheritance: - -The `TftpContexts` Module -~~~~~~~~~~~~~~~~~~~~~~~~~ -.. automodule:: tftpy.TftpContexts - :members: - :show-inheritance: - -The `TftpStates` Module -~~~~~~~~~~~~~~~~~~~~~~~ -.. automodule:: tftpy.TftpStates - :members: - :show-inheritance: diff --git a/html/sphinx/_static/basic.css b/html/sphinx/_static/basic.css deleted file mode 100644 index 32630d5..0000000 --- a/html/sphinx/_static/basic.css +++ /dev/null @@ -1,528 +0,0 @@ -/* - * basic.css - * ~~~~~~~~~ - * - * Sphinx stylesheet -- basic theme. - * - * :copyright: Copyright 2007-2011 by the Sphinx team, see AUTHORS. - * :license: BSD, see LICENSE for details. - * - */ - -/* -- main layout ----------------------------------------------------------- */ - -div.clearer { - clear: both; -} - -/* -- relbar ---------------------------------------------------------------- */ - -div.related { - width: 100%; - font-size: 90%; -} - -div.related h3 { - display: none; -} - -div.related ul { - margin: 0; - padding: 0 0 0 10px; - list-style: none; -} - -div.related li { - display: inline; -} - -div.related li.right { - float: right; - margin-right: 5px; -} - -/* -- sidebar --------------------------------------------------------------- */ - -div.sphinxsidebarwrapper { - padding: 10px 5px 0 10px; -} - -div.sphinxsidebar { - float: left; - width: 230px; - margin-left: -100%; - font-size: 90%; -} - -div.sphinxsidebar ul { - list-style: none; -} - -div.sphinxsidebar ul ul, -div.sphinxsidebar ul.want-points { - margin-left: 20px; - list-style: square; -} - -div.sphinxsidebar ul ul { - margin-top: 0; - margin-bottom: 0; -} - -div.sphinxsidebar form { - margin-top: 10px; -} - -div.sphinxsidebar input { - border: 1px solid #98dbcc; - font-family: sans-serif; - font-size: 1em; -} - -img { - border: 0; -} - -/* -- search page ----------------------------------------------------------- */ - -ul.search { - margin: 10px 0 0 20px; - padding: 0; -} - -ul.search li { - padding: 5px 0 5px 20px; - background-image: url(file.png); - background-repeat: no-repeat; - background-position: 0 7px; -} - -ul.search li a { - font-weight: bold; -} - -ul.search li div.context { - color: #888; - margin: 2px 0 0 30px; - text-align: left; -} - -ul.keywordmatches li.goodmatch a { - font-weight: bold; -} - -/* -- index page ------------------------------------------------------------ */ - -table.contentstable { - width: 90%; -} - -table.contentstable p.biglink { - line-height: 150%; -} - -a.biglink { - font-size: 1.3em; -} - -span.linkdescr { - font-style: italic; - padding-top: 5px; - font-size: 90%; -} - -/* -- general index --------------------------------------------------------- */ - -table.indextable { - width: 100%; -} - -table.indextable td { - text-align: left; - vertical-align: top; -} - -table.indextable dl, table.indextable dd { - margin-top: 0; - margin-bottom: 0; -} - -table.indextable tr.pcap { - height: 10px; -} - -table.indextable tr.cap { - margin-top: 10px; - background-color: #f2f2f2; -} - -img.toggler { - margin-right: 3px; - margin-top: 3px; - cursor: pointer; -} - -div.modindex-jumpbox { - border-top: 1px solid #ddd; - border-bottom: 1px solid #ddd; - margin: 1em 0 1em 0; - padding: 0.4em; -} - -div.genindex-jumpbox { - border-top: 1px solid #ddd; - border-bottom: 1px solid #ddd; - margin: 1em 0 1em 0; - padding: 0.4em; -} - -/* -- general body styles --------------------------------------------------- */ - -a.headerlink { - visibility: hidden; -} - -h1:hover > a.headerlink, -h2:hover > a.headerlink, -h3:hover > a.headerlink, -h4:hover > a.headerlink, -h5:hover > a.headerlink, -h6:hover > a.headerlink, -dt:hover > a.headerlink { - visibility: visible; -} - -div.body p.caption { - text-align: inherit; -} - -div.body td { - text-align: left; -} - -.field-list ul { - padding-left: 1em; -} - -.first { - margin-top: 0 !important; -} - -p.rubric { - margin-top: 30px; - font-weight: bold; -} - -img.align-left, .figure.align-left, object.align-left { - clear: left; - float: left; - margin-right: 1em; -} - -img.align-right, .figure.align-right, object.align-right { - clear: right; - float: right; - margin-left: 1em; -} - -img.align-center, .figure.align-center, object.align-center { - display: block; - margin-left: auto; - margin-right: auto; -} - -.align-left { - text-align: left; -} - -.align-center { - clear: both; - text-align: center; -} - -.align-right { - text-align: right; -} - -/* -- sidebars -------------------------------------------------------------- */ - -div.sidebar { - margin: 0 0 0.5em 1em; - border: 1px solid #ddb; - padding: 7px 7px 0 7px; - background-color: #ffe; - width: 40%; - float: right; -} - -p.sidebar-title { - font-weight: bold; -} - -/* -- topics ---------------------------------------------------------------- */ - -div.topic { - border: 1px solid #ccc; - padding: 7px 7px 0 7px; - margin: 10px 0 10px 0; -} - -p.topic-title { - font-size: 1.1em; - font-weight: bold; - margin-top: 10px; -} - -/* -- admonitions ----------------------------------------------------------- */ - -div.admonition { - margin-top: 10px; - margin-bottom: 10px; - padding: 7px; -} - -div.admonition dt { - font-weight: bold; -} - -div.admonition dl { - margin-bottom: 0; -} - -p.admonition-title { - margin: 0px 10px 5px 0px; - font-weight: bold; -} - -div.body p.centered { - text-align: center; - margin-top: 25px; -} - -/* -- tables ---------------------------------------------------------------- */ - -table.docutils { - border: 0; - border-collapse: collapse; -} - -table.docutils td, table.docutils th { - padding: 1px 8px 1px 5px; - border-top: 0; - border-left: 0; - border-right: 0; - border-bottom: 1px solid #aaa; -} - -table.field-list td, table.field-list th { - border: 0 !important; -} - -table.footnote td, table.footnote th { - border: 0 !important; -} - -th { - text-align: left; - padding-right: 5px; -} - -table.citation { - border-left: solid 1px gray; - margin-left: 1px; -} - -table.citation td { - border-bottom: none; -} - -/* -- other body styles ----------------------------------------------------- */ - -ol.arabic { - list-style: decimal; -} - -ol.loweralpha { - list-style: lower-alpha; -} - -ol.upperalpha { - list-style: upper-alpha; -} - -ol.lowerroman { - list-style: lower-roman; -} - -ol.upperroman { - list-style: upper-roman; -} - -dl { - margin-bottom: 15px; -} - -dd p { - margin-top: 0px; -} - -dd ul, dd table { - margin-bottom: 10px; -} - -dd { - margin-top: 3px; - margin-bottom: 10px; - margin-left: 30px; -} - -dt:target, .highlighted { - background-color: #fbe54e; -} - -dl.glossary dt { - font-weight: bold; - font-size: 1.1em; -} - -.field-list ul { - margin: 0; - padding-left: 1em; -} - -.field-list p { - margin: 0; -} - -.refcount { - color: #060; -} - -.optional { - font-size: 1.3em; -} - -.versionmodified { - font-style: italic; -} - -.system-message { - background-color: #fda; - padding: 5px; - border: 3px solid red; -} - -.footnote:target { - background-color: #ffa; -} - -.line-block { - display: block; - margin-top: 1em; - margin-bottom: 1em; -} - -.line-block .line-block { - margin-top: 0; - margin-bottom: 0; - margin-left: 1.5em; -} - -.guilabel, .menuselection { - font-family: sans-serif; -} - -.accelerator { - text-decoration: underline; -} - -.classifier { - font-style: oblique; -} - -/* -- code displays --------------------------------------------------------- */ - -pre { - overflow: auto; - overflow-y: hidden; /* fixes display issues on Chrome browsers */ -} - -td.linenos pre { - padding: 5px 0px; - border: 0; - background-color: transparent; - color: #aaa; -} - -table.highlighttable { - margin-left: 0.5em; -} - -table.highlighttable td { - padding: 0 0.5em 0 0.5em; -} - -tt.descname { - background-color: transparent; - font-weight: bold; - font-size: 1.2em; -} - -tt.descclassname { - background-color: transparent; -} - -tt.xref, a tt { - background-color: transparent; - font-weight: bold; -} - -h1 tt, h2 tt, h3 tt, h4 tt, h5 tt, h6 tt { - background-color: transparent; -} - -.viewcode-link { - float: right; -} - -.viewcode-back { - float: right; - font-family: sans-serif; -} - -div.viewcode-block:target { - margin: -1px -10px; - padding: 0 10px; -} - -/* -- math display ---------------------------------------------------------- */ - -img.math { - vertical-align: middle; -} - -div.body div.math p { - text-align: center; -} - -span.eqno { - float: right; -} - -/* -- printout stylesheet --------------------------------------------------- */ - -@media print { - div.document, - div.documentwrapper, - div.bodywrapper { - margin: 0 !important; - width: 100%; - } - - div.sphinxsidebar, - div.related, - div.footer, - #top-link { - display: none; - } -} diff --git a/html/sphinx/_static/default.css b/html/sphinx/_static/default.css deleted file mode 100644 index 21f3f50..0000000 --- a/html/sphinx/_static/default.css +++ /dev/null @@ -1,256 +0,0 @@ -/* - * default.css_t - * ~~~~~~~~~~~~~ - * - * Sphinx stylesheet -- default theme. - * - * :copyright: Copyright 2007-2011 by the Sphinx team, see AUTHORS. - * :license: BSD, see LICENSE for details. - * - */ - -@import url("basic.css"); - -/* -- page layout ----------------------------------------------------------- */ - -body { - font-family: sans-serif; - font-size: 100%; - background-color: #11303d; - color: #000; - margin: 0; - padding: 0; -} - -div.document { - background-color: #1c4e63; -} - -div.documentwrapper { - float: left; - width: 100%; -} - -div.bodywrapper { - margin: 0 0 0 230px; -} - -div.body { - background-color: #ffffff; - color: #000000; - padding: 0 20px 30px 20px; -} - -div.footer { - color: #ffffff; - width: 100%; - padding: 9px 0 9px 0; - text-align: center; - font-size: 75%; -} - -div.footer a { - color: #ffffff; - text-decoration: underline; -} - -div.related { - background-color: #133f52; - line-height: 30px; - color: #ffffff; -} - -div.related a { - color: #ffffff; -} - -div.sphinxsidebar { -} - -div.sphinxsidebar h3 { - font-family: 'Trebuchet MS', sans-serif; - color: #ffffff; - font-size: 1.4em; - font-weight: normal; - margin: 0; - padding: 0; -} - -div.sphinxsidebar h3 a { - color: #ffffff; -} - -div.sphinxsidebar h4 { - font-family: 'Trebuchet MS', sans-serif; - color: #ffffff; - font-size: 1.3em; - font-weight: normal; - margin: 5px 0 0 0; - padding: 0; -} - -div.sphinxsidebar p { - color: #ffffff; -} - -div.sphinxsidebar p.topless { - margin: 5px 10px 10px 10px; -} - -div.sphinxsidebar ul { - margin: 10px; - padding: 0; - color: #ffffff; -} - -div.sphinxsidebar a { - color: #98dbcc; -} - -div.sphinxsidebar input { - border: 1px solid #98dbcc; - font-family: sans-serif; - font-size: 1em; -} - - - -/* -- hyperlink styles ------------------------------------------------------ */ - -a { - color: #355f7c; - text-decoration: none; -} - -a:visited { - color: #355f7c; - text-decoration: none; -} - -a:hover { - text-decoration: underline; -} - - - -/* -- body styles ----------------------------------------------------------- */ - -div.body h1, -div.body h2, -div.body h3, -div.body h4, -div.body h5, -div.body h6 { - font-family: 'Trebuchet MS', sans-serif; - background-color: #f2f2f2; - font-weight: normal; - color: #20435c; - border-bottom: 1px solid #ccc; - margin: 20px -20px 10px -20px; - padding: 3px 0 3px 10px; -} - -div.body h1 { margin-top: 0; font-size: 200%; } -div.body h2 { font-size: 160%; } -div.body h3 { font-size: 140%; } -div.body h4 { font-size: 120%; } -div.body h5 { font-size: 110%; } -div.body h6 { font-size: 100%; } - -a.headerlink { - color: #c60f0f; - font-size: 0.8em; - padding: 0 4px 0 4px; - text-decoration: none; -} - -a.headerlink:hover { - background-color: #c60f0f; - color: white; -} - -div.body p, div.body dd, div.body li { - text-align: justify; - line-height: 130%; -} - -div.admonition p.admonition-title + p { - display: inline; -} - -div.admonition p { - margin-bottom: 5px; -} - -div.admonition pre { - margin-bottom: 5px; -} - -div.admonition ul, div.admonition ol { - margin-bottom: 5px; -} - -div.note { - background-color: #eee; - border: 1px solid #ccc; -} - -div.seealso { - background-color: #ffc; - border: 1px solid #ff6; -} - -div.topic { - background-color: #eee; -} - -div.warning { - background-color: #ffe4e4; - border: 1px solid #f66; -} - -p.admonition-title { - display: inline; -} - -p.admonition-title:after { - content: ":"; -} - -pre { - padding: 5px; - background-color: #eeffcc; - color: #333333; - line-height: 120%; - border: 1px solid #ac9; - border-left: none; - border-right: none; -} - -tt { - background-color: #ecf0f3; - padding: 0 1px 0 1px; - font-size: 0.95em; -} - -th { - background-color: #ede; -} - -.warning tt { - background: #efc2c2; -} - -.note tt { - background: #d6d6d6; -} - -.viewcode-back { - font-family: sans-serif; -} - -div.viewcode-block:target { - background-color: #f4debf; - border-top: 1px solid #ac9; - border-bottom: 1px solid #ac9; -} \ No newline at end of file diff --git a/html/sphinx/_static/doctools.js b/html/sphinx/_static/doctools.js deleted file mode 100644 index 8b9bd2c..0000000 --- a/html/sphinx/_static/doctools.js +++ /dev/null @@ -1,247 +0,0 @@ -/* - * doctools.js - * ~~~~~~~~~~~ - * - * Sphinx JavaScript utilties for all documentation. - * - * :copyright: Copyright 2007-2011 by the Sphinx team, see AUTHORS. - * :license: BSD, see LICENSE for details. - * - */ - -/** - * select a different prefix for underscore - */ -$u = _.noConflict(); - -/** - * make the code below compatible with browsers without - * an installed firebug like debugger -if (!window.console || !console.firebug) { - var names = ["log", "debug", "info", "warn", "error", "assert", "dir", - "dirxml", "group", "groupEnd", "time", "timeEnd", "count", "trace", - "profile", "profileEnd"]; - window.console = {}; - for (var i = 0; i < names.length; ++i) - window.console[names[i]] = function() {}; -} - */ - -/** - * small helper function to urldecode strings - */ -jQuery.urldecode = function(x) { - return decodeURIComponent(x).replace(/\+/g, ' '); -} - -/** - * small helper function to urlencode strings - */ -jQuery.urlencode = encodeURIComponent; - -/** - * This function returns the parsed url parameters of the - * current request. Multiple values per key are supported, - * it will always return arrays of strings for the value parts. - */ -jQuery.getQueryParameters = function(s) { - if (typeof s == 'undefined') - s = document.location.search; - var parts = s.substr(s.indexOf('?') + 1).split('&'); - var result = {}; - for (var i = 0; i < parts.length; i++) { - var tmp = parts[i].split('=', 2); - var key = jQuery.urldecode(tmp[0]); - var value = jQuery.urldecode(tmp[1]); - if (key in result) - result[key].push(value); - else - result[key] = [value]; - } - return result; -}; - -/** - * small function to check if an array contains - * a given item. - */ -jQuery.contains = function(arr, item) { - for (var i = 0; i < arr.length; i++) { - if (arr[i] == item) - return true; - } - return false; -}; - -/** - * highlight a given string on a jquery object by wrapping it in - * span elements with the given class name. - */ -jQuery.fn.highlightText = function(text, className) { - function highlight(node) { - if (node.nodeType == 3) { - var val = node.nodeValue; - var pos = val.toLowerCase().indexOf(text); - if (pos >= 0 && !jQuery(node.parentNode).hasClass(className)) { - var span = document.createElement("span"); - span.className = className; - span.appendChild(document.createTextNode(val.substr(pos, text.length))); - node.parentNode.insertBefore(span, node.parentNode.insertBefore( - document.createTextNode(val.substr(pos + text.length)), - node.nextSibling)); - node.nodeValue = val.substr(0, pos); - } - } - else if (!jQuery(node).is("button, select, textarea")) { - jQuery.each(node.childNodes, function() { - highlight(this); - }); - } - } - return this.each(function() { - highlight(this); - }); -}; - -/** - * Small JavaScript module for the documentation. - */ -var Documentation = { - - init : function() { - this.fixFirefoxAnchorBug(); - this.highlightSearchWords(); - this.initIndexTable(); - }, - - /** - * i18n support - */ - TRANSLATIONS : {}, - PLURAL_EXPR : function(n) { return n == 1 ? 0 : 1; }, - LOCALE : 'unknown', - - // gettext and ngettext don't access this so that the functions - // can safely bound to a different name (_ = Documentation.gettext) - gettext : function(string) { - var translated = Documentation.TRANSLATIONS[string]; - if (typeof translated == 'undefined') - return string; - return (typeof translated == 'string') ? translated : translated[0]; - }, - - ngettext : function(singular, plural, n) { - var translated = Documentation.TRANSLATIONS[singular]; - if (typeof translated == 'undefined') - return (n == 1) ? singular : plural; - return translated[Documentation.PLURALEXPR(n)]; - }, - - addTranslations : function(catalog) { - for (var key in catalog.messages) - this.TRANSLATIONS[key] = catalog.messages[key]; - this.PLURAL_EXPR = new Function('n', 'return +(' + catalog.plural_expr + ')'); - this.LOCALE = catalog.locale; - }, - - /** - * add context elements like header anchor links - */ - addContextElements : function() { - $('div[id] > :header:first').each(function() { - $('\u00B6'). - attr('href', '#' + this.id). - attr('title', _('Permalink to this headline')). - appendTo(this); - }); - $('dt[id]').each(function() { - $('\u00B6'). - attr('href', '#' + this.id). - attr('title', _('Permalink to this definition')). - appendTo(this); - }); - }, - - /** - * workaround a firefox stupidity - */ - fixFirefoxAnchorBug : function() { - if (document.location.hash && $.browser.mozilla) - window.setTimeout(function() { - document.location.href += ''; - }, 10); - }, - - /** - * highlight the search words provided in the url in the text - */ - highlightSearchWords : function() { - var params = $.getQueryParameters(); - var terms = (params.highlight) ? params.highlight[0].split(/\s+/) : []; - if (terms.length) { - var body = $('div.body'); - window.setTimeout(function() { - $.each(terms, function() { - body.highlightText(this.toLowerCase(), 'highlighted'); - }); - }, 10); - $('') - .appendTo($('.sidebar .this-page-menu')); - } - }, - - /** - * init the domain index toggle buttons - */ - initIndexTable : function() { - var togglers = $('img.toggler').click(function() { - var src = $(this).attr('src'); - var idnum = $(this).attr('id').substr(7); - $('tr.cg-' + idnum).toggle(); - if (src.substr(-9) == 'minus.png') - $(this).attr('src', src.substr(0, src.length-9) + 'plus.png'); - else - $(this).attr('src', src.substr(0, src.length-8) + 'minus.png'); - }).css('display', ''); - if (DOCUMENTATION_OPTIONS.COLLAPSE_INDEX) { - togglers.click(); - } - }, - - /** - * helper function to hide the search marks again - */ - hideSearchWords : function() { - $('.sidebar .this-page-menu li.highlight-link').fadeOut(300); - $('span.highlighted').removeClass('highlighted'); - }, - - /** - * make the url absolute - */ - makeURL : function(relativeURL) { - return DOCUMENTATION_OPTIONS.URL_ROOT + '/' + relativeURL; - }, - - /** - * get the current relative url - */ - getCurrentURL : function() { - var path = document.location.pathname; - var parts = path.split(/\//); - $.each(DOCUMENTATION_OPTIONS.URL_ROOT.split(/\//), function() { - if (this == '..') - parts.pop(); - }); - var url = parts.join('/'); - return path.substring(url.lastIndexOf('/') + 1, path.length - 1); - } -}; - -// quick alias for translations -_ = Documentation.gettext; - -$(document).ready(function() { - Documentation.init(); -}); diff --git a/html/sphinx/_static/file.png b/html/sphinx/_static/file.png deleted file mode 100644 index d18082e397e7e54f20721af768c4c2983258f1b4..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 392 zcmeAS@N?(olHy`uVBq!ia0vp^0wB!61|;P_|4#%`Y)RhkE)4%caKYZ?lYt_f1s;*b z3=G`DAk4@xYmNj^kiEpy*OmP$HyOL$D9)yc9|lc|nKf<9@eUiWd>3GuTC!a5vdfWYEazjncPj5ZQX%+1 zt8B*4=d)!cdDz4wr^#OMYfqGz$1LDFF>|#>*O?AGil(WEs?wLLy{Gj2J_@opDm%`dlax3yA*@*N$G&*ukFv>P8+2CBWO(qz zD0k1@kN>hhb1_6`&wrCswzINE(evt-5C1B^STi2@PmdKI;Vst0PQB6!2kdN diff --git a/html/sphinx/_static/jquery.js b/html/sphinx/_static/jquery.js deleted file mode 100644 index 7c24308..0000000 --- a/html/sphinx/_static/jquery.js +++ /dev/null @@ -1,154 +0,0 @@ -/*! - * jQuery JavaScript Library v1.4.2 - * http://jquery.com/ - * - * Copyright 2010, John Resig - * Dual licensed under the MIT or GPL Version 2 licenses. - * http://jquery.org/license - * - * Includes Sizzle.js - * http://sizzlejs.com/ - * Copyright 2010, The Dojo Foundation - * Released under the MIT, BSD, and GPL Licenses. - * - * Date: Sat Feb 13 22:33:48 2010 -0500 - */ -(function(A,w){function ma(){if(!c.isReady){try{s.documentElement.doScroll("left")}catch(a){setTimeout(ma,1);return}c.ready()}}function Qa(a,b){b.src?c.ajax({url:b.src,async:false,dataType:"script"}):c.globalEval(b.text||b.textContent||b.innerHTML||"");b.parentNode&&b.parentNode.removeChild(b)}function X(a,b,d,f,e,j){var i=a.length;if(typeof b==="object"){for(var o in b)X(a,o,b[o],f,e,d);return a}if(d!==w){f=!j&&f&&c.isFunction(d);for(o=0;o)[^>]*$|^#([\w-]+)$/,Ua=/^.[^:#\[\.,]*$/,Va=/\S/, -Wa=/^(\s|\u00A0)+|(\s|\u00A0)+$/g,Xa=/^<(\w+)\s*\/?>(?:<\/\1>)?$/,P=navigator.userAgent,xa=false,Q=[],L,$=Object.prototype.toString,aa=Object.prototype.hasOwnProperty,ba=Array.prototype.push,R=Array.prototype.slice,ya=Array.prototype.indexOf;c.fn=c.prototype={init:function(a,b){var d,f;if(!a)return this;if(a.nodeType){this.context=this[0]=a;this.length=1;return this}if(a==="body"&&!b){this.context=s;this[0]=s.body;this.selector="body";this.length=1;return this}if(typeof a==="string")if((d=Ta.exec(a))&& -(d[1]||!b))if(d[1]){f=b?b.ownerDocument||b:s;if(a=Xa.exec(a))if(c.isPlainObject(b)){a=[s.createElement(a[1])];c.fn.attr.call(a,b,true)}else a=[f.createElement(a[1])];else{a=sa([d[1]],[f]);a=(a.cacheable?a.fragment.cloneNode(true):a.fragment).childNodes}return c.merge(this,a)}else{if(b=s.getElementById(d[2])){if(b.id!==d[2])return T.find(a);this.length=1;this[0]=b}this.context=s;this.selector=a;return this}else if(!b&&/^\w+$/.test(a)){this.selector=a;this.context=s;a=s.getElementsByTagName(a);return c.merge(this, -a)}else return!b||b.jquery?(b||T).find(a):c(b).find(a);else if(c.isFunction(a))return T.ready(a);if(a.selector!==w){this.selector=a.selector;this.context=a.context}return c.makeArray(a,this)},selector:"",jquery:"1.4.2",length:0,size:function(){return this.length},toArray:function(){return R.call(this,0)},get:function(a){return a==null?this.toArray():a<0?this.slice(a)[0]:this[a]},pushStack:function(a,b,d){var f=c();c.isArray(a)?ba.apply(f,a):c.merge(f,a);f.prevObject=this;f.context=this.context;if(b=== -"find")f.selector=this.selector+(this.selector?" ":"")+d;else if(b)f.selector=this.selector+"."+b+"("+d+")";return f},each:function(a,b){return c.each(this,a,b)},ready:function(a){c.bindReady();if(c.isReady)a.call(s,c);else Q&&Q.push(a);return this},eq:function(a){return a===-1?this.slice(a):this.slice(a,+a+1)},first:function(){return this.eq(0)},last:function(){return this.eq(-1)},slice:function(){return this.pushStack(R.apply(this,arguments),"slice",R.call(arguments).join(","))},map:function(a){return this.pushStack(c.map(this, -function(b,d){return a.call(b,d,b)}))},end:function(){return this.prevObject||c(null)},push:ba,sort:[].sort,splice:[].splice};c.fn.init.prototype=c.fn;c.extend=c.fn.extend=function(){var a=arguments[0]||{},b=1,d=arguments.length,f=false,e,j,i,o;if(typeof a==="boolean"){f=a;a=arguments[1]||{};b=2}if(typeof a!=="object"&&!c.isFunction(a))a={};if(d===b){a=this;--b}for(;b
a"; -var e=d.getElementsByTagName("*"),j=d.getElementsByTagName("a")[0];if(!(!e||!e.length||!j)){c.support={leadingWhitespace:d.firstChild.nodeType===3,tbody:!d.getElementsByTagName("tbody").length,htmlSerialize:!!d.getElementsByTagName("link").length,style:/red/.test(j.getAttribute("style")),hrefNormalized:j.getAttribute("href")==="/a",opacity:/^0.55$/.test(j.style.opacity),cssFloat:!!j.style.cssFloat,checkOn:d.getElementsByTagName("input")[0].value==="on",optSelected:s.createElement("select").appendChild(s.createElement("option")).selected, -parentNode:d.removeChild(d.appendChild(s.createElement("div"))).parentNode===null,deleteExpando:true,checkClone:false,scriptEval:false,noCloneEvent:true,boxModel:null};b.type="text/javascript";try{b.appendChild(s.createTextNode("window."+f+"=1;"))}catch(i){}a.insertBefore(b,a.firstChild);if(A[f]){c.support.scriptEval=true;delete A[f]}try{delete b.test}catch(o){c.support.deleteExpando=false}a.removeChild(b);if(d.attachEvent&&d.fireEvent){d.attachEvent("onclick",function k(){c.support.noCloneEvent= -false;d.detachEvent("onclick",k)});d.cloneNode(true).fireEvent("onclick")}d=s.createElement("div");d.innerHTML="";a=s.createDocumentFragment();a.appendChild(d.firstChild);c.support.checkClone=a.cloneNode(true).cloneNode(true).lastChild.checked;c(function(){var k=s.createElement("div");k.style.width=k.style.paddingLeft="1px";s.body.appendChild(k);c.boxModel=c.support.boxModel=k.offsetWidth===2;s.body.removeChild(k).style.display="none"});a=function(k){var n= -s.createElement("div");k="on"+k;var r=k in n;if(!r){n.setAttribute(k,"return;");r=typeof n[k]==="function"}return r};c.support.submitBubbles=a("submit");c.support.changeBubbles=a("change");a=b=d=e=j=null}})();c.props={"for":"htmlFor","class":"className",readonly:"readOnly",maxlength:"maxLength",cellspacing:"cellSpacing",rowspan:"rowSpan",colspan:"colSpan",tabindex:"tabIndex",usemap:"useMap",frameborder:"frameBorder"};var G="jQuery"+J(),Ya=0,za={};c.extend({cache:{},expando:G,noData:{embed:true,object:true, -applet:true},data:function(a,b,d){if(!(a.nodeName&&c.noData[a.nodeName.toLowerCase()])){a=a==A?za:a;var f=a[G],e=c.cache;if(!f&&typeof b==="string"&&d===w)return null;f||(f=++Ya);if(typeof b==="object"){a[G]=f;e[f]=c.extend(true,{},b)}else if(!e[f]){a[G]=f;e[f]={}}a=e[f];if(d!==w)a[b]=d;return typeof b==="string"?a[b]:a}},removeData:function(a,b){if(!(a.nodeName&&c.noData[a.nodeName.toLowerCase()])){a=a==A?za:a;var d=a[G],f=c.cache,e=f[d];if(b){if(e){delete e[b];c.isEmptyObject(e)&&c.removeData(a)}}else{if(c.support.deleteExpando)delete a[c.expando]; -else a.removeAttribute&&a.removeAttribute(c.expando);delete f[d]}}}});c.fn.extend({data:function(a,b){if(typeof a==="undefined"&&this.length)return c.data(this[0]);else if(typeof a==="object")return this.each(function(){c.data(this,a)});var d=a.split(".");d[1]=d[1]?"."+d[1]:"";if(b===w){var f=this.triggerHandler("getData"+d[1]+"!",[d[0]]);if(f===w&&this.length)f=c.data(this[0],a);return f===w&&d[1]?this.data(d[0]):f}else return this.trigger("setData"+d[1]+"!",[d[0],b]).each(function(){c.data(this, -a,b)})},removeData:function(a){return this.each(function(){c.removeData(this,a)})}});c.extend({queue:function(a,b,d){if(a){b=(b||"fx")+"queue";var f=c.data(a,b);if(!d)return f||[];if(!f||c.isArray(d))f=c.data(a,b,c.makeArray(d));else f.push(d);return f}},dequeue:function(a,b){b=b||"fx";var d=c.queue(a,b),f=d.shift();if(f==="inprogress")f=d.shift();if(f){b==="fx"&&d.unshift("inprogress");f.call(a,function(){c.dequeue(a,b)})}}});c.fn.extend({queue:function(a,b){if(typeof a!=="string"){b=a;a="fx"}if(b=== -w)return c.queue(this[0],a);return this.each(function(){var d=c.queue(this,a,b);a==="fx"&&d[0]!=="inprogress"&&c.dequeue(this,a)})},dequeue:function(a){return this.each(function(){c.dequeue(this,a)})},delay:function(a,b){a=c.fx?c.fx.speeds[a]||a:a;b=b||"fx";return this.queue(b,function(){var d=this;setTimeout(function(){c.dequeue(d,b)},a)})},clearQueue:function(a){return this.queue(a||"fx",[])}});var Aa=/[\n\t]/g,ca=/\s+/,Za=/\r/g,$a=/href|src|style/,ab=/(button|input)/i,bb=/(button|input|object|select|textarea)/i, -cb=/^(a|area)$/i,Ba=/radio|checkbox/;c.fn.extend({attr:function(a,b){return X(this,a,b,true,c.attr)},removeAttr:function(a){return this.each(function(){c.attr(this,a,"");this.nodeType===1&&this.removeAttribute(a)})},addClass:function(a){if(c.isFunction(a))return this.each(function(n){var r=c(this);r.addClass(a.call(this,n,r.attr("class")))});if(a&&typeof a==="string")for(var b=(a||"").split(ca),d=0,f=this.length;d-1)return true;return false},val:function(a){if(a===w){var b=this[0];if(b){if(c.nodeName(b,"option"))return(b.attributes.value||{}).specified?b.value:b.text;if(c.nodeName(b,"select")){var d=b.selectedIndex,f=[],e=b.options;b=b.type==="select-one";if(d<0)return null;var j=b?d:0;for(d=b?d+1:e.length;j=0;else if(c.nodeName(this,"select")){var u=c.makeArray(r);c("option",this).each(function(){this.selected= -c.inArray(c(this).val(),u)>=0});if(!u.length)this.selectedIndex=-1}else this.value=r}})}});c.extend({attrFn:{val:true,css:true,html:true,text:true,data:true,width:true,height:true,offset:true},attr:function(a,b,d,f){if(!a||a.nodeType===3||a.nodeType===8)return w;if(f&&b in c.attrFn)return c(a)[b](d);f=a.nodeType!==1||!c.isXMLDoc(a);var e=d!==w;b=f&&c.props[b]||b;if(a.nodeType===1){var j=$a.test(b);if(b in a&&f&&!j){if(e){b==="type"&&ab.test(a.nodeName)&&a.parentNode&&c.error("type property can't be changed"); -a[b]=d}if(c.nodeName(a,"form")&&a.getAttributeNode(b))return a.getAttributeNode(b).nodeValue;if(b==="tabIndex")return(b=a.getAttributeNode("tabIndex"))&&b.specified?b.value:bb.test(a.nodeName)||cb.test(a.nodeName)&&a.href?0:w;return a[b]}if(!c.support.style&&f&&b==="style"){if(e)a.style.cssText=""+d;return a.style.cssText}e&&a.setAttribute(b,""+d);a=!c.support.hrefNormalized&&f&&j?a.getAttribute(b,2):a.getAttribute(b);return a===null?w:a}return c.style(a,b,d)}});var O=/\.(.*)$/,db=function(a){return a.replace(/[^\w\s\.\|`]/g, -function(b){return"\\"+b})};c.event={add:function(a,b,d,f){if(!(a.nodeType===3||a.nodeType===8)){if(a.setInterval&&a!==A&&!a.frameElement)a=A;var e,j;if(d.handler){e=d;d=e.handler}if(!d.guid)d.guid=c.guid++;if(j=c.data(a)){var i=j.events=j.events||{},o=j.handle;if(!o)j.handle=o=function(){return typeof c!=="undefined"&&!c.event.triggered?c.event.handle.apply(o.elem,arguments):w};o.elem=a;b=b.split(" ");for(var k,n=0,r;k=b[n++];){j=e?c.extend({},e):{handler:d,data:f};if(k.indexOf(".")>-1){r=k.split("."); -k=r.shift();j.namespace=r.slice(0).sort().join(".")}else{r=[];j.namespace=""}j.type=k;j.guid=d.guid;var u=i[k],z=c.event.special[k]||{};if(!u){u=i[k]=[];if(!z.setup||z.setup.call(a,f,r,o)===false)if(a.addEventListener)a.addEventListener(k,o,false);else a.attachEvent&&a.attachEvent("on"+k,o)}if(z.add){z.add.call(a,j);if(!j.handler.guid)j.handler.guid=d.guid}u.push(j);c.event.global[k]=true}a=null}}},global:{},remove:function(a,b,d,f){if(!(a.nodeType===3||a.nodeType===8)){var e,j=0,i,o,k,n,r,u,z=c.data(a), -C=z&&z.events;if(z&&C){if(b&&b.type){d=b.handler;b=b.type}if(!b||typeof b==="string"&&b.charAt(0)==="."){b=b||"";for(e in C)c.event.remove(a,e+b)}else{for(b=b.split(" ");e=b[j++];){n=e;i=e.indexOf(".")<0;o=[];if(!i){o=e.split(".");e=o.shift();k=new RegExp("(^|\\.)"+c.map(o.slice(0).sort(),db).join("\\.(?:.*\\.)?")+"(\\.|$)")}if(r=C[e])if(d){n=c.event.special[e]||{};for(B=f||0;B=0){a.type= -e=e.slice(0,-1);a.exclusive=true}if(!d){a.stopPropagation();c.event.global[e]&&c.each(c.cache,function(){this.events&&this.events[e]&&c.event.trigger(a,b,this.handle.elem)})}if(!d||d.nodeType===3||d.nodeType===8)return w;a.result=w;a.target=d;b=c.makeArray(b);b.unshift(a)}a.currentTarget=d;(f=c.data(d,"handle"))&&f.apply(d,b);f=d.parentNode||d.ownerDocument;try{if(!(d&&d.nodeName&&c.noData[d.nodeName.toLowerCase()]))if(d["on"+e]&&d["on"+e].apply(d,b)===false)a.result=false}catch(j){}if(!a.isPropagationStopped()&& -f)c.event.trigger(a,b,f,true);else if(!a.isDefaultPrevented()){f=a.target;var i,o=c.nodeName(f,"a")&&e==="click",k=c.event.special[e]||{};if((!k._default||k._default.call(d,a)===false)&&!o&&!(f&&f.nodeName&&c.noData[f.nodeName.toLowerCase()])){try{if(f[e]){if(i=f["on"+e])f["on"+e]=null;c.event.triggered=true;f[e]()}}catch(n){}if(i)f["on"+e]=i;c.event.triggered=false}}},handle:function(a){var b,d,f,e;a=arguments[0]=c.event.fix(a||A.event);a.currentTarget=this;b=a.type.indexOf(".")<0&&!a.exclusive; -if(!b){d=a.type.split(".");a.type=d.shift();f=new RegExp("(^|\\.)"+d.slice(0).sort().join("\\.(?:.*\\.)?")+"(\\.|$)")}e=c.data(this,"events");d=e[a.type];if(e&&d){d=d.slice(0);e=0;for(var j=d.length;e-1?c.map(a.options,function(f){return f.selected}).join("-"):"";else if(a.nodeName.toLowerCase()==="select")d=a.selectedIndex;return d},fa=function(a,b){var d=a.target,f,e;if(!(!da.test(d.nodeName)||d.readOnly)){f=c.data(d,"_change_data");e=Fa(d);if(a.type!=="focusout"||d.type!=="radio")c.data(d,"_change_data", -e);if(!(f===w||e===f))if(f!=null||e){a.type="change";return c.event.trigger(a,b,d)}}};c.event.special.change={filters:{focusout:fa,click:function(a){var b=a.target,d=b.type;if(d==="radio"||d==="checkbox"||b.nodeName.toLowerCase()==="select")return fa.call(this,a)},keydown:function(a){var b=a.target,d=b.type;if(a.keyCode===13&&b.nodeName.toLowerCase()!=="textarea"||a.keyCode===32&&(d==="checkbox"||d==="radio")||d==="select-multiple")return fa.call(this,a)},beforeactivate:function(a){a=a.target;c.data(a, -"_change_data",Fa(a))}},setup:function(){if(this.type==="file")return false;for(var a in ea)c.event.add(this,a+".specialChange",ea[a]);return da.test(this.nodeName)},teardown:function(){c.event.remove(this,".specialChange");return da.test(this.nodeName)}};ea=c.event.special.change.filters}s.addEventListener&&c.each({focus:"focusin",blur:"focusout"},function(a,b){function d(f){f=c.event.fix(f);f.type=b;return c.event.handle.call(this,f)}c.event.special[b]={setup:function(){this.addEventListener(a, -d,true)},teardown:function(){this.removeEventListener(a,d,true)}}});c.each(["bind","one"],function(a,b){c.fn[b]=function(d,f,e){if(typeof d==="object"){for(var j in d)this[b](j,f,d[j],e);return this}if(c.isFunction(f)){e=f;f=w}var i=b==="one"?c.proxy(e,function(k){c(this).unbind(k,i);return e.apply(this,arguments)}):e;if(d==="unload"&&b!=="one")this.one(d,f,e);else{j=0;for(var o=this.length;j0){y=t;break}}t=t[g]}m[q]=y}}}var f=/((?:\((?:\([^()]+\)|[^()]+)+\)|\[(?:\[[^[\]]*\]|['"][^'"]*['"]|[^[\]'"]+)+\]|\\.|[^ >+~,(\[\\]+)+|[>+~])(\s*,\s*)?((?:.|\r|\n)*)/g, -e=0,j=Object.prototype.toString,i=false,o=true;[0,0].sort(function(){o=false;return 0});var k=function(g,h,l,m){l=l||[];var q=h=h||s;if(h.nodeType!==1&&h.nodeType!==9)return[];if(!g||typeof g!=="string")return l;for(var p=[],v,t,y,S,H=true,M=x(h),I=g;(f.exec(""),v=f.exec(I))!==null;){I=v[3];p.push(v[1]);if(v[2]){S=v[3];break}}if(p.length>1&&r.exec(g))if(p.length===2&&n.relative[p[0]])t=ga(p[0]+p[1],h);else for(t=n.relative[p[0]]?[h]:k(p.shift(),h);p.length;){g=p.shift();if(n.relative[g])g+=p.shift(); -t=ga(g,t)}else{if(!m&&p.length>1&&h.nodeType===9&&!M&&n.match.ID.test(p[0])&&!n.match.ID.test(p[p.length-1])){v=k.find(p.shift(),h,M);h=v.expr?k.filter(v.expr,v.set)[0]:v.set[0]}if(h){v=m?{expr:p.pop(),set:z(m)}:k.find(p.pop(),p.length===1&&(p[0]==="~"||p[0]==="+")&&h.parentNode?h.parentNode:h,M);t=v.expr?k.filter(v.expr,v.set):v.set;if(p.length>0)y=z(t);else H=false;for(;p.length;){var D=p.pop();v=D;if(n.relative[D])v=p.pop();else D="";if(v==null)v=h;n.relative[D](y,v,M)}}else y=[]}y||(y=t);y||k.error(D|| -g);if(j.call(y)==="[object Array]")if(H)if(h&&h.nodeType===1)for(g=0;y[g]!=null;g++){if(y[g]&&(y[g]===true||y[g].nodeType===1&&E(h,y[g])))l.push(t[g])}else for(g=0;y[g]!=null;g++)y[g]&&y[g].nodeType===1&&l.push(t[g]);else l.push.apply(l,y);else z(y,l);if(S){k(S,q,l,m);k.uniqueSort(l)}return l};k.uniqueSort=function(g){if(B){i=o;g.sort(B);if(i)for(var h=1;h":function(g,h){var l=typeof h==="string";if(l&&!/\W/.test(h)){h=h.toLowerCase();for(var m=0,q=g.length;m=0))l||m.push(v);else if(l)h[p]=false;return false},ID:function(g){return g[1].replace(/\\/g,"")},TAG:function(g){return g[1].toLowerCase()}, -CHILD:function(g){if(g[1]==="nth"){var h=/(-?)(\d*)n((?:\+|-)?\d*)/.exec(g[2]==="even"&&"2n"||g[2]==="odd"&&"2n+1"||!/\D/.test(g[2])&&"0n+"+g[2]||g[2]);g[2]=h[1]+(h[2]||1)-0;g[3]=h[3]-0}g[0]=e++;return g},ATTR:function(g,h,l,m,q,p){h=g[1].replace(/\\/g,"");if(!p&&n.attrMap[h])g[1]=n.attrMap[h];if(g[2]==="~=")g[4]=" "+g[4]+" ";return g},PSEUDO:function(g,h,l,m,q){if(g[1]==="not")if((f.exec(g[3])||"").length>1||/^\w/.test(g[3]))g[3]=k(g[3],null,null,h);else{g=k.filter(g[3],h,l,true^q);l||m.push.apply(m, -g);return false}else if(n.match.POS.test(g[0])||n.match.CHILD.test(g[0]))return true;return g},POS:function(g){g.unshift(true);return g}},filters:{enabled:function(g){return g.disabled===false&&g.type!=="hidden"},disabled:function(g){return g.disabled===true},checked:function(g){return g.checked===true},selected:function(g){return g.selected===true},parent:function(g){return!!g.firstChild},empty:function(g){return!g.firstChild},has:function(g,h,l){return!!k(l[3],g).length},header:function(g){return/h\d/i.test(g.nodeName)}, -text:function(g){return"text"===g.type},radio:function(g){return"radio"===g.type},checkbox:function(g){return"checkbox"===g.type},file:function(g){return"file"===g.type},password:function(g){return"password"===g.type},submit:function(g){return"submit"===g.type},image:function(g){return"image"===g.type},reset:function(g){return"reset"===g.type},button:function(g){return"button"===g.type||g.nodeName.toLowerCase()==="button"},input:function(g){return/input|select|textarea|button/i.test(g.nodeName)}}, -setFilters:{first:function(g,h){return h===0},last:function(g,h,l,m){return h===m.length-1},even:function(g,h){return h%2===0},odd:function(g,h){return h%2===1},lt:function(g,h,l){return hl[3]-0},nth:function(g,h,l){return l[3]-0===h},eq:function(g,h,l){return l[3]-0===h}},filter:{PSEUDO:function(g,h,l,m){var q=h[1],p=n.filters[q];if(p)return p(g,l,h,m);else if(q==="contains")return(g.textContent||g.innerText||a([g])||"").indexOf(h[3])>=0;else if(q==="not"){h= -h[3];l=0;for(m=h.length;l=0}},ID:function(g,h){return g.nodeType===1&&g.getAttribute("id")===h},TAG:function(g,h){return h==="*"&&g.nodeType===1||g.nodeName.toLowerCase()===h},CLASS:function(g,h){return(" "+(g.className||g.getAttribute("class"))+" ").indexOf(h)>-1},ATTR:function(g,h){var l=h[1];g=n.attrHandle[l]?n.attrHandle[l](g):g[l]!=null?g[l]:g.getAttribute(l);l=g+"";var m=h[2];h=h[4];return g==null?m==="!=":m=== -"="?l===h:m==="*="?l.indexOf(h)>=0:m==="~="?(" "+l+" ").indexOf(h)>=0:!h?l&&g!==false:m==="!="?l!==h:m==="^="?l.indexOf(h)===0:m==="$="?l.substr(l.length-h.length)===h:m==="|="?l===h||l.substr(0,h.length+1)===h+"-":false},POS:function(g,h,l,m){var q=n.setFilters[h[2]];if(q)return q(g,l,h,m)}}},r=n.match.POS;for(var u in n.match){n.match[u]=new RegExp(n.match[u].source+/(?![^\[]*\])(?![^\(]*\))/.source);n.leftMatch[u]=new RegExp(/(^(?:.|\r|\n)*?)/.source+n.match[u].source.replace(/\\(\d+)/g,function(g, -h){return"\\"+(h-0+1)}))}var z=function(g,h){g=Array.prototype.slice.call(g,0);if(h){h.push.apply(h,g);return h}return g};try{Array.prototype.slice.call(s.documentElement.childNodes,0)}catch(C){z=function(g,h){h=h||[];if(j.call(g)==="[object Array]")Array.prototype.push.apply(h,g);else if(typeof g.length==="number")for(var l=0,m=g.length;l";var l=s.documentElement;l.insertBefore(g,l.firstChild);if(s.getElementById(h)){n.find.ID=function(m,q,p){if(typeof q.getElementById!=="undefined"&&!p)return(q=q.getElementById(m[1]))?q.id===m[1]||typeof q.getAttributeNode!=="undefined"&& -q.getAttributeNode("id").nodeValue===m[1]?[q]:w:[]};n.filter.ID=function(m,q){var p=typeof m.getAttributeNode!=="undefined"&&m.getAttributeNode("id");return m.nodeType===1&&p&&p.nodeValue===q}}l.removeChild(g);l=g=null})();(function(){var g=s.createElement("div");g.appendChild(s.createComment(""));if(g.getElementsByTagName("*").length>0)n.find.TAG=function(h,l){l=l.getElementsByTagName(h[1]);if(h[1]==="*"){h=[];for(var m=0;l[m];m++)l[m].nodeType===1&&h.push(l[m]);l=h}return l};g.innerHTML=""; -if(g.firstChild&&typeof g.firstChild.getAttribute!=="undefined"&&g.firstChild.getAttribute("href")!=="#")n.attrHandle.href=function(h){return h.getAttribute("href",2)};g=null})();s.querySelectorAll&&function(){var g=k,h=s.createElement("div");h.innerHTML="

";if(!(h.querySelectorAll&&h.querySelectorAll(".TEST").length===0)){k=function(m,q,p,v){q=q||s;if(!v&&q.nodeType===9&&!x(q))try{return z(q.querySelectorAll(m),p)}catch(t){}return g(m,q,p,v)};for(var l in g)k[l]=g[l];h=null}}(); -(function(){var g=s.createElement("div");g.innerHTML="
";if(!(!g.getElementsByClassName||g.getElementsByClassName("e").length===0)){g.lastChild.className="e";if(g.getElementsByClassName("e").length!==1){n.order.splice(1,0,"CLASS");n.find.CLASS=function(h,l,m){if(typeof l.getElementsByClassName!=="undefined"&&!m)return l.getElementsByClassName(h[1])};g=null}}})();var E=s.compareDocumentPosition?function(g,h){return!!(g.compareDocumentPosition(h)&16)}: -function(g,h){return g!==h&&(g.contains?g.contains(h):true)},x=function(g){return(g=(g?g.ownerDocument||g:0).documentElement)?g.nodeName!=="HTML":false},ga=function(g,h){var l=[],m="",q;for(h=h.nodeType?[h]:h;q=n.match.PSEUDO.exec(g);){m+=q[0];g=g.replace(n.match.PSEUDO,"")}g=n.relative[g]?g+"*":g;q=0;for(var p=h.length;q=0===d})};c.fn.extend({find:function(a){for(var b=this.pushStack("","find",a),d=0,f=0,e=this.length;f0)for(var j=d;j0},closest:function(a,b){if(c.isArray(a)){var d=[],f=this[0],e,j= -{},i;if(f&&a.length){e=0;for(var o=a.length;e-1:c(f).is(e)){d.push({selector:i,elem:f});delete j[i]}}f=f.parentNode}}return d}var k=c.expr.match.POS.test(a)?c(a,b||this.context):null;return this.map(function(n,r){for(;r&&r.ownerDocument&&r!==b;){if(k?k.index(r)>-1:c(r).is(a))return r;r=r.parentNode}return null})},index:function(a){if(!a||typeof a=== -"string")return c.inArray(this[0],a?c(a):this.parent().children());return c.inArray(a.jquery?a[0]:a,this)},add:function(a,b){a=typeof a==="string"?c(a,b||this.context):c.makeArray(a);b=c.merge(this.get(),a);return this.pushStack(qa(a[0])||qa(b[0])?b:c.unique(b))},andSelf:function(){return this.add(this.prevObject)}});c.each({parent:function(a){return(a=a.parentNode)&&a.nodeType!==11?a:null},parents:function(a){return c.dir(a,"parentNode")},parentsUntil:function(a,b,d){return c.dir(a,"parentNode", -d)},next:function(a){return c.nth(a,2,"nextSibling")},prev:function(a){return c.nth(a,2,"previousSibling")},nextAll:function(a){return c.dir(a,"nextSibling")},prevAll:function(a){return c.dir(a,"previousSibling")},nextUntil:function(a,b,d){return c.dir(a,"nextSibling",d)},prevUntil:function(a,b,d){return c.dir(a,"previousSibling",d)},siblings:function(a){return c.sibling(a.parentNode.firstChild,a)},children:function(a){return c.sibling(a.firstChild)},contents:function(a){return c.nodeName(a,"iframe")? -a.contentDocument||a.contentWindow.document:c.makeArray(a.childNodes)}},function(a,b){c.fn[a]=function(d,f){var e=c.map(this,b,d);eb.test(a)||(f=d);if(f&&typeof f==="string")e=c.filter(f,e);e=this.length>1?c.unique(e):e;if((this.length>1||gb.test(f))&&fb.test(a))e=e.reverse();return this.pushStack(e,a,R.call(arguments).join(","))}});c.extend({filter:function(a,b,d){if(d)a=":not("+a+")";return c.find.matches(a,b)},dir:function(a,b,d){var f=[];for(a=a[b];a&&a.nodeType!==9&&(d===w||a.nodeType!==1||!c(a).is(d));){a.nodeType=== -1&&f.push(a);a=a[b]}return f},nth:function(a,b,d){b=b||1;for(var f=0;a;a=a[d])if(a.nodeType===1&&++f===b)break;return a},sibling:function(a,b){for(var d=[];a;a=a.nextSibling)a.nodeType===1&&a!==b&&d.push(a);return d}});var Ja=/ jQuery\d+="(?:\d+|null)"/g,V=/^\s+/,Ka=/(<([\w:]+)[^>]*?)\/>/g,hb=/^(?:area|br|col|embed|hr|img|input|link|meta|param)$/i,La=/<([\w:]+)/,ib=/"},F={option:[1,""],legend:[1,"
","
"],thead:[1,"","
"],tr:[2,"","
"],td:[3,"","
"],col:[2,"","
"],area:[1,"",""],_default:[0,"",""]};F.optgroup=F.option;F.tbody=F.tfoot=F.colgroup=F.caption=F.thead;F.th=F.td;if(!c.support.htmlSerialize)F._default=[1,"div
","
"];c.fn.extend({text:function(a){if(c.isFunction(a))return this.each(function(b){var d= -c(this);d.text(a.call(this,b,d.text()))});if(typeof a!=="object"&&a!==w)return this.empty().append((this[0]&&this[0].ownerDocument||s).createTextNode(a));return c.text(this)},wrapAll:function(a){if(c.isFunction(a))return this.each(function(d){c(this).wrapAll(a.call(this,d))});if(this[0]){var b=c(a,this[0].ownerDocument).eq(0).clone(true);this[0].parentNode&&b.insertBefore(this[0]);b.map(function(){for(var d=this;d.firstChild&&d.firstChild.nodeType===1;)d=d.firstChild;return d}).append(this)}return this}, -wrapInner:function(a){if(c.isFunction(a))return this.each(function(b){c(this).wrapInner(a.call(this,b))});return this.each(function(){var b=c(this),d=b.contents();d.length?d.wrapAll(a):b.append(a)})},wrap:function(a){return this.each(function(){c(this).wrapAll(a)})},unwrap:function(){return this.parent().each(function(){c.nodeName(this,"body")||c(this).replaceWith(this.childNodes)}).end()},append:function(){return this.domManip(arguments,true,function(a){this.nodeType===1&&this.appendChild(a)})}, -prepend:function(){return this.domManip(arguments,true,function(a){this.nodeType===1&&this.insertBefore(a,this.firstChild)})},before:function(){if(this[0]&&this[0].parentNode)return this.domManip(arguments,false,function(b){this.parentNode.insertBefore(b,this)});else if(arguments.length){var a=c(arguments[0]);a.push.apply(a,this.toArray());return this.pushStack(a,"before",arguments)}},after:function(){if(this[0]&&this[0].parentNode)return this.domManip(arguments,false,function(b){this.parentNode.insertBefore(b, -this.nextSibling)});else if(arguments.length){var a=this.pushStack(this,"after",arguments);a.push.apply(a,c(arguments[0]).toArray());return a}},remove:function(a,b){for(var d=0,f;(f=this[d])!=null;d++)if(!a||c.filter(a,[f]).length){if(!b&&f.nodeType===1){c.cleanData(f.getElementsByTagName("*"));c.cleanData([f])}f.parentNode&&f.parentNode.removeChild(f)}return this},empty:function(){for(var a=0,b;(b=this[a])!=null;a++)for(b.nodeType===1&&c.cleanData(b.getElementsByTagName("*"));b.firstChild;)b.removeChild(b.firstChild); -return this},clone:function(a){var b=this.map(function(){if(!c.support.noCloneEvent&&!c.isXMLDoc(this)){var d=this.outerHTML,f=this.ownerDocument;if(!d){d=f.createElement("div");d.appendChild(this.cloneNode(true));d=d.innerHTML}return c.clean([d.replace(Ja,"").replace(/=([^="'>\s]+\/)>/g,'="$1">').replace(V,"")],f)[0]}else return this.cloneNode(true)});if(a===true){ra(this,b);ra(this.find("*"),b.find("*"))}return b},html:function(a){if(a===w)return this[0]&&this[0].nodeType===1?this[0].innerHTML.replace(Ja, -""):null;else if(typeof a==="string"&&!ta.test(a)&&(c.support.leadingWhitespace||!V.test(a))&&!F[(La.exec(a)||["",""])[1].toLowerCase()]){a=a.replace(Ka,Ma);try{for(var b=0,d=this.length;b0||e.cacheable||this.length>1?k.cloneNode(true):k)}o.length&&c.each(o,Qa)}return this}});c.fragments={};c.each({appendTo:"append",prependTo:"prepend",insertBefore:"before",insertAfter:"after",replaceAll:"replaceWith"},function(a,b){c.fn[a]=function(d){var f=[];d=c(d);var e=this.length===1&&this[0].parentNode;if(e&&e.nodeType===11&&e.childNodes.length===1&&d.length===1){d[b](this[0]); -return this}else{e=0;for(var j=d.length;e0?this.clone(true):this).get();c.fn[b].apply(c(d[e]),i);f=f.concat(i)}return this.pushStack(f,a,d.selector)}}});c.extend({clean:function(a,b,d,f){b=b||s;if(typeof b.createElement==="undefined")b=b.ownerDocument||b[0]&&b[0].ownerDocument||s;for(var e=[],j=0,i;(i=a[j])!=null;j++){if(typeof i==="number")i+="";if(i){if(typeof i==="string"&&!jb.test(i))i=b.createTextNode(i);else if(typeof i==="string"){i=i.replace(Ka,Ma);var o=(La.exec(i)||["", -""])[1].toLowerCase(),k=F[o]||F._default,n=k[0],r=b.createElement("div");for(r.innerHTML=k[1]+i+k[2];n--;)r=r.lastChild;if(!c.support.tbody){n=ib.test(i);o=o==="table"&&!n?r.firstChild&&r.firstChild.childNodes:k[1]===""&&!n?r.childNodes:[];for(k=o.length-1;k>=0;--k)c.nodeName(o[k],"tbody")&&!o[k].childNodes.length&&o[k].parentNode.removeChild(o[k])}!c.support.leadingWhitespace&&V.test(i)&&r.insertBefore(b.createTextNode(V.exec(i)[0]),r.firstChild);i=r.childNodes}if(i.nodeType)e.push(i);else e= -c.merge(e,i)}}if(d)for(j=0;e[j];j++)if(f&&c.nodeName(e[j],"script")&&(!e[j].type||e[j].type.toLowerCase()==="text/javascript"))f.push(e[j].parentNode?e[j].parentNode.removeChild(e[j]):e[j]);else{e[j].nodeType===1&&e.splice.apply(e,[j+1,0].concat(c.makeArray(e[j].getElementsByTagName("script"))));d.appendChild(e[j])}return e},cleanData:function(a){for(var b,d,f=c.cache,e=c.event.special,j=c.support.deleteExpando,i=0,o;(o=a[i])!=null;i++)if(d=o[c.expando]){b=f[d];if(b.events)for(var k in b.events)e[k]? -c.event.remove(o,k):Ca(o,k,b.handle);if(j)delete o[c.expando];else o.removeAttribute&&o.removeAttribute(c.expando);delete f[d]}}});var kb=/z-?index|font-?weight|opacity|zoom|line-?height/i,Na=/alpha\([^)]*\)/,Oa=/opacity=([^)]*)/,ha=/float/i,ia=/-([a-z])/ig,lb=/([A-Z])/g,mb=/^-?\d+(?:px)?$/i,nb=/^-?\d/,ob={position:"absolute",visibility:"hidden",display:"block"},pb=["Left","Right"],qb=["Top","Bottom"],rb=s.defaultView&&s.defaultView.getComputedStyle,Pa=c.support.cssFloat?"cssFloat":"styleFloat",ja= -function(a,b){return b.toUpperCase()};c.fn.css=function(a,b){return X(this,a,b,true,function(d,f,e){if(e===w)return c.curCSS(d,f);if(typeof e==="number"&&!kb.test(f))e+="px";c.style(d,f,e)})};c.extend({style:function(a,b,d){if(!a||a.nodeType===3||a.nodeType===8)return w;if((b==="width"||b==="height")&&parseFloat(d)<0)d=w;var f=a.style||a,e=d!==w;if(!c.support.opacity&&b==="opacity"){if(e){f.zoom=1;b=parseInt(d,10)+""==="NaN"?"":"alpha(opacity="+d*100+")";a=f.filter||c.curCSS(a,"filter")||"";f.filter= -Na.test(a)?a.replace(Na,b):b}return f.filter&&f.filter.indexOf("opacity=")>=0?parseFloat(Oa.exec(f.filter)[1])/100+"":""}if(ha.test(b))b=Pa;b=b.replace(ia,ja);if(e)f[b]=d;return f[b]},css:function(a,b,d,f){if(b==="width"||b==="height"){var e,j=b==="width"?pb:qb;function i(){e=b==="width"?a.offsetWidth:a.offsetHeight;f!=="border"&&c.each(j,function(){f||(e-=parseFloat(c.curCSS(a,"padding"+this,true))||0);if(f==="margin")e+=parseFloat(c.curCSS(a,"margin"+this,true))||0;else e-=parseFloat(c.curCSS(a, -"border"+this+"Width",true))||0})}a.offsetWidth!==0?i():c.swap(a,ob,i);return Math.max(0,Math.round(e))}return c.curCSS(a,b,d)},curCSS:function(a,b,d){var f,e=a.style;if(!c.support.opacity&&b==="opacity"&&a.currentStyle){f=Oa.test(a.currentStyle.filter||"")?parseFloat(RegExp.$1)/100+"":"";return f===""?"1":f}if(ha.test(b))b=Pa;if(!d&&e&&e[b])f=e[b];else if(rb){if(ha.test(b))b="float";b=b.replace(lb,"-$1").toLowerCase();e=a.ownerDocument.defaultView;if(!e)return null;if(a=e.getComputedStyle(a,null))f= -a.getPropertyValue(b);if(b==="opacity"&&f==="")f="1"}else if(a.currentStyle){d=b.replace(ia,ja);f=a.currentStyle[b]||a.currentStyle[d];if(!mb.test(f)&&nb.test(f)){b=e.left;var j=a.runtimeStyle.left;a.runtimeStyle.left=a.currentStyle.left;e.left=d==="fontSize"?"1em":f||0;f=e.pixelLeft+"px";e.left=b;a.runtimeStyle.left=j}}return f},swap:function(a,b,d){var f={};for(var e in b){f[e]=a.style[e];a.style[e]=b[e]}d.call(a);for(e in b)a.style[e]=f[e]}});if(c.expr&&c.expr.filters){c.expr.filters.hidden=function(a){var b= -a.offsetWidth,d=a.offsetHeight,f=a.nodeName.toLowerCase()==="tr";return b===0&&d===0&&!f?true:b>0&&d>0&&!f?false:c.curCSS(a,"display")==="none"};c.expr.filters.visible=function(a){return!c.expr.filters.hidden(a)}}var sb=J(),tb=//gi,ub=/select|textarea/i,vb=/color|date|datetime|email|hidden|month|number|password|range|search|tel|text|time|url|week/i,N=/=\?(&|$)/,ka=/\?/,wb=/(\?|&)_=.*?(&|$)/,xb=/^(\w+:)?\/\/([^\/?#]+)/,yb=/%20/g,zb=c.fn.load;c.fn.extend({load:function(a,b,d){if(typeof a!== -"string")return zb.call(this,a);else if(!this.length)return this;var f=a.indexOf(" ");if(f>=0){var e=a.slice(f,a.length);a=a.slice(0,f)}f="GET";if(b)if(c.isFunction(b)){d=b;b=null}else if(typeof b==="object"){b=c.param(b,c.ajaxSettings.traditional);f="POST"}var j=this;c.ajax({url:a,type:f,dataType:"html",data:b,complete:function(i,o){if(o==="success"||o==="notmodified")j.html(e?c("
").append(i.responseText.replace(tb,"")).find(e):i.responseText);d&&j.each(d,[i.responseText,o,i])}});return this}, -serialize:function(){return c.param(this.serializeArray())},serializeArray:function(){return this.map(function(){return this.elements?c.makeArray(this.elements):this}).filter(function(){return this.name&&!this.disabled&&(this.checked||ub.test(this.nodeName)||vb.test(this.type))}).map(function(a,b){a=c(this).val();return a==null?null:c.isArray(a)?c.map(a,function(d){return{name:b.name,value:d}}):{name:b.name,value:a}}).get()}});c.each("ajaxStart ajaxStop ajaxComplete ajaxError ajaxSuccess ajaxSend".split(" "), -function(a,b){c.fn[b]=function(d){return this.bind(b,d)}});c.extend({get:function(a,b,d,f){if(c.isFunction(b)){f=f||d;d=b;b=null}return c.ajax({type:"GET",url:a,data:b,success:d,dataType:f})},getScript:function(a,b){return c.get(a,null,b,"script")},getJSON:function(a,b,d){return c.get(a,b,d,"json")},post:function(a,b,d,f){if(c.isFunction(b)){f=f||d;d=b;b={}}return c.ajax({type:"POST",url:a,data:b,success:d,dataType:f})},ajaxSetup:function(a){c.extend(c.ajaxSettings,a)},ajaxSettings:{url:location.href, -global:true,type:"GET",contentType:"application/x-www-form-urlencoded",processData:true,async:true,xhr:A.XMLHttpRequest&&(A.location.protocol!=="file:"||!A.ActiveXObject)?function(){return new A.XMLHttpRequest}:function(){try{return new A.ActiveXObject("Microsoft.XMLHTTP")}catch(a){}},accepts:{xml:"application/xml, text/xml",html:"text/html",script:"text/javascript, application/javascript",json:"application/json, text/javascript",text:"text/plain",_default:"*/*"}},lastModified:{},etag:{},ajax:function(a){function b(){e.success&& -e.success.call(k,o,i,x);e.global&&f("ajaxSuccess",[x,e])}function d(){e.complete&&e.complete.call(k,x,i);e.global&&f("ajaxComplete",[x,e]);e.global&&!--c.active&&c.event.trigger("ajaxStop")}function f(q,p){(e.context?c(e.context):c.event).trigger(q,p)}var e=c.extend(true,{},c.ajaxSettings,a),j,i,o,k=a&&a.context||e,n=e.type.toUpperCase();if(e.data&&e.processData&&typeof e.data!=="string")e.data=c.param(e.data,e.traditional);if(e.dataType==="jsonp"){if(n==="GET")N.test(e.url)||(e.url+=(ka.test(e.url)? -"&":"?")+(e.jsonp||"callback")+"=?");else if(!e.data||!N.test(e.data))e.data=(e.data?e.data+"&":"")+(e.jsonp||"callback")+"=?";e.dataType="json"}if(e.dataType==="json"&&(e.data&&N.test(e.data)||N.test(e.url))){j=e.jsonpCallback||"jsonp"+sb++;if(e.data)e.data=(e.data+"").replace(N,"="+j+"$1");e.url=e.url.replace(N,"="+j+"$1");e.dataType="script";A[j]=A[j]||function(q){o=q;b();d();A[j]=w;try{delete A[j]}catch(p){}z&&z.removeChild(C)}}if(e.dataType==="script"&&e.cache===null)e.cache=false;if(e.cache=== -false&&n==="GET"){var r=J(),u=e.url.replace(wb,"$1_="+r+"$2");e.url=u+(u===e.url?(ka.test(e.url)?"&":"?")+"_="+r:"")}if(e.data&&n==="GET")e.url+=(ka.test(e.url)?"&":"?")+e.data;e.global&&!c.active++&&c.event.trigger("ajaxStart");r=(r=xb.exec(e.url))&&(r[1]&&r[1]!==location.protocol||r[2]!==location.host);if(e.dataType==="script"&&n==="GET"&&r){var z=s.getElementsByTagName("head")[0]||s.documentElement,C=s.createElement("script");C.src=e.url;if(e.scriptCharset)C.charset=e.scriptCharset;if(!j){var B= -false;C.onload=C.onreadystatechange=function(){if(!B&&(!this.readyState||this.readyState==="loaded"||this.readyState==="complete")){B=true;b();d();C.onload=C.onreadystatechange=null;z&&C.parentNode&&z.removeChild(C)}}}z.insertBefore(C,z.firstChild);return w}var E=false,x=e.xhr();if(x){e.username?x.open(n,e.url,e.async,e.username,e.password):x.open(n,e.url,e.async);try{if(e.data||a&&a.contentType)x.setRequestHeader("Content-Type",e.contentType);if(e.ifModified){c.lastModified[e.url]&&x.setRequestHeader("If-Modified-Since", -c.lastModified[e.url]);c.etag[e.url]&&x.setRequestHeader("If-None-Match",c.etag[e.url])}r||x.setRequestHeader("X-Requested-With","XMLHttpRequest");x.setRequestHeader("Accept",e.dataType&&e.accepts[e.dataType]?e.accepts[e.dataType]+", */*":e.accepts._default)}catch(ga){}if(e.beforeSend&&e.beforeSend.call(k,x,e)===false){e.global&&!--c.active&&c.event.trigger("ajaxStop");x.abort();return false}e.global&&f("ajaxSend",[x,e]);var g=x.onreadystatechange=function(q){if(!x||x.readyState===0||q==="abort"){E|| -d();E=true;if(x)x.onreadystatechange=c.noop}else if(!E&&x&&(x.readyState===4||q==="timeout")){E=true;x.onreadystatechange=c.noop;i=q==="timeout"?"timeout":!c.httpSuccess(x)?"error":e.ifModified&&c.httpNotModified(x,e.url)?"notmodified":"success";var p;if(i==="success")try{o=c.httpData(x,e.dataType,e)}catch(v){i="parsererror";p=v}if(i==="success"||i==="notmodified")j||b();else c.handleError(e,x,i,p);d();q==="timeout"&&x.abort();if(e.async)x=null}};try{var h=x.abort;x.abort=function(){x&&h.call(x); -g("abort")}}catch(l){}e.async&&e.timeout>0&&setTimeout(function(){x&&!E&&g("timeout")},e.timeout);try{x.send(n==="POST"||n==="PUT"||n==="DELETE"?e.data:null)}catch(m){c.handleError(e,x,null,m);d()}e.async||g();return x}},handleError:function(a,b,d,f){if(a.error)a.error.call(a.context||a,b,d,f);if(a.global)(a.context?c(a.context):c.event).trigger("ajaxError",[b,a,f])},active:0,httpSuccess:function(a){try{return!a.status&&location.protocol==="file:"||a.status>=200&&a.status<300||a.status===304||a.status=== -1223||a.status===0}catch(b){}return false},httpNotModified:function(a,b){var d=a.getResponseHeader("Last-Modified"),f=a.getResponseHeader("Etag");if(d)c.lastModified[b]=d;if(f)c.etag[b]=f;return a.status===304||a.status===0},httpData:function(a,b,d){var f=a.getResponseHeader("content-type")||"",e=b==="xml"||!b&&f.indexOf("xml")>=0;a=e?a.responseXML:a.responseText;e&&a.documentElement.nodeName==="parsererror"&&c.error("parsererror");if(d&&d.dataFilter)a=d.dataFilter(a,b);if(typeof a==="string")if(b=== -"json"||!b&&f.indexOf("json")>=0)a=c.parseJSON(a);else if(b==="script"||!b&&f.indexOf("javascript")>=0)c.globalEval(a);return a},param:function(a,b){function d(i,o){if(c.isArray(o))c.each(o,function(k,n){b||/\[\]$/.test(i)?f(i,n):d(i+"["+(typeof n==="object"||c.isArray(n)?k:"")+"]",n)});else!b&&o!=null&&typeof o==="object"?c.each(o,function(k,n){d(i+"["+k+"]",n)}):f(i,o)}function f(i,o){o=c.isFunction(o)?o():o;e[e.length]=encodeURIComponent(i)+"="+encodeURIComponent(o)}var e=[];if(b===w)b=c.ajaxSettings.traditional; -if(c.isArray(a)||a.jquery)c.each(a,function(){f(this.name,this.value)});else for(var j in a)d(j,a[j]);return e.join("&").replace(yb,"+")}});var la={},Ab=/toggle|show|hide/,Bb=/^([+-]=)?([\d+-.]+)(.*)$/,W,va=[["height","marginTop","marginBottom","paddingTop","paddingBottom"],["width","marginLeft","marginRight","paddingLeft","paddingRight"],["opacity"]];c.fn.extend({show:function(a,b){if(a||a===0)return this.animate(K("show",3),a,b);else{a=0;for(b=this.length;a").appendTo("body");f=e.css("display");if(f==="none")f="block";e.remove();la[d]=f}c.data(this[a],"olddisplay",f)}}a=0;for(b=this.length;a=0;f--)if(d[f].elem===this){b&&d[f](true);d.splice(f,1)}});b||this.dequeue();return this}});c.each({slideDown:K("show",1),slideUp:K("hide",1),slideToggle:K("toggle",1),fadeIn:{opacity:"show"},fadeOut:{opacity:"hide"}},function(a,b){c.fn[a]=function(d,f){return this.animate(b,d,f)}});c.extend({speed:function(a,b,d){var f=a&&typeof a==="object"?a:{complete:d||!d&&b||c.isFunction(a)&&a,duration:a,easing:d&&b||b&&!c.isFunction(b)&&b};f.duration=c.fx.off?0:typeof f.duration=== -"number"?f.duration:c.fx.speeds[f.duration]||c.fx.speeds._default;f.old=f.complete;f.complete=function(){f.queue!==false&&c(this).dequeue();c.isFunction(f.old)&&f.old.call(this)};return f},easing:{linear:function(a,b,d,f){return d+f*a},swing:function(a,b,d,f){return(-Math.cos(a*Math.PI)/2+0.5)*f+d}},timers:[],fx:function(a,b,d){this.options=b;this.elem=a;this.prop=d;if(!b.orig)b.orig={}}});c.fx.prototype={update:function(){this.options.step&&this.options.step.call(this.elem,this.now,this);(c.fx.step[this.prop]|| -c.fx.step._default)(this);if((this.prop==="height"||this.prop==="width")&&this.elem.style)this.elem.style.display="block"},cur:function(a){if(this.elem[this.prop]!=null&&(!this.elem.style||this.elem.style[this.prop]==null))return this.elem[this.prop];return(a=parseFloat(c.css(this.elem,this.prop,a)))&&a>-10000?a:parseFloat(c.curCSS(this.elem,this.prop))||0},custom:function(a,b,d){function f(j){return e.step(j)}this.startTime=J();this.start=a;this.end=b;this.unit=d||this.unit||"px";this.now=this.start; -this.pos=this.state=0;var e=this;f.elem=this.elem;if(f()&&c.timers.push(f)&&!W)W=setInterval(c.fx.tick,13)},show:function(){this.options.orig[this.prop]=c.style(this.elem,this.prop);this.options.show=true;this.custom(this.prop==="width"||this.prop==="height"?1:0,this.cur());c(this.elem).show()},hide:function(){this.options.orig[this.prop]=c.style(this.elem,this.prop);this.options.hide=true;this.custom(this.cur(),0)},step:function(a){var b=J(),d=true;if(a||b>=this.options.duration+this.startTime){this.now= -this.end;this.pos=this.state=1;this.update();this.options.curAnim[this.prop]=true;for(var f in this.options.curAnim)if(this.options.curAnim[f]!==true)d=false;if(d){if(this.options.display!=null){this.elem.style.overflow=this.options.overflow;a=c.data(this.elem,"olddisplay");this.elem.style.display=a?a:this.options.display;if(c.css(this.elem,"display")==="none")this.elem.style.display="block"}this.options.hide&&c(this.elem).hide();if(this.options.hide||this.options.show)for(var e in this.options.curAnim)c.style(this.elem, -e,this.options.orig[e]);this.options.complete.call(this.elem)}return false}else{e=b-this.startTime;this.state=e/this.options.duration;a=this.options.easing||(c.easing.swing?"swing":"linear");this.pos=c.easing[this.options.specialEasing&&this.options.specialEasing[this.prop]||a](this.state,e,0,1,this.options.duration);this.now=this.start+(this.end-this.start)*this.pos;this.update()}return true}};c.extend(c.fx,{tick:function(){for(var a=c.timers,b=0;b
"; -a.insertBefore(b,a.firstChild);d=b.firstChild;f=d.firstChild;e=d.nextSibling.firstChild.firstChild;this.doesNotAddBorder=f.offsetTop!==5;this.doesAddBorderForTableAndCells=e.offsetTop===5;f.style.position="fixed";f.style.top="20px";this.supportsFixedPosition=f.offsetTop===20||f.offsetTop===15;f.style.position=f.style.top="";d.style.overflow="hidden";d.style.position="relative";this.subtractsBorderForOverflowNotVisible=f.offsetTop===-5;this.doesNotIncludeMarginInBodyOffset=a.offsetTop!==j;a.removeChild(b); -c.offset.initialize=c.noop},bodyOffset:function(a){var b=a.offsetTop,d=a.offsetLeft;c.offset.initialize();if(c.offset.doesNotIncludeMarginInBodyOffset){b+=parseFloat(c.curCSS(a,"marginTop",true))||0;d+=parseFloat(c.curCSS(a,"marginLeft",true))||0}return{top:b,left:d}},setOffset:function(a,b,d){if(/static/.test(c.curCSS(a,"position")))a.style.position="relative";var f=c(a),e=f.offset(),j=parseInt(c.curCSS(a,"top",true),10)||0,i=parseInt(c.curCSS(a,"left",true),10)||0;if(c.isFunction(b))b=b.call(a, -d,e);d={top:b.top-e.top+j,left:b.left-e.left+i};"using"in b?b.using.call(a,d):f.css(d)}};c.fn.extend({position:function(){if(!this[0])return null;var a=this[0],b=this.offsetParent(),d=this.offset(),f=/^body|html$/i.test(b[0].nodeName)?{top:0,left:0}:b.offset();d.top-=parseFloat(c.curCSS(a,"marginTop",true))||0;d.left-=parseFloat(c.curCSS(a,"marginLeft",true))||0;f.top+=parseFloat(c.curCSS(b[0],"borderTopWidth",true))||0;f.left+=parseFloat(c.curCSS(b[0],"borderLeftWidth",true))||0;return{top:d.top- -f.top,left:d.left-f.left}},offsetParent:function(){return this.map(function(){for(var a=this.offsetParent||s.body;a&&!/^body|html$/i.test(a.nodeName)&&c.css(a,"position")==="static";)a=a.offsetParent;return a})}});c.each(["Left","Top"],function(a,b){var d="scroll"+b;c.fn[d]=function(f){var e=this[0],j;if(!e)return null;if(f!==w)return this.each(function(){if(j=wa(this))j.scrollTo(!a?f:c(j).scrollLeft(),a?f:c(j).scrollTop());else this[d]=f});else return(j=wa(e))?"pageXOffset"in j?j[a?"pageYOffset": -"pageXOffset"]:c.support.boxModel&&j.document.documentElement[d]||j.document.body[d]:e[d]}});c.each(["Height","Width"],function(a,b){var d=b.toLowerCase();c.fn["inner"+b]=function(){return this[0]?c.css(this[0],d,false,"padding"):null};c.fn["outer"+b]=function(f){return this[0]?c.css(this[0],d,false,f?"margin":"border"):null};c.fn[d]=function(f){var e=this[0];if(!e)return f==null?null:this;if(c.isFunction(f))return this.each(function(j){var i=c(this);i[d](f.call(this,j,i[d]()))});return"scrollTo"in -e&&e.document?e.document.compatMode==="CSS1Compat"&&e.document.documentElement["client"+b]||e.document.body["client"+b]:e.nodeType===9?Math.max(e.documentElement["client"+b],e.body["scroll"+b],e.documentElement["scroll"+b],e.body["offset"+b],e.documentElement["offset"+b]):f===w?c.css(e,d):this.css(d,typeof f==="string"?f:f+"px")}});A.jQuery=A.$=c})(window); diff --git a/html/sphinx/_static/minus.png b/html/sphinx/_static/minus.png deleted file mode 100644 index da1c5620d10c047525a467a425abe9ff5269cfc2..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 199 zcmeAS@N?(olHy`uVBq!ia0vp^+#t-s1SHkYJtzcHoCO|{#XvD(5N2eUHAey{$X?>< z>&kweokM_|(Po{+Q=kw>iEBiObAE1aYF-J$w=>iB1I2R$WLpMkF=>bh=@O1TaS?83{1OVknK< z>&kweokM`jkU7Va11Q8%;u=xnoS&PUnpeW`?aZ|OK(QcC7sn8Z%gHvy&v=;Q4jejg zV8NnAO`-4Z@2~&zopr02WF_WB>pF diff --git a/html/sphinx/_static/pygments.css b/html/sphinx/_static/pygments.css deleted file mode 100644 index 1a14f2a..0000000 --- a/html/sphinx/_static/pygments.css +++ /dev/null @@ -1,62 +0,0 @@ -.highlight .hll { background-color: #ffffcc } -.highlight { background: #eeffcc; } -.highlight .c { color: #408090; font-style: italic } /* Comment */ -.highlight .err { border: 1px solid #FF0000 } /* Error */ -.highlight .k { color: #007020; font-weight: bold } /* Keyword */ -.highlight .o { color: #666666 } /* Operator */ -.highlight .cm { color: #408090; font-style: italic } /* Comment.Multiline */ -.highlight .cp { color: #007020 } /* Comment.Preproc */ -.highlight .c1 { color: #408090; font-style: italic } /* Comment.Single */ -.highlight .cs { color: #408090; background-color: #fff0f0 } /* Comment.Special */ -.highlight .gd { color: #A00000 } /* Generic.Deleted */ -.highlight .ge { font-style: italic } /* Generic.Emph */ -.highlight .gr { color: #FF0000 } /* Generic.Error */ -.highlight .gh { color: #000080; font-weight: bold } /* Generic.Heading */ -.highlight .gi { color: #00A000 } /* Generic.Inserted */ -.highlight .go { color: #303030 } /* Generic.Output */ -.highlight .gp { color: #c65d09; font-weight: bold } /* Generic.Prompt */ -.highlight .gs { font-weight: bold } /* Generic.Strong */ -.highlight .gu { color: #800080; font-weight: bold } /* Generic.Subheading */ -.highlight .gt { color: #0040D0 } /* Generic.Traceback */ -.highlight .kc { color: #007020; font-weight: bold } /* Keyword.Constant */ -.highlight .kd { color: #007020; font-weight: bold } /* Keyword.Declaration */ -.highlight .kn { color: #007020; font-weight: bold } /* Keyword.Namespace */ -.highlight .kp { color: #007020 } /* Keyword.Pseudo */ -.highlight .kr { color: #007020; font-weight: bold } /* Keyword.Reserved */ -.highlight .kt { color: #902000 } /* Keyword.Type */ -.highlight .m { color: #208050 } /* Literal.Number */ -.highlight .s { color: #4070a0 } /* Literal.String */ -.highlight .na { color: #4070a0 } /* Name.Attribute */ -.highlight .nb { color: #007020 } /* Name.Builtin */ -.highlight .nc { color: #0e84b5; font-weight: bold } /* Name.Class */ -.highlight .no { color: #60add5 } /* Name.Constant */ -.highlight .nd { color: #555555; font-weight: bold } /* Name.Decorator */ -.highlight .ni { color: #d55537; font-weight: bold } /* Name.Entity */ -.highlight .ne { color: #007020 } /* Name.Exception */ -.highlight .nf { color: #06287e } /* Name.Function */ -.highlight .nl { color: #002070; font-weight: bold } /* Name.Label */ -.highlight .nn { color: #0e84b5; font-weight: bold } /* Name.Namespace */ -.highlight .nt { color: #062873; font-weight: bold } /* Name.Tag */ -.highlight .nv { color: #bb60d5 } /* Name.Variable */ -.highlight .ow { color: #007020; font-weight: bold } /* Operator.Word */ -.highlight .w { color: #bbbbbb } /* Text.Whitespace */ -.highlight .mf { color: #208050 } /* Literal.Number.Float */ -.highlight .mh { color: #208050 } /* Literal.Number.Hex */ -.highlight .mi { color: #208050 } /* Literal.Number.Integer */ -.highlight .mo { color: #208050 } /* Literal.Number.Oct */ -.highlight .sb { color: #4070a0 } /* Literal.String.Backtick */ -.highlight .sc { color: #4070a0 } /* Literal.String.Char */ -.highlight .sd { color: #4070a0; font-style: italic } /* Literal.String.Doc */ -.highlight .s2 { color: #4070a0 } /* Literal.String.Double */ -.highlight .se { color: #4070a0; font-weight: bold } /* Literal.String.Escape */ -.highlight .sh { color: #4070a0 } /* Literal.String.Heredoc */ -.highlight .si { color: #70a0d0; font-style: italic } /* Literal.String.Interpol */ -.highlight .sx { color: #c65d09 } /* Literal.String.Other */ -.highlight .sr { color: #235388 } /* Literal.String.Regex */ -.highlight .s1 { color: #4070a0 } /* Literal.String.Single */ -.highlight .ss { color: #517918 } /* Literal.String.Symbol */ -.highlight .bp { color: #007020 } /* Name.Builtin.Pseudo */ -.highlight .vc { color: #bb60d5 } /* Name.Variable.Class */ -.highlight .vg { color: #bb60d5 } /* Name.Variable.Global */ -.highlight .vi { color: #bb60d5 } /* Name.Variable.Instance */ -.highlight .il { color: #208050 } /* Literal.Number.Integer.Long */ \ No newline at end of file diff --git a/html/sphinx/_static/searchtools.js b/html/sphinx/_static/searchtools.js deleted file mode 100644 index dae92b5..0000000 --- a/html/sphinx/_static/searchtools.js +++ /dev/null @@ -1,518 +0,0 @@ -/* - * searchtools.js - * ~~~~~~~~~~~~~~ - * - * Sphinx JavaScript utilties for the full-text search. - * - * :copyright: Copyright 2007-2011 by the Sphinx team, see AUTHORS. - * :license: BSD, see LICENSE for details. - * - */ - -/** - * helper function to return a node containing the - * search summary for a given text. keywords is a list - * of stemmed words, hlwords is the list of normal, unstemmed - * words. the first one is used to find the occurance, the - * latter for highlighting it. - */ - -jQuery.makeSearchSummary = function(text, keywords, hlwords) { - var textLower = text.toLowerCase(); - var start = 0; - $.each(keywords, function() { - var i = textLower.indexOf(this.toLowerCase()); - if (i > -1) - start = i; - }); - start = Math.max(start - 120, 0); - var excerpt = ((start > 0) ? '...' : '') + - $.trim(text.substr(start, 240)) + - ((start + 240 - text.length) ? '...' : ''); - var rv = $('
').text(excerpt); - $.each(hlwords, function() { - rv = rv.highlightText(this, 'highlighted'); - }); - return rv; -} - -/** - * Porter Stemmer - */ -var PorterStemmer = function() { - - var step2list = { - ational: 'ate', - tional: 'tion', - enci: 'ence', - anci: 'ance', - izer: 'ize', - bli: 'ble', - alli: 'al', - entli: 'ent', - eli: 'e', - ousli: 'ous', - ization: 'ize', - ation: 'ate', - ator: 'ate', - alism: 'al', - iveness: 'ive', - fulness: 'ful', - ousness: 'ous', - aliti: 'al', - iviti: 'ive', - biliti: 'ble', - logi: 'log' - }; - - var step3list = { - icate: 'ic', - ative: '', - alize: 'al', - iciti: 'ic', - ical: 'ic', - ful: '', - ness: '' - }; - - var c = "[^aeiou]"; // consonant - var v = "[aeiouy]"; // vowel - var C = c + "[^aeiouy]*"; // consonant sequence - var V = v + "[aeiou]*"; // vowel sequence - - var mgr0 = "^(" + C + ")?" + V + C; // [C]VC... is m>0 - var meq1 = "^(" + C + ")?" + V + C + "(" + V + ")?$"; // [C]VC[V] is m=1 - var mgr1 = "^(" + C + ")?" + V + C + V + C; // [C]VCVC... is m>1 - var s_v = "^(" + C + ")?" + v; // vowel in stem - - this.stemWord = function (w) { - var stem; - var suffix; - var firstch; - var origword = w; - - if (w.length < 3) - return w; - - var re; - var re2; - var re3; - var re4; - - firstch = w.substr(0,1); - if (firstch == "y") - w = firstch.toUpperCase() + w.substr(1); - - // Step 1a - re = /^(.+?)(ss|i)es$/; - re2 = /^(.+?)([^s])s$/; - - if (re.test(w)) - w = w.replace(re,"$1$2"); - else if (re2.test(w)) - w = w.replace(re2,"$1$2"); - - // Step 1b - re = /^(.+?)eed$/; - re2 = /^(.+?)(ed|ing)$/; - if (re.test(w)) { - var fp = re.exec(w); - re = new RegExp(mgr0); - if (re.test(fp[1])) { - re = /.$/; - w = w.replace(re,""); - } - } - else if (re2.test(w)) { - var fp = re2.exec(w); - stem = fp[1]; - re2 = new RegExp(s_v); - if (re2.test(stem)) { - w = stem; - re2 = /(at|bl|iz)$/; - re3 = new RegExp("([^aeiouylsz])\\1$"); - re4 = new RegExp("^" + C + v + "[^aeiouwxy]$"); - if (re2.test(w)) - w = w + "e"; - else if (re3.test(w)) { - re = /.$/; - w = w.replace(re,""); - } - else if (re4.test(w)) - w = w + "e"; - } - } - - // Step 1c - re = /^(.+?)y$/; - if (re.test(w)) { - var fp = re.exec(w); - stem = fp[1]; - re = new RegExp(s_v); - if (re.test(stem)) - w = stem + "i"; - } - - // Step 2 - re = /^(.+?)(ational|tional|enci|anci|izer|bli|alli|entli|eli|ousli|ization|ation|ator|alism|iveness|fulness|ousness|aliti|iviti|biliti|logi)$/; - if (re.test(w)) { - var fp = re.exec(w); - stem = fp[1]; - suffix = fp[2]; - re = new RegExp(mgr0); - if (re.test(stem)) - w = stem + step2list[suffix]; - } - - // Step 3 - re = /^(.+?)(icate|ative|alize|iciti|ical|ful|ness)$/; - if (re.test(w)) { - var fp = re.exec(w); - stem = fp[1]; - suffix = fp[2]; - re = new RegExp(mgr0); - if (re.test(stem)) - w = stem + step3list[suffix]; - } - - // Step 4 - re = /^(.+?)(al|ance|ence|er|ic|able|ible|ant|ement|ment|ent|ou|ism|ate|iti|ous|ive|ize)$/; - re2 = /^(.+?)(s|t)(ion)$/; - if (re.test(w)) { - var fp = re.exec(w); - stem = fp[1]; - re = new RegExp(mgr1); - if (re.test(stem)) - w = stem; - } - else if (re2.test(w)) { - var fp = re2.exec(w); - stem = fp[1] + fp[2]; - re2 = new RegExp(mgr1); - if (re2.test(stem)) - w = stem; - } - - // Step 5 - re = /^(.+?)e$/; - if (re.test(w)) { - var fp = re.exec(w); - stem = fp[1]; - re = new RegExp(mgr1); - re2 = new RegExp(meq1); - re3 = new RegExp("^" + C + v + "[^aeiouwxy]$"); - if (re.test(stem) || (re2.test(stem) && !(re3.test(stem)))) - w = stem; - } - re = /ll$/; - re2 = new RegExp(mgr1); - if (re.test(w) && re2.test(w)) { - re = /.$/; - w = w.replace(re,""); - } - - // and turn initial Y back to y - if (firstch == "y") - w = firstch.toLowerCase() + w.substr(1); - return w; - } -} - - -/** - * Search Module - */ -var Search = { - - _index : null, - _queued_query : null, - _pulse_status : -1, - - init : function() { - var params = $.getQueryParameters(); - if (params.q) { - var query = params.q[0]; - $('input[name="q"]')[0].value = query; - this.performSearch(query); - } - }, - - loadIndex : function(url) { - $.ajax({type: "GET", url: url, data: null, success: null, - dataType: "script", cache: true}); - }, - - setIndex : function(index) { - var q; - this._index = index; - if ((q = this._queued_query) !== null) { - this._queued_query = null; - Search.query(q); - } - }, - - hasIndex : function() { - return this._index !== null; - }, - - deferQuery : function(query) { - this._queued_query = query; - }, - - stopPulse : function() { - this._pulse_status = 0; - }, - - startPulse : function() { - if (this._pulse_status >= 0) - return; - function pulse() { - Search._pulse_status = (Search._pulse_status + 1) % 4; - var dotString = ''; - for (var i = 0; i < Search._pulse_status; i++) - dotString += '.'; - Search.dots.text(dotString); - if (Search._pulse_status > -1) - window.setTimeout(pulse, 500); - }; - pulse(); - }, - - /** - * perform a search for something - */ - performSearch : function(query) { - // create the required interface elements - this.out = $('#search-results'); - this.title = $('

' + _('Searching') + '

').appendTo(this.out); - this.dots = $('').appendTo(this.title); - this.status = $('

').appendTo(this.out); - this.output = $('