http://www.read.cs.ucla.edu/click/ 2012-05-16T07:08:33-07:00 http://www.read.cs.ucla.edu/click/ http://www.read.cs.ucla.edu/click/lib/tpl/click/images/favicon.ico text/html 2011-09-24T12:43:35-07:00 http://www.read.cs.ucla.edu/click/changes?rev=1316893415&do=diff This page, taken from the Click distribution's NEWS file, summarizes changes to the Click distribution since our first release. Version 2.0.1, 24.Sep.2011 * ns-3 support, thanks to Lalith Suresh and Sascha Alexander Jopen. * Important bug fixes for user-level ToDevice thanks to Jaeyong Yoo. * Better handling for time: Timestamp knows about steady clocks (also known as monotonic clocks -- clocks that never go backwards) on most platforms, so Timers should go off at predictable intervals… text/html 2012-01-16T20:44:48-07:00 http://www.read.cs.ucla.edu/click/click?rev=1326775488&do=diff NEWS (September 24, 2011): Click 2.0.1 released! SyClick: Symposium on Click Modular Router was November 23-24, 2009, Ghent, Belgium! An excellent time was had. Video of the presentations is now available. This is the DokuWiki for the Click modular router. Click was originally developed at MIT with subsequent development at Mazu Networks, ICIR, UCLA, and Meraki. text/html 2011-05-12T02:27:39-07:00 http://www.read.cs.ucla.edu/click/clickunderhood?rev=1305192459&do=diff Click Under the Hood The following page explains how Click actually works under the hood. The explanation is initially based on single-threaded, user-level click; we discuss multi-threaded and kernel mode Click in later sections of this document. Also note that line numbers might differ slightly depending on which source version you have. text/html 2011-05-24T08:17:55-07:00 http://www.read.cs.ucla.edu/click/clicky-css?rev=1306250275&do=diff Control the appearance of a Clicky diagram with style sheets written in a CSS-like language. A CCSS file consists of a series of rule sets, which are blocks of declarations that apply to one or more selectors. For example, this rule set contains one declaration, for the background property. It says that all elements should have a red background: text/html 2009-03-07T17:00:21-07:00 http://www.read.cs.ucla.edu/click/clicky?rev=1236474021&do=diff Clicky CSS Reference The Clicky GUI comes with Click, in the apps/clicky directory. This silent screencast shows what it's about (click "Go" to begin). Clicky can show Click configurations as text (with syntax highlighting) or diagrams, and can read and write handlers in live configurations. It can also generate output diagrams in PDF format. text/html 2007-09-09T22:44:33-07:00 http://www.read.cs.ucla.edu/click/confparse?rev=1189403073&do=diff More current documentation is available here. text/html 2012-01-17T14:46:05-07:00 http://www.read.cs.ucla.edu/click/cvs?rev=1326840365&do=diff The Click sources are available from git. Git is the best way to use Click. For those who cannot use git, we export the current state of the tree by anonymous CVS as well. View current Click sources View current Click packages sources Summary <dl> <dt> CVS root:</dt> <dd> :pserver:anonymous@read.cs.ucla.edu:22401/git/click (for the core distribution) :pserver:anonymous@read.cs.ucla.edu:22401/git/click-packages (for packages)</dd> <dt> Repository:</dt> <dd> master</dd> <dt> To build fro… text/html 2006-03-02T23:22:01-07:00 http://www.read.cs.ucla.edu/click/docs?rev=1141370521&do=diff General Name Description Manual Page language Configuration language click(5) elementdoc How to write element documentation elementdoc(7) Drivers Name Description Manual Page userdriver User-level driver click(1) linuxmodule Linux kernel module driver click.o(8) Tools Name Description click-align click-align tool click-combine click-combine tool click-devirtualize click-devirtualize tool click-fastclassifier click-fastclassifier tool click-flatten click-flatten to… text/html 2011-09-24T12:41:48-07:00 http://www.read.cs.ucla.edu/click/download?rev=1316893308&do=diff Click software distributions include more than 300 elements, the Linux kernel module, the user-level driver, the FreeBSD kernel module, a driver for the NS simulator, tools, and documentation, all under an MIT/BSD-like license (with some portions under the GPL). The core distribution contains the Click drivers and a large collection of elements. The packages distribution contains several more specialized packages of elements. text/html 2008-03-05T18:19:38-07:00 http://www.read.cs.ucla.edu/click/element?rev=1204769978&do=diff See the Doxygen documentation on class Element for information on moving packets, handling packets, running tasks. Handlers Handlers are access points through which users can interact with elements in a running Click router, or with the router as a whole. Read and write handlers behave like files in a file system, while LLRPCs provide a remote procedure call interface. text/html 2012-01-17T11:02:52-07:00 http://www.read.cs.ucla.edu/click/elements?rev=1326826972&do=diff This is automatically generated documentation. Basic Sources and Sinks Name Function Drivers Package Discard drops all packets all standard (core) DiscardNoFree drops all packets, but does not free any of them. all standard (core) Idle discards packets all standard (core) InfiniteSource generates packets whenever scheduled all standard (core) RandomSource generates random packets whenever scheduled all standard (core) RatedSource generates packets at specified rate all… text/html 2007-02-22T10:00:34-07:00 http://www.read.cs.ucla.edu/click/errorhandlers?rev=1172167234&do=diff ErrorHandler All Click error messages are passed to an instance of the ErrorHandler class. ErrorHandler separates the generation of error messages from the particular way those messages should be printed. It also makes it easy to automatically decorate errors with context information. Most Click users must know how to report errors to an ErrorHandler, and how ErrorHandlers count the messages they receive. This section also describes how to decorate error messages with error veneers, and how to… text/html 2008-01-17T12:14:32-07:00 http://www.read.cs.ucla.edu/click/examples?rev=1200600872&do=diff test.click A trivial three-element configuration that prints 5 sample packets, then stops. test2.click A slightly more complex example, including RED dropping. test3.click An example of how to use Click scheduler elements. test-device.click A trivial device test that hooks up to a device with FromDevice and prints any packets received. test-tun.click A user-level configuration that tests the KernelTun element. udpgen.click A simple UDP generator, expressed as a compound element. udpc… text/html 2010-09-27T16:19:24-07:00 http://www.read.cs.ucla.edu/click/faq?rev=1285629564&do=diff General Questions Is Click experimental software? Yes. The Click Linux patch does not apply cleanly to my version of Linux. Try a version of Linux for which we distribute a specific patch. See the INSTALL file for a list of patches. How fast can Click route packets? On a 700 MHz Pentium III, we could get 456,000 64-byte packets a second through a Click router with eight active DEC Tulip fast Ethernet cards. Current rates are also good. text/html 2010-09-22T12:58:43-07:00 http://www.read.cs.ucla.edu/click/git?rev=1285185523&do=diff Click sources are maintained in a Git repository. Most Click developers and users should rely on the Git sources, since we release Click infrequently. Git is a distributed source control management system. Click sources on Github Click packages sources on Github text/html 2012-04-11T06:05:14-07:00 http://www.read.cs.ucla.edu/click/learning?rev=1334149514&do=diff This page collects Click tutorials and information for those new to the system. You may also be interested in: * Our publications present the ideas behind Click, and are a good way to get a feeling for the system. * The Click distribution comes with extensive documentation; see below. * Example configurations. These are also distributed with Click in the conf directory. text/html 2007-02-22T09:01:30-07:00 http://www.read.cs.ucla.edu/click/license?rev=1172163690&do=diff Click is distributed under an MIT/BSD-like license called "the Click license". This license is an MIT license, plus a clause (taken from the W3C license) requiring prior written permission to use our names in publicity. It is posted below. Portions of the Click software are distributed under different licenses. In particular, portions are derived from the Linux kernel, and are thus distributed under the GNU General Public License, version 2. The GPL applies to the source files in drivers/e100… text/html 2011-06-02T15:39:30-07:00 http://www.read.cs.ucla.edu/click/nsclick?rev=1307054370&do=diff Click can be run in a simulation environment within the NS-3 and NS-2 simulators. The integrations are known as ns-3-click and nsclick respectively. This section describes the installation procedure for each. Setting up ns-3-click The first step is to build Click with simulator integration support enabled. text/html 2009-12-01T04:37:42-07:00 http://www.read.cs.ucla.edu/click/packages?rev=1259671062&do=diff This page lists packages available for the Click modular router. Package Description core Core packages distributed with Click dhcp DHCP client and server elements iias Internet-In-A-Slice: GRE and PPP elements for PlanetLab ip6_natpt IPv6 network address translation mobileip IPv4 Mobile IP support models TCP/IP measurement multicast IP multicast multicast6 IPv6 multicast netflow Cisco Netflow NetPath NetPath (select NetPath from menu): scalable network emulation roofnet … text/html 2007-01-29T04:35:15-07:00 http://www.read.cs.ucla.edu/click/packet?rev=1170074115&do=diff The Packet class represents Click packets. The single Packet interface has multiple implementations, one per driver. Inside the Linux kernel driver, a Packet object is equivalent to a Linux sk_buff structure; most Packet methods are inline functions that expand to sk_buff calls. The user-level driver, however, uses a purpose-built Packet implementation. Click packets separate header information from data. The Packet * pointer points to a header structure, which holds pointers to the actual pack… text/html 2008-02-14T21:26:47-07:00 http://www.read.cs.ucla.edu/click/programmingconcepts?rev=1203053207&do=diff This page collects programming concepts used in Click, mainly for element programming. It contains information that was originally in the old Programming Manual. Some of this should most probably end up in the doxygen element documentation, currently it's available here to complete the documentation transfer from the old website to this wiki. text/html 2011-04-11T08:51:03-07:00 http://www.read.cs.ucla.edu/click/projects?rev=1302537063&do=diff This page lists projects that use Click. Please add your own! * Grid ad hoc networking project * MIT Roofnet 802.11b/g mesh network * XORP (eXperimental Open Router Platform) * C-BGP Click * ClickIt! GUI for creating and investigating Click kernel configurations * Hydra A wireless multihop testbed * VirtualRouter (Virtual Router Project) * FireSim ShoreWall Firewall Simulation with Click Modular Router * Pursuit BlackAdder Blackadder is PURSUIT’s new prototype implementation… text/html 2012-01-25T14:41:26-07:00 http://www.read.cs.ucla.edu/click/publications?rev=1327531286&do=diff Publications About Click * The Click modular router. Eddie Kohler, Robert Morris, Benjie Chen, John Jannotti, and M. Frans Kaashoek. ACM Transactions on Computer Systems 18(3), August 2000, pages 263-297. A good survey of the system. * The Click modular router. Eddie Kohler. Ph.D. thesis, MIT, November 2000. This has more detail and examples than the TOCS and SOSP papers of the same name. * The Click modular router. Robert Morris, Eddie Kohler, John Jannotti, and M. Frans Kaashoek. P… text/html 2006-06-21T21:59:05-07:00 http://www.read.cs.ucla.edu/click/todo?rev=1150952345&do=diff * NameInfo/NameDB further uses * IPFieldInfo completion and integration * FromIPSummaryDump functionality should be moved to the ipsumdump_WHATEVER files * Regression tests. We distribute several regression tests in the test/ directory. (Many of them require --enable-analysis to run.) This should grow to include behavior from many or most of our elements, and adding regression tests is an easy way to help us out as you learn the system. * IPv6 and multicast support. * Interesting pack… text/html 2008-02-20T07:36:25-07:00 http://www.read.cs.ucla.edu/click/tutorial1?rev=1203521785&do=diff Working through this tutorial will teach you how to write a Click configuration, introduce you to many of Click's elements, and show you how Click configurations can be made scriptable. Solutions Preparation Obtain Click from anonymous CVS and compile and install it. Here's a quick rundown of the commands you'll probably use. text/html 2007-09-06T14:56:27-07:00 http://www.read.cs.ucla.edu/click/tutorial1solutions?rev=1189115787&do=diff These are the solutions for Click Tutorial Problem Set 1. 1. Trace files [2 points]. Use FromDump and ToDump. FromDump(f1a.dump, STOP true) -> ToDump(f1b.dump, ENCAP IP); 2. Routing [2 points]. IP routing elements like RadixIPLookup and LinearIPLookup were obvious choices.