root/branches/ppalmers-streaming/src/libstreaming/util/IsoHandlerManager.cpp

Revision 705, 21.3 kB (checked in by ppalmers, 15 years ago)

restructure the streaming directory

Line 
1 /*
2  * Copyright (C) 2005-2007 by Pieter Palmers
3  *
4  * This file is part of FFADO
5  * FFADO = Free Firewire (pro-)audio drivers for linux
6  *
7  * FFADO is based upon FreeBoB.
8  *
9  * This library is free software; you can redistribute it and/or
10  * modify it under the terms of the GNU Lesser General Public
11  * License version 2.1, as published by the Free Software Foundation;
12  *
13  * This library is distributed in the hope that it will be useful,
14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
16  * Lesser General Public License for more details.
17  *
18  * You should have received a copy of the GNU Lesser General Public
19  * License along with this library; if not, write to the Free Software
20  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
21  * MA 02110-1301 USA
22  */
23
24 #include "IsoHandlerManager.h"
25 #include "IsoHandler.h"
26 #include "../generic/IsoStream.h"
27
28 #include "libutil/PosixThread.h"
29
30 #include <assert.h>
31
32 #define MINIMUM_INTERRUPTS_PER_PERIOD  2U
33 #define PACKETS_PER_INTERRUPT          4U
34
35 namespace Streaming
36 {
37
38 IMPL_DEBUG_MODULE( IsoHandlerManager, IsoHandlerManager, DEBUG_LEVEL_NORMAL );
39
40 IsoHandlerManager::IsoHandlerManager() :
41    m_State(E_Created),
42    m_poll_timeout(100), m_poll_fds(0), m_poll_nfds(0),
43    m_realtime(false), m_priority(0)
44 {
45
46 }
47
48 IsoHandlerManager::IsoHandlerManager(bool run_rt, unsigned int rt_prio) :
49    m_State(E_Created),
50    m_poll_timeout(1), m_poll_fds(0), m_poll_nfds(0),
51    m_realtime(run_rt), m_priority(rt_prio)
52 {
53
54 }
55
56 IsoHandlerManager::~IsoHandlerManager()
57 {
58
59 }
60
61 bool IsoHandlerManager::init()
62 {
63     // the tread that performs the actual packet transfer
64     // needs high priority
65     unsigned int prio=m_priority+6;
66
67     if (prio>98) prio=98;
68
69     m_isoManagerThread=new Util::PosixThread(
70         this,
71         m_realtime, prio,
72         PTHREAD_CANCEL_DEFERRED);
73
74     if(!m_isoManagerThread) {
75         debugFatal("Could not create iso manager thread\n");
76         return false;
77     }
78
79     // propagate the debug level
80 //     m_isoManagerThread->setVerboseLevel(getDebugLevel());
81
82     return true;
83 }
84
85 bool IsoHandlerManager::Init()
86 {
87     debugOutput( DEBUG_LEVEL_VERBOSE, "enter...\n");
88     pthread_mutex_init(&m_debug_lock, NULL);
89
90     return true;
91 }
92
93 /**
94  * the IsoHandlerManager thread execute function iterates the handlers.
95  *
96  * This means that once the thread is running, streams are
97  * transmitted and received (if present on the bus). Make sure
98  * that the clients are registered & ready before starting the
99  * thread!
100  *
101  * The register and unregister functions are thread unsafe, so
102  * should not be used when the thread is running.
103  *
104  * @return false if the handlers could not be iterated.
105  */
106 bool IsoHandlerManager::Execute()
107 {
108 //     updateCycleTimers();
109
110     pthread_mutex_lock(&m_debug_lock);
111
112     if(!iterate()) {
113         debugFatal("Could not iterate the isoManager\n");
114         pthread_mutex_unlock(&m_debug_lock);
115         return false;
116     }
117
118     pthread_mutex_unlock(&m_debug_lock);
119
120     return true;
121 }
122
123 /**
124  * Poll the handlers managed by this manager, and iterate them
125  * when ready
126  *
127  * @return true when successful
128  */
129 bool IsoHandlerManager::iterate()
130 {
131     int err;
132     int i=0;
133     debugOutput( DEBUG_LEVEL_VERY_VERBOSE, "enter...\n");
134
135     err = poll (m_poll_fds, m_poll_nfds, m_poll_timeout);
136
137     if (err == -1) {
138         if (errno == EINTR) {
139             return true;
140         }
141         debugFatal("poll error: %s\n", strerror (errno));
142         return false;
143     }
144
145     for (i = 0; i < m_poll_nfds; i++) {
146         if (m_poll_fds[i].revents & POLLERR) {
147             debugWarning("error on fd for %d\n",i);
148         }
149
150         if (m_poll_fds[i].revents & POLLHUP) {
151             debugWarning("hangup on fd for %d\n",i);
152         }
153
154         if(m_poll_fds[i].revents & (POLLIN)) {
155             IsoHandler *s=m_IsoHandlers.at(i);
156             assert(s);
157
158             s->iterate();
159         }
160     }
161
162     return true;
163
164 }
165
166 bool IsoHandlerManager::registerHandler(IsoHandler *handler)
167 {
168     debugOutput( DEBUG_LEVEL_VERBOSE, "enter...\n");
169     assert(handler);
170
171     m_IsoHandlers.push_back(handler);
172
173     handler->setVerboseLevel(getDebugLevel());
174
175     // rebuild the fd map for poll()'ing.
176     return rebuildFdMap();
177
178 }
179
180 bool IsoHandlerManager::unregisterHandler(IsoHandler *handler)
181 {
182     debugOutput( DEBUG_LEVEL_VERBOSE, "enter...\n");
183     assert(handler);
184
185     for ( IsoHandlerVectorIterator it = m_IsoHandlers.begin();
186       it != m_IsoHandlers.end();
187       ++it )
188     {
189         if ( *it == handler ) {
190             // erase the iso handler from the list
191             m_IsoHandlers.erase(it);
192             // rebuild the fd map for poll()'ing.
193             return rebuildFdMap();
194         }
195     }
196     debugFatal("Could not find handler (%p)\n", handler);
197
198     return false; //not found
199
200 }
201
202 bool IsoHandlerManager::rebuildFdMap() {
203     debugOutput( DEBUG_LEVEL_VERBOSE, "enter...\n");
204     int i=0;
205
206     m_poll_nfds=0;
207     if(m_poll_fds) free(m_poll_fds);
208
209     // count the number of handlers
210     m_poll_nfds=m_IsoHandlers.size();
211
212     // allocate the fd array
213     m_poll_fds   = (struct pollfd *) calloc (m_poll_nfds, sizeof (struct pollfd));
214     if(!m_poll_fds) {
215         debugFatal("Could not allocate memory for poll FD array\n");
216         return false;
217     }
218
219     // fill the fd map
220     for ( IsoHandlerVectorIterator it = m_IsoHandlers.begin();
221       it != m_IsoHandlers.end();
222       ++it )
223     {
224         m_poll_fds[i].fd=(*it)->getFileDescriptor();
225         m_poll_fds[i].events = POLLIN;
226         i++;
227     }
228
229     return true;
230 }
231
232 void IsoHandlerManager::disablePolling(IsoStream *stream) {
233     int i=0;
234
235     debugOutput(DEBUG_LEVEL_VERY_VERBOSE, "Disable polling on stream %p\n",stream);
236
237     for ( IsoHandlerVectorIterator it = m_IsoHandlers.begin();
238         it != m_IsoHandlers.end();
239         ++it )
240     {
241         if ((*it)->isStreamRegistered(stream)) {
242             m_poll_fds[i].events = 0;
243             m_poll_fds[i].revents = 0;
244             debugOutput(DEBUG_LEVEL_VERY_VERBOSE, "polling disabled\n");
245         }
246
247         i++;
248     }
249 }
250
251 void IsoHandlerManager::enablePolling(IsoStream *stream) {
252     int i=0;
253
254     debugOutput(DEBUG_LEVEL_VERY_VERBOSE, "Enable polling on stream %p\n",stream);
255
256     for ( IsoHandlerVectorIterator it = m_IsoHandlers.begin();
257         it != m_IsoHandlers.end();
258         ++it )
259     {
260         if ((*it)->isStreamRegistered(stream)) {
261             m_poll_fds[i].events = POLLIN;
262             m_poll_fds[i].revents = 0;
263             debugOutput(DEBUG_LEVEL_VERY_VERBOSE, "polling enabled\n");
264         }
265
266         i++;
267     }
268 }
269
270
271 /**
272  * Registers an IsoStream with the IsoHandlerManager.
273  *
274  * If nescessary, an IsoHandler is created to handle this stream.
275  * Once an IsoStream is registered to the handler, it will be included
276  * in the ISO streaming cycle (i.e. receive/transmit of it will occur).
277  *
278  * @param stream the stream to register
279  * @return true if registration succeeds
280  *
281  * \todo : currently there is a one-to-one mapping
282  *        between streams and handlers, this is not ok for
283  *        multichannel receive
284  */
285 bool IsoHandlerManager::registerStream(IsoStream *stream)
286 {
287     debugOutput( DEBUG_LEVEL_VERBOSE, "Registering stream %p\n",stream);
288     assert(stream);
289
290     // make sure the stream isn't already attached to a handler
291     for ( IsoHandlerVectorIterator it = m_IsoHandlers.begin();
292       it != m_IsoHandlers.end();
293       ++it )
294     {
295         if((*it)->isStreamRegistered(stream)) {
296             debugWarning( "stream already registered!\n");
297             (*it)->unregisterStream(stream);
298
299         }
300     }
301
302     // clean up all handlers that aren't used
303     pruneHandlers();
304
305     // allocate a handler for this stream
306     if (stream->getType()==IsoStream::EST_Receive) {
307         // setup the optimal parameters for the raw1394 ISO buffering
308         unsigned int packets_per_period=stream->getPacketsPerPeriod();
309
310 #if 1
311         // hardware interrupts occur when one DMA block is full, and the size of one DMA
312         // block = PAGE_SIZE. Setting the max_packet_size makes sure that the HW irq
313         // occurs at a period boundary (optimal CPU use)
314
315         // NOTE: try and use MINIMUM_INTERRUPTS_PER_PERIOD hardware interrupts
316         //       per period for better latency.
317         unsigned int max_packet_size=(MINIMUM_INTERRUPTS_PER_PERIOD * getpagesize()) / packets_per_period;
318         if (max_packet_size < stream->getMaxPacketSize()) {
319             max_packet_size=stream->getMaxPacketSize();
320         }
321
322         // Ensure we don't request a packet size bigger than the
323         // kernel-enforced maximum which is currently 1 page.
324         if (max_packet_size > (unsigned int)getpagesize())
325                     max_packet_size = getpagesize();
326
327         unsigned int irq_interval=packets_per_period / MINIMUM_INTERRUPTS_PER_PERIOD;
328         if(irq_interval <= 0) irq_interval=1;
329 #else
330         // hardware interrupts occur when one DMA block is full, and the size of one DMA
331         // block = PAGE_SIZE. Setting the max_packet_size enables control over the IRQ
332         // frequency, as the controller uses max_packet_size, and not the effective size
333         // when writing to the DMA buffer.
334
335         // configure it such that we have an irq for every PACKETS_PER_INTERRUPT packets
336         unsigned int irq_interval=PACKETS_PER_INTERRUPT;
337
338         // unless the period size doesn't allow this
339         if ((packets_per_period/MINIMUM_INTERRUPTS_PER_PERIOD) < irq_interval) {
340             irq_interval=1;
341         }
342
343         // FIXME: test
344         irq_interval=1;
345 #warning Using fixed irq_interval
346
347         unsigned int max_packet_size=getpagesize() / irq_interval;
348
349         if (max_packet_size < stream->getMaxPacketSize()) {
350             max_packet_size=stream->getMaxPacketSize();
351         }
352
353         // Ensure we don't request a packet size bigger than the
354         // kernel-enforced maximum which is currently 1 page.
355         if (max_packet_size > (unsigned int)getpagesize())
356                     max_packet_size = getpagesize();
357
358 #endif
359         /* the receive buffer size doesn't matter for the latency,
360            but it has a minimal value in order for libraw to operate correctly (300) */
361         int buffers=400;
362
363         // create the actual handler
364         IsoRecvHandler *h = new IsoRecvHandler(stream->getPort(), buffers,
365                                                max_packet_size, irq_interval);
366
367         debugOutput( DEBUG_LEVEL_VERBOSE, " registering IsoRecvHandler\n");
368
369         if(!h) {
370             debugFatal("Could not create IsoRecvHandler\n");
371             return false;
372         }
373
374         h->setVerboseLevel(getDebugLevel());
375
376         // init the handler
377         if(!h->init()) {
378             debugFatal("Could not initialize receive handler\n");
379             return false;
380         }
381
382         // register the stream with the handler
383         if(!h->registerStream(stream)) {
384             debugFatal("Could not register receive stream with handler\n");
385             return false;
386         }
387
388         // register the handler with the manager
389         if(!registerHandler(h)) {
390             debugFatal("Could not register receive handler with manager\n");
391             return false;
392         }
393         debugOutput( DEBUG_LEVEL_VERBOSE, " registered stream (%p) with handler (%p)\n",stream,h);
394     }
395
396     if (stream->getType()==IsoStream::EST_Transmit) {
397         // setup the optimal parameters for the raw1394 ISO buffering
398         unsigned int packets_per_period=stream->getPacketsPerPeriod();
399
400 #if 1
401         // hardware interrupts occur when one DMA block is full, and the size of one DMA
402         // block = PAGE_SIZE. Setting the max_packet_size makes sure that the HW irq
403         // occurs at a period boundary (optimal CPU use)
404         // NOTE: try and use MINIMUM_INTERRUPTS_PER_PERIOD interrupts per period
405         //       for better latency.
406         unsigned int max_packet_size=MINIMUM_INTERRUPTS_PER_PERIOD * getpagesize() / packets_per_period;
407         if (max_packet_size < stream->getMaxPacketSize()) {
408             max_packet_size=stream->getMaxPacketSize();
409         }
410
411         // Ensure we don't request a packet size bigger than the
412         // kernel-enforced maximum which is currently 1 page.
413         if (max_packet_size > (unsigned int)getpagesize())
414                     max_packet_size = getpagesize();
415
416          unsigned int irq_interval=packets_per_period / MINIMUM_INTERRUPTS_PER_PERIOD;
417          if(irq_interval <= 0) irq_interval=1;
418 #else
419         // hardware interrupts occur when one DMA block is full, and the size of one DMA
420         // block = PAGE_SIZE. Setting the max_packet_size enables control over the IRQ
421         // frequency, as the controller uses max_packet_size, and not the effective size
422         // when writing to the DMA buffer.
423
424         // configure it such that we have an irq for every PACKETS_PER_INTERRUPT packets
425         unsigned int irq_interval=PACKETS_PER_INTERRUPT;
426
427         // unless the period size doesn't allow this
428         if ((packets_per_period/MINIMUM_INTERRUPTS_PER_PERIOD) < irq_interval) {
429             irq_interval=1;
430         }
431
432         // FIXME: test
433         irq_interval=1;
434 #warning Using fixed irq_interval
435
436         unsigned int max_packet_size=getpagesize() / irq_interval;
437
438         if (max_packet_size < stream->getMaxPacketSize()) {
439             max_packet_size=stream->getMaxPacketSize();
440         }
441
442         // Ensure we don't request a packet size bigger than the
443         // kernel-enforced maximum which is currently 1 page.
444         if (max_packet_size > (unsigned int)getpagesize())
445                     max_packet_size = getpagesize();
446 #endif
447         // the transmit buffer size should be as low as possible for latency.
448         // note however that the raw1394 subsystem tries to keep this buffer
449         // full, so we have to make sure that we have enough events in our
450         // event buffers
451
452         // every irq_interval packets an interrupt will occur. that is when
453         // buffers get transfered, meaning that we should have at least some
454         // margin here
455         int buffers=irq_interval * 2;
456
457         // half a period. the xmit handler will take care of this
458 //         int buffers=packets_per_period/4;
459
460         // NOTE: this is dangerous: what if there is not enough prefill?
461 //         if (buffers<10) buffers=10;
462
463         // create the actual handler
464         IsoXmitHandler *h = new IsoXmitHandler(stream->getPort(), buffers,
465                                                max_packet_size, irq_interval);
466
467         debugOutput( DEBUG_LEVEL_VERBOSE, " registering IsoXmitHandler\n");
468
469         if(!h) {
470             debugFatal("Could not create IsoXmitHandler\n");
471             return false;
472         }
473
474         h->setVerboseLevel(getDebugLevel());
475
476         // init the handler
477         if(!h->init()) {
478             debugFatal("Could not initialize transmit handler\n");
479             return false;
480         }
481
482         // register the stream with the handler
483         if(!h->registerStream(stream)) {
484             debugFatal("Could not register transmit stream with handler\n");
485             return false;
486         }
487
488         // register the handler with the manager
489         if(!registerHandler(h)) {
490             debugFatal("Could not register transmit handler with manager\n");
491             return false;
492         }
493         debugOutput( DEBUG_LEVEL_VERBOSE, " registered stream (%p) with handler (%p)\n",stream,h);
494     }
495
496     m_IsoStreams.push_back(stream);
497     debugOutput( DEBUG_LEVEL_VERBOSE, " %d streams, %d handlers registered\n",
498                                       m_IsoStreams.size(), m_IsoHandlers.size());
499
500     return true;
501 }
502
503 bool IsoHandlerManager::unregisterStream(IsoStream *stream)
504 {
505     debugOutput( DEBUG_LEVEL_VERBOSE, "Unregistering stream %p\n",stream);
506     assert(stream);
507
508     // make sure the stream isn't attached to a handler anymore
509     for ( IsoHandlerVectorIterator it = m_IsoHandlers.begin();
510       it != m_IsoHandlers.end();
511       ++it )
512     {
513         if((*it)->isStreamRegistered(stream)) {
514             if(!(*it)->unregisterStream(stream)) {
515                 debugOutput( DEBUG_LEVEL_VERBOSE, " could not unregister stream (%p) from handler (%p)...\n",stream,*it);
516                 return false;
517             }
518
519             debugOutput( DEBUG_LEVEL_VERBOSE, " unregistered stream (%p) from handler (%p)...\n",stream,*it);
520         }
521     }
522
523     // clean up all handlers that aren't used
524     pruneHandlers();
525
526     // remove the stream from the registered streams list
527     for ( IsoStreamVectorIterator it = m_IsoStreams.begin();
528       it != m_IsoStreams.end();
529       ++it )
530     {
531         if ( *it == stream ) {
532             m_IsoStreams.erase(it);
533
534             debugOutput( DEBUG_LEVEL_VERBOSE, " deleted stream (%p) from list...\n", *it);
535             return true;
536         }
537     }
538
539     return false; //not found
540
541 }
542
543 void IsoHandlerManager::pruneHandlers() {
544     debugOutput( DEBUG_LEVEL_VERBOSE, "enter...\n");
545     IsoHandlerVector toUnregister;
546
547     // find all handlers that are not in use
548     for ( IsoHandlerVectorIterator it = m_IsoHandlers.begin();
549           it != m_IsoHandlers.end();
550           ++it )
551     {
552         if(!((*it)->inUse())) {
553             debugOutput( DEBUG_LEVEL_VERBOSE, " handler (%p) not in use\n",*it);
554             toUnregister.push_back(*it);
555         }
556     }
557     // delete them
558     for ( IsoHandlerVectorIterator it = toUnregister.begin();
559           it != toUnregister.end();
560           ++it )
561     {
562         unregisterHandler(*it);
563         debugOutput( DEBUG_LEVEL_VERBOSE, " deleting handler (%p)\n",*it);
564
565         // Now the handler's been unregistered it won't be reused
566         // again.  Therefore it really needs to be formally deleted
567         // to free up the raw1394 handle.  Otherwise things fall
568         // apart after several xrun recoveries as the system runs
569         // out of resources to support all the disused but still
570         // allocated raw1394 handles.  At least this is the current
571         // theory as to why we end up with "memory allocation"
572         // failures after several Xrun recoveries.
573         delete *it;
574     }
575
576 }
577
578
579 bool IsoHandlerManager::prepare()
580 {
581     bool retval=true;
582
583     debugOutput( DEBUG_LEVEL_VERBOSE, "enter...\n");
584
585     // check state
586     if(m_State != E_Created) {
587         debugError("Incorrect state, expected E_Created, got %d\n",(int)m_State);
588         return false;
589     }
590
591     for ( IsoHandlerVectorIterator it = m_IsoHandlers.begin();
592           it != m_IsoHandlers.end();
593           ++it )
594     {
595         if(!(*it)->prepare()) {
596             debugFatal("Could not prepare handlers\n");
597             retval=false;
598         }
599     }
600
601     if (retval) {
602         m_State=E_Prepared;
603     } else {
604         m_State=E_Error;
605     }
606
607     return retval;
608 }
609
610 bool IsoHandlerManager::startHandlers() {
611     return startHandlers(-1);
612 }
613
614 bool IsoHandlerManager::startHandlers(int cycle) {
615     bool retval=true;
616
617     debugOutput( DEBUG_LEVEL_VERBOSE, "enter...\n");
618
619     // check state
620     if(m_State != E_Prepared) {
621         debugError("Incorrect state, expected E_Prepared, got %d\n",(int)m_State);
622         return false;
623     }
624
625     for ( IsoHandlerVectorIterator it = m_IsoHandlers.begin();
626         it != m_IsoHandlers.end();
627         ++it )
628     {
629         debugOutput( DEBUG_LEVEL_VERBOSE, " starting handler (%p)\n",*it);
630         if(!(*it)->start(cycle)) {
631             debugOutput( DEBUG_LEVEL_VERBOSE, " could not start handler (%p)\n",*it);
632             retval=false;
633         }
634     }
635
636     debugOutput( DEBUG_LEVEL_VERBOSE, "Starting ISO iterator thread...\n");
637
638     // note: libraw1394 doesn't like it if you poll() and/or iterate() before
639     //       starting the streams.
640     // start the iso runner thread
641     m_isoManagerThread->Start();
642
643     if (retval) {
644         m_State=E_Running;
645     } else {
646         m_State=E_Error;
647     }
648
649     return retval;
650 }
651
652 bool IsoHandlerManager::stopHandlers() {
653     debugOutput( DEBUG_LEVEL_VERBOSE, "enter...\n");
654
655     // check state
656     if(m_State != E_Running) {
657         debugError("Incorrect state, expected E_Running, got %d\n",(int)m_State);
658         return false;
659     }
660
661     bool retval=true;
662
663     debugOutput( DEBUG_LEVEL_VERBOSE, "Stopping ISO iterator thread...\n");
664     m_isoManagerThread->Stop();
665
666     for ( IsoHandlerVectorIterator it = m_IsoHandlers.begin();
667         it != m_IsoHandlers.end();
668         ++it )
669     {
670         debugOutput( DEBUG_LEVEL_VERBOSE, "Stopping handler (%p)\n",*it);
671         if(!(*it)->stop()){
672             debugOutput( DEBUG_LEVEL_VERBOSE, " could not stop handler (%p)\n",*it);
673             retval=false;
674         }
675     }
676
677     if (retval) {
678         m_State=E_Prepared;
679     } else {
680         m_State=E_Error;
681     }
682
683     return retval;
684 }
685
686 bool IsoHandlerManager::reset() {
687     debugOutput( DEBUG_LEVEL_VERBOSE, "enter...\n");
688
689     // check state
690     if(m_State == E_Error) {
691         debugFatal("Resetting from error condition not yet supported...\n");
692         return false;
693     }
694
695     // if not in an error condition, reset means stop the handlers
696     return stopHandlers();
697 }
698
699
700 void IsoHandlerManager::setVerboseLevel(int i) {
701     setDebugLevel(i);
702
703     for ( IsoHandlerVectorIterator it = m_IsoHandlers.begin();
704           it != m_IsoHandlers.end();
705           ++it )
706     {
707         (*it)->setVerboseLevel(i);
708     }
709 }
710
711 void IsoHandlerManager::dumpInfo() {
712     int i=0;
713
714     debugOutputShort( DEBUG_LEVEL_NORMAL, "Dumping IsoHandlerManager Stream handler information...\n");
715     debugOutputShort( DEBUG_LEVEL_NORMAL, " State: %d\n",(int)m_State);
716
717     for ( IsoHandlerVectorIterator it = m_IsoHandlers.begin();
718           it != m_IsoHandlers.end();
719           ++it )
720     {
721         debugOutputShort( DEBUG_LEVEL_NORMAL, " IsoHandler %d (%p)\n",i++,*it);
722
723         (*it)->dumpInfo();
724     }
725
726 }
727
728 } // end of namespace Streaming
729
Note: See TracBrowser for help on using the browser.