http://www.read.cs.ucla.edu/click/ 2009-11-21T08:52:06-08:00 http://www.read.cs.ucla.edu/click/ http://www.read.cs.ucla.edu/click/lib/images/favicon.ico text/html 2007-09-18T14:26:39-08:00 http://www.read.cs.ucla.edu/click/changes?rev=1190150799 This page, taken from the Click distribution's NEWS file, summarizes changes to the Click distribution since our first release. Version 1.6.0, 18.Sep.2007 * Drivers * The Click drivers, language, and tools support named configuration parameters, which can be set in configuration files or on the command line. See 'conf/test-ping.click' for an example. * click-install provides a --cpu option, to force Click to run on a given CPU (Beyers Cronje). Also, click-install provides a --user op… text/html 2009-06-22T15:03:52-08:00 http://www.read.cs.ucla.edu/click/click?rev=1245708232 Array NEWS: SyClick: Symposium on Click Modular Router is November 23-24, 2009, Ghent, Belgium! Submit a presentation or demo! 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 2009-03-16T17:56:07-08:00 http://www.read.cs.ucla.edu/click/clicky-css?rev=1237251367 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-08:00 http://www.read.cs.ucla.edu/click/clicky?rev=1236474021 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-08:00 http://www.read.cs.ucla.edu/click/confparse?rev=1189403073 More current documentation is available here. text/html 2007-08-27T13:33:49-08:00 http://www.read.cs.ucla.edu/click/cvs?rev=1188246829 The Click sources are available from git. For those who cannot use git, we export the current state of the tree by anonymous CVS as well. Most Click developers and users should rely on the git or CVS sources, since we release Click infrequently. View current Click sources View current Click packages sources <dl> <dt> </dt> <dd> (for the core distribution) (for )</dd> <dt> </dt> <dd> </dd> <dt> </dt> <dd> Run and build as usual. Life will be easier if you have autoconf-2.59 or higher.</dd… text/html 2006-03-02T23:22:01-08:00 http://www.read.cs.ucla.edu/click/docs?rev=1141370521 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 2009-03-07T17:20:59-08:00 http://www.read.cs.ucla.edu/click/download?rev=1236475259 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-08:00 http://www.read.cs.ucla.edu/click/element?rev=1204769978 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 2009-03-07T17:24:02-08:00 http://www.read.cs.ucla.edu/click/elements?rev=1236475442 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… text/html 2007-02-22T10:00:34-08:00 http://www.read.cs.ucla.edu/click/errorhandlers?rev=1172167234 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 t… text/html 2008-01-17T12:14:43-08:00 http://www.read.cs.ucla.edu/click/examples?rev=1200600883 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 2009-02-03T01:23:56-08:00 http://www.read.cs.ucla.edu/click/faq?rev=1233653036 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 2007-07-17T13:10:03-08:00 http://www.read.cs.ucla.edu/click/git?rev=1184703003 Click sources are maintained in a Git repository. Most Click developers and users should rely on the Git sources (or the anonymous CVS version), since we release Click infrequently. Git is a distributed source control management system. View current Click sources View current Click packages sources text/html 2008-03-11T06:52:35-08:00 http://www.read.cs.ucla.edu/click/learning?rev=1205243555 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-08:00 http://www.read.cs.ucla.edu/click/license?rev=1172163690 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 2006-12-30T17:56:31-08:00 http://www.read.cs.ucla.edu/click/nsclick?rev=1167530191 Download a version of ns-2.30 or ns-allinone-2.30 from http://www.isi.edu/nsnam/ns/. Then download Click from anonymous CVS. Follow the instructions in Click's INSTALL file. Look for the section called "NS MODULE". That section is copied below, in a version from 12/30/2006. text/html 2007-01-26T17:57:55-08:00 http://www.read.cs.ucla.edu/click/packages?rev=1169863075 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-08:00 http://www.read.cs.ucla.edu/click/packet?rev=1170074115 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-08:00 http://www.read.cs.ucla.edu/click/programmingconcepts?rev=1203053207 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 2008-08-29T08:00:24-08:00 http://www.read.cs.ucla.edu/click/projects?rev=1220022024 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) text/html 2008-10-30T12:13:49-08:00 http://www.read.cs.ucla.edu/click/publications?rev=1225394029 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… text/html 2006-06-21T21:59:05-08:00 http://www.read.cs.ucla.edu/click/todo?rev=1150952345 * 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-08:00 http://www.read.cs.ucla.edu/click/tutorial1?rev=1203521785 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-08:00 http://www.read.cs.ucla.edu/click/tutorial1solutions?rev=1189115787 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.