http://www.okws.org/ 2010-09-09T09:55:29+00:00 http://www.okws.org/ http://www.okws.org/lib/images/favicon.ico text/html 2010-08-19T20:07:33+00:00 http://www.okws.org/doku.php?id=okws:aarr&rev=1282248453&do=diff Name/value dictionaries used mainly in the publishing system. text/html 2010-08-19T20:07:33+00:00 http://www.okws.org/doku.php?id=okws:configure&rev=1282248453&do=diff text/html 2010-04-23T15:42:36+00:00 http://www.okws.org/doku.php?id=okws:dict&rev=1272037356&do=diff See libpub/pub3expr.h and look for the class expr_dict_t. These are OKWS dictionaries that are used to make dictionaries of name-value pairs, in which the names are tips and the values are generic pub3 expressions (pub3::expr_t's.) text/html 2010-08-19T20:07:33+00:00 http://www.okws.org/doku.php?id=okws:dmalloc&rev=1282248453&do=diff Dmalloc is a very handy malloc debugging library by Gray Watson, available in the sfslite-dbg and okws-dbg ports supported by OKWS on FreeBSD, and other other platforms when compiling from source. How To Use Dmalloc With OKWS Dmalloc is useful for tracking down memory corruptions such as double-frees, access-after-free, access-unitilized-data and so on. It also helps to find memory leaks. To use dmalloc, first make sure you're linked against the libraries, by either installing the ports desc… text/html 2008-09-17T12:40:37+00:00 http://www.okws.org/doku.php?id=okws:example.c&rev=1221655237&do=diff namespace RPC { program MY_PROG { version MY_VERSION { res_t MY_FUNC(arg_t) = 1; } = 2; } = 1; }; tamed void window_rpc (vec<args_t> arg, evb_t ev) { tvars { vec<clnt_stat> stat; vec<res_t> res; vec<size_t> slots; size_t window (10); rendezvous_t<size_t> rv; size_t id; bool rc (true); } stat.setsize (window); res.setsize (window); for (size_t i = 0; i < window; i++) { slots.push_back (i); } while (arg.size () && slots.size () … text/html 2010-08-19T20:07:33+00:00 http://www.okws.org/doku.php?id=okws:features&rev=1282248453&do=diff OKWS allows developers to program their Web applications in C++, a compiled and strongly-typed language. We realize that many features of Perl or Python make them seem better-suited to Web programming, but OKWS makes compiled, fast, secure code easy for programmers. It provides: text/html 2010-08-19T20:07:33+00:00 http://www.okws.org/doku.php?id=okws:installing&rev=1282248453&do=diff FreeBSD Update 12/26/06 I've stopped maintaining the FreeBSD ports, so these directions are temporarily out of date. How Ports Used to Work We have started the process of pushing OKWS build files into the FreeBSD main ports tree, but for now, we offer a simple script to patch your ports tree to build OKWS: text/html 2010-08-19T20:07:33+00:00 http://www.okws.org/doku.php?id=okws:interal&rev=1282248453&do=diff text/html 2010-08-19T20:07:33+00:00 http://www.okws.org/doku.php?id=okws:international&rev=1282248453&do=diff 11:45:07) max: ok, there are two classes that are important (11:45:28) max: actually not even (11:45:42) max: if you look at test2/unit/static.T in okws1.0 (11:45:55) max: in the ::process function, there's a call to set_localizer (11:46:07) max: a localizer is an object that runs internal to the publishing system (11:46:24) max: when the publishing system is looking for a content page, it builds up a little search path (11:46:41) max: if you supply a localizer, it can add an additional file to … text/html 2010-08-19T20:07:33+00:00 http://www.okws.org/doku.php?id=okws:libasync&rev=1282248453&do=diff The SFS programming library, made available via a stripped down distribution called sfslite. text/html 2010-04-01T00:49:54+00:00 http://www.okws.org/doku.php?id=okws:newfeatures3&rev=1270082994&do=diff Outline * Scoping --- ''globals'', ''locals'' and ''universals'' * Lambdas and Functions * New Control Structures * Heredoc! Next text/html 2010-04-02T17:36:15+00:00 http://www.okws.org/doku.php?id=okws:obtaining&rev=1270229775&do=diff As part of our ToDo list, we intend to distribution OKWS as ports/packages for various platforms. For now, we rely on the old-fashioned methods: Anonymous Subversion The best way to obtain OKWS is from anonymous subversion access: % svn co svn://svn2.okws.org/ok/okws2/devel/3.0 okws-3.0 Source Releases Date Release Name Size Description9/26/05okws-0.2.tar.gz534K0.2 Release6/12/06okws-1.0.tar.gz785K1.0 Release1/16/09okws-1.3.0.tar.gz1.0M1.3 Release3/15/09okws-1.4.0.tar.gz1.0M1.4 Release text/html 2010-08-19T20:07:33+00:00 http://www.okws.org/doku.php?id=okws:okws_config&rev=1282248453&do=diff The main configuration file for the OKWS system. Read in by okld on startup. text/html 2009-05-07T17:01:27+00:00 http://www.okws.org/doku.php?id=okws:oldinstall&rev=1241715687&do=diff At present, OKWS services are built on top of the SFS libraries. To build OKWS services on your machine, you'll first need a reasonable installation of SFS, an installation of the OKWS core services and libraries, and finally, a development directory that allows you to build and link against the OKWS libraries. This document will step through the key points of this installation process, and will also detail some common configuration options. text/html 2010-04-23T17:19:41+00:00 http://www.okws.org/doku.php?id=okws:pub&rev=1272043181&do=diff The OKWS "Pub" Language The OKWS publishing system is a way for programmers to separate their C++ code and their HTML, and to keep the HTML on the file system where it's most convenient to manage. There are two sides to this system, then: * C++ bindings - in your OKWS services, you'll use these to read HTML templates off the file system, parse them, and publish them. * The templates themselves - OKWS templates look a lot like HTML, JS, CSS, or whatever else you're trying to publish, b… text/html 2010-08-19T20:07:33+00:00 http://www.okws.org/doku.php?id=okws:pub2&rev=1282248453&do=diff OKWS pubbing is now versioned up to pub3. pub3 is backwards compatible with pub2, but much of the syntax has newer, shorter alternatives, so read the new spec. Pub Protocol v2 The OKWS publishing system is a way for programmers to separate their C++ code and their HTML, and to keep the HTML on the file system where it's most convenient to manage. There are two sides to this system, then. On the one hand there are C++ bindings for reading HTML templates off the file system, and parsing them… text/html 2009-11-12T15:40:04+00:00 http://www.okws.org/doku.php?id=okws:pub3&rev=1258040404&do=diff Pub Protocol v3 a.k.a Pub3 The OKWS publishing system is a way for programmers to separate their C++ code and their HTML, and to keep the HTML on the file system where it's most convenient to manage. There are two sides to this system, then: * C++ bindings - in your OKWS services, you'll use these to read HTML templates off the file system, parse them, and publish them. * The templates themselves - OKWS templates look a lot like HTML, JS, CSS, or whatever else you're trying to publish… text/html 2010-08-19T20:07:33+00:00 http://www.okws.org/doku.php?id=okws:publications&rev=1282248453&do=diff * Building Secure High-Performance Web Services With OKWS Maxwell Krohn Proceedings of the 2004 USENIX Annual Technical Conference (USENIX '04) Boston, MA, June 2004. [ ps, ps.gz, pdf ] * Building Fast and Secure Web Services with OKWS Maxwell Krohn, advised by M. Frans Kaashoek September 2005. [ ps, ps.gz, pdf ] text/html 2010-03-30T20:58:51+00:00 http://www.okws.org/doku.php?id=okws:releaseplan&rev=1269982731&do=diff Release 3.0, Spring 2010 * Pure Pub3 interiors * Lambdas / pub3-pure functions * blocks pub3-functions in C++ * globals/locals/universals namespaces * COW-mechanics worked out for pub syntax tree * stripped a lot of cruft out Release 3.1, Summer 2010 * JSON-RPC? text/html 2010-08-19T20:07:33+00:00 http://www.okws.org/doku.php?id=okws:requirements&rev=1282248453&do=diff text/html 2010-08-19T20:07:33+00:00 http://www.okws.org/doku.php?id=okws:serviceipc&rev=1282248453&do=diff When communication across services is required, a simple API is available via RPC. One-Way Communication The best-tested, most stable way to do this is with one-way communication, via the CUSTOM1 RPC interface. This is, a client in one service makes an RPC to servers in different services. The servers respond with a status code, and a combined status code is sent back to the calling client. Note that there is no way for the servers to communicate back to the client, but they could, in tu… text/html 2010-08-19T20:07:33+00:00 http://www.okws.org/doku.php?id=okws:sfslite&rev=1282248453&do=diff This page moved to here text/html 2010-08-19T20:07:33+00:00 http://www.okws.org/doku.php?id=okws:sponsorship&rev=1282248453&do=diff OKWS was partially funded by the DARPA Composable High Assurance Trusted Systems program (BAA #01-24), under contract #N66001-01-1-8927. text/html 2010-08-19T20:07:33+00:00 http://www.okws.org/doku.php?id=okws:static&rev=1282248453&do=diff As you may or may not have noticed, okws.org runs on the Apache Web Server. (We've also recently ported okws.org to a PHP-based Wiki, which is really cool software.) Unlike typical Web servers, OKWS is specialized for dynamic content and is not well-suited to serving files from disk. Sites that use OKWS therefore rely on typical Web servers (such as Apache) to serve images and other static content. In the OKWS paper, we argue that the separation of static and dynamic content across multiple mach… text/html 2010-08-19T20:07:33+00:00 http://www.okws.org/doku.php?id=okws:style&rev=1282248453&do=diff Most of the work in an OKWS service is done inside a class that inherits from okclnt_t. Assume a trivial class derived from okclnt_t and also a related class direved from oksrvc_t: class oksrvc_foo_t : public oksrvc_t { public: oksrvc_foo_t (int argc, char *argv[]) : oksrvc_t (argc, argv) {} okclnt_t *make_newclnt (ptr<ahttpcon> x); }; class okclnt_foo_t : public okclnt_t { public: okclnt_foo_t (ptr<ahttpcon> x, oksrvc_foo_t *v) : okclnt_t (x, o), _foo_service (v)… text/html 2010-08-19T20:07:33+00:00 http://www.okws.org/doku.php?id=okws:tame&rev=1282248453&do=diff Tame v1 is supported in sfslite version 0.8. As of sfslite version 1, we've migrated to Tame v2, documentation for which is available here. tame is a generic tool for simplifying libasync programming, useful with OKWS, but also for any other libasync-based application. It is available under the sfslite distribution. tame is a simple C++-level rewriter. Input files look a lot like regular C++ files, with some small modifications. Output files are standard C++ files that are then compiled an… text/html 2010-03-30T20:53:32+00:00 http://www.okws.org/doku.php?id=okws:todo&rev=1269982412&do=diff List of requested features/bugfixes/upgrades to make OKWS more stable and usable. See the release plan for more release details and plans. Maintenance and Installation Who When What Status MK9/13/05Write a simple oknewmod utility that sets up a skeleton development directory. Should keep template files in /usr/local/share/okws or thereabouts.NoneMK9/18/05Installing py-sfs does not respect the 'install-prefix' for libpyarpc. I'm not really sure if this is a bug, since it just uses whatever SFS … text/html 2010-04-23T16:55:53+00:00 http://www.okws.org/doku.php?id=okws:tutorial&rev=1272041753&do=diff The gameplan for building and running a new service with OKWS is as follows: * Make a new standalone Unix executable that will be the Web service. The executable needs to follow the OKWS protocol for receving new connections from the demultiplexer, and also for interacting with the OKWS publishing system. Though it's possible to do this from scratch, it's much easier to use our supplied C++ libraries. * Install your new executable in the right place. If running OKWS as an unprivileged us… text/html 2010-08-19T20:07:33+00:00 http://www.okws.org/doku.php?id=okws:unwrap&rev=1282248453&do=diff The unwrap tool is deprecated! The new version of unwrap is called tame and is much improved. Please check it out. unwrap is a generic tool for simplying libasync programming, useful with OKWS, but also for any other libasync-based application. It is available under the sfslite distribution. unwrp is a simple C++-level rewriter. Input files look a lot like regular C++ files, with some small modifications. Output files are standard C++ files that are then compiled and linked against the li… text/html 2010-08-19T20:07:33+00:00 http://www.okws.org/doku.php?id=okws:update-1.0&rev=1282248453&do=diff If you've just upgraded from OKWS version 0.2 to version 1.0, you'll need to follow these brief directions on how to smooth the upgrade: Configuration Files Location change Though you scan still dump your config file in the old /etc/sfs/okws_config, OKWS1.0 and above prefer them in /usr/local/etc/okws/okws_config, and we recommend you put them there. The same goes for pub_config; we recommend the file location /usr/local/etc/okws/pub_config. text/html 2010-08-19T20:07:33+00:00 http://www.okws.org/doku.php?id=okws:users&rev=1282248453&do=diff * Ok Cupid: Free Online Matching * Movie-Madness.org * Addgene: Plasmid Repository For Life Sciences text/html 2010-08-19T20:07:33+00:00 http://www.okws.org/doku.php?id=okws:zbuf&rev=1282248453&do=diff zbuf is a class defined in libpub/zstr.h that OKWS uses a a buffer, that implements an intelligent gzip algorithm on data in the buffer. In particular, caches as much of the computation as possible, based on pre-gzipped chunks of incoming data.