Alex Rousskov wrote:
On Mon, 2007-03-26 at 23:59 +1200, Amos Jeffries wrote:
I have so far not placed any permanent debug statements in the IPAddress
object.
It's come about time I should be making some more permanent ones and so
need a section number. Is there some method I don't know yet for
assigning a unique level or do I just pick an unused number and write it in?
If you have not received better instructions yet, just use the next
unused number for the debug section and add it to your file(s) prefix
just like most other source files do.
The stale doc/debug-sections.txt is (or should be) generated based on
the source code. Do not update that file unless you are willing to
freshen it up first.
Cheers,
Alex.
Thank you Alex,
No I have not received any further instructions and assumed that was
the best action to take. I picked level 36, but that turns out to be
cache dir processing and I expect its in use own another branch.
If by 'freshen up' you mean rebuild the file from source using a grep of
the source files headers for "DEBUG section" and a manual massage. I did
that earlier before seeing the doc/ file. The update patch resulting is
attached.
FYI to all: IP Handling will join IP Cache in section 14, unless there
are any objections by easter.
Amos
--- DEBUG_levels.txt 2007-04-04 12:56:03.000000000 +1200
+++ doc/debug-sections.txt 2007-03-27 20:12:49.000000000 +1200
@@ -3,14 +3,11 @@
section 0 Client Database
section 0 Debug Routines
section 0 DNS Resolver
-section 0 Hash Tables
-section 0 UFS Store Dump
section 0 WWW Client
section 1 Startup and Main Loop
section 2 Unlink Daemon
section 3 Configuration File Parsing
section 4 Error Generation
-section 5 Comms
section 5 Socket Functions
section 6 Disk I/O Routines
section 7 Multicast
@@ -21,35 +18,21 @@
section 12 Internet Cache Protocol
section 13 High Level Memory Pool Management
section 14 IP Cache
-section 14 IP Storage and Handling
section 15 Neighbor Routines
section 16 Cache Manager Objects
section 17 Request Forwarding
section 18 Cache Manager Statistics
section 19 Store Memory Primitives
section 20 Storage Manager
-section 20 Storage Manager Heap-based replacement
-section 20 Storage Manager Logging Functions
-section 20 Storage Manager MD5 Cache Keys
-section 20 Storage Manager Swapfile Metadata
-section 20 Storage Manager Swapfile Unpacker
-section 20 Storage Manager Swapin Functions
-section 20 Storage Manager Swapout Functions
-section 20 Store Rebuild Routines
-section 21 Integer functions
section 21 Misc Functions
-section 21 Time Functions
section 22 Refresh Calculation
section 23 URL Parsing
-section 23 URL Scheme parsing
-
+section 24 WAIS Relay
section 25 MIME Parsing
section 26 Secure Sockets Layer Proxy
section 27 Cache Announcer
section 28 Access Control
section 29 Authenticator
-section 29 Negotiate Authenticator
-section 29 NTLM Authenticator
section 30 Ident (RFC 931)
section 31 Hypertext Caching Protocol
section 32 Asynchronous Disk I/O
@@ -61,26 +44,20 @@
section 38 Network Measurement Database
section 39 Cache Array Routing Protocol
section 40 User-Agent and Referer logging
-section 40 User-Agent logging
section 41 Event Processing
section 42 ICMP Pinger program
section 43 AIOPS
-section 43 Windows AIOPS
section 44 Peer Selection Algorithm
section 45 Callback Data Registry
section 46 Access Log
-section 47 Store COSS Directory Routines
section 47 Store Directory Routines
section 48 Persistent Connections
-section 49 SNMP Interface
-section 49 SNMP support
+section 49 SNMP
section 50 Log file handling
section 51 Filedescriptor Functions
section 52 URN Parsing
section 53 AS Number handling
-section 53 Radix tree data structure implementation
section 54 Interprocess Communication
-section 54 Windows Interprocess Communication
section 55 HTTP Header
section 56 HTTP Message Body
section 57 HTTP Status-line
@@ -89,7 +66,7 @@
section 60 Packer: A uniform interface to store-like modules
section 61 Redirector
section 62 Generic Histogram
-section 63 Low Level Memory Pool Management
+section 63 -
section 64 HTTP Range Header
section 65 HTTP Cache Control Header
section 66 HTTP Header Tools
@@ -104,38 +81,18 @@
section 75 WHOIS protocol
section 76 Internal Squid Object handling
section 77 Delay Pools
-section 78 DNS lookups; interacts with lib/rfc1035.c
-section 79 Disk IO Routines
-section 79 Squid-side DISKD I/O functions.
-section 79 Squid-side Disk I/O functions.
-section 79 Storage Manager COSS Interface
-section 79 Storage Manager UFS Interface
-section 80 WCCP Support
-section 81 aio_xxx() POSIX emulation on Windows
-section 81 CPU Profiling Routines
+section 78 DNS lookups
+section 79 Lowlevel store I/O
+section 80 WCCP
+section 81 Cache Store
section 82 External ACL
section 83 SSL accelerator support
section 84 Helper process maintenance
-section 85 Client-side Request Routines
-section 86 ESI Expressions
-section 86 ESI Processing
-section 87 Client-side Stream routines.
-section 88 Client-side Reply Routines
-section 89 NAT / IP Interception
-section 90 HTTP Cache Control Header
-section 90 Storage Manager Client-Side Interface
-
-section 92 Storage File System
-section 93 ICAP (RFC 3507) Client
-
-
-section ? Common Removal policy
-section -- External DISKD process implementation.
-section ?? FDE
-section ? HEAP based removal policies
-section ?? Linked list functions
-section ? LRU Removal policy
-section ??? Memory Allocation
-section ?? Swap Dir base object
-section xx Refcount allocator
-section xx RFC 1738 string [un]escaping
+section 85 Client side request management - after parsing, before caching
+section 86 ESI processing
+section 87 client side stream management
+section 88 Client side reply management - from store to stream
+section 89 NAT / IP Interception
+section 90 Store Client
+section 91 Http Surrogate-Control Header
+section 92 Store File System