This repository was archived by the owner on Jan 14, 2020. It is now read-only.
-
Notifications
You must be signed in to change notification settings - Fork 6
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
main/astobj2: Make REF_DEBUG a menuselect item; improve REF_DEBUG output
This patch does the following: (1) It makes REF_DEBUG a meneselect item. Enabling REF_DEBUG now enables REF_DEBUG globally throughout Asterisk. (2) The ref debug log file is now created in the AST_LOG_DIR directory. Every run will now blow away the previous run (as large ref files sometimes caused issues). We now also no longer open/close the file on each write, instead relying on fflush to make sure data gets written to the file (in case the ao2 call being performed is about to cause a crash) (3) It goes with a comma delineated format for the ref debug file. This makes parsing much easier. This also now includes the thread ID of the thread that caused ref change. (4) A new python script instead for refcounting has been added in the contrib/scripts folder. (5) The old refcounter implementation in utils/ has been removed. Review: https://reviewboard.asterisk.org/r/3377/ ........ Merged revisions 412114 from http://svn.asterisk.org/svn/asterisk/branches/1.8 ........ Merged revisions 412115 from http://svn.asterisk.org/svn/asterisk/branches/11 ........ Merged revisions 412153 from http://svn.asterisk.org/svn/asterisk/branches/12 git-svn-id: http://svn.asterisk.org/svn/asterisk/trunk@412154 f38db490-d61c-443f-a65b-d21fe96a405b
- Loading branch information
1 parent
25be99d
commit 95222bf
Showing
10 changed files
with
288 additions
and
421 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,171 @@ | ||
#!/usr/bin/env python | ||
"""Process a ref debug log | ||
This file will process a log file created by the REF_DEBUG | ||
build option in Asterisk. | ||
See http://www.asterisk.org for more information about | ||
the Asterisk project. Please do not directly contact | ||
any of the maintainers of this project for assistance; | ||
the project provides a web site, mailing lists and IRC | ||
channels for your use. | ||
This program is free software, distributed under the terms of | ||
the GNU General Public License Version 2. See the LICENSE file | ||
at the top of the source tree. | ||
Copyright (C) 2014, Digium, Inc. | ||
Matt Jordan <[email protected]> | ||
""" | ||
|
||
import sys | ||
import os | ||
|
||
from optparse import OptionParser | ||
|
||
def parse_line(line): | ||
"""Parse out a line into its constituent parts. | ||
Keyword Arguments: | ||
line The line from a ref debug log to parse out | ||
Returns: | ||
A dictionary containing the options, or None | ||
""" | ||
tokens = line.strip().split(',', 7) | ||
if len(tokens) < 8: | ||
print "ERROR: ref debug line '%s' contains fewer tokens than " \ | ||
"expected: %d" % (line.strip(), len(tokens)) | ||
return None | ||
|
||
processed_line = {'addr': tokens[0], | ||
'delta': tokens[1], | ||
'thread_id': tokens[2], | ||
'file': tokens[3], | ||
'line': tokens[4], | ||
'function': tokens[5], | ||
'state': tokens[6], | ||
'tag': tokens[7], | ||
} | ||
return processed_line | ||
|
||
|
||
def process_file(filename): | ||
"""The routine that kicks off processing a ref file | ||
Keyword Arguments: | ||
filename The full path to the file to process | ||
Returns: | ||
A tuple containing: | ||
- A list of objects whose lifetimes were completed | ||
- A list of objects whose lifetimes were not completed | ||
- A list of objects whose lifetimes are skewed | ||
""" | ||
|
||
finished_objects = [] | ||
leaked_objects = [] | ||
skewed_objects = [] | ||
current_objects = {} | ||
|
||
with open(filename, 'r') as ref_file: | ||
for line in ref_file: | ||
parsed_line = parse_line(line) | ||
if not parsed_line: | ||
continue | ||
|
||
obj = parsed_line['addr'] | ||
|
||
if obj not in current_objects: | ||
current_objects[obj] = [] | ||
if 'constructor' not in parsed_line['state']: | ||
skewed_objects.append(current_objects[obj]) | ||
current_objects[obj].append(parsed_line) | ||
|
||
if 'destructor' in parsed_line['state']: | ||
lifetime = current_objects.get(obj) | ||
finished_objects.append(lifetime) | ||
del current_objects[obj] | ||
|
||
leaked_objects = current_objects.values() | ||
return (finished_objects, leaked_objects, skewed_objects) | ||
|
||
|
||
def print_objects(objects, prefix=""): | ||
"""Prints out the objects that were processed | ||
Keyword Arguments: | ||
objects A list of objects to print | ||
prefix A prefix to print that specifies something about | ||
this object | ||
""" | ||
|
||
print "======== %s Objects ========" % prefix | ||
print "\n" | ||
for obj in objects: | ||
print "==== %s Object %s history ====" % (prefix, obj[0]['addr']) | ||
for entry in obj: | ||
print "[%s] %s:%s %s: %s %s - [%s]" % (entry['thread_id'], | ||
entry['file'], entry['line'], | ||
entry['function'], | ||
entry['delta'], entry['tag'], | ||
entry['state']) | ||
print "\n" | ||
|
||
|
||
def main(argv=None): | ||
"""Main entry point for the script""" | ||
|
||
ret_code = 0 | ||
|
||
if argv is None: | ||
argv = sys.argv | ||
|
||
parser = OptionParser() | ||
|
||
parser.add_option("-f", "--file", action="store", type="string", | ||
dest="filepath", default="/var/log/asterisk/refs", | ||
help="The full path to the refs file to process") | ||
parser.add_option("-l", "--suppress-leaks", action="store_false", | ||
dest="leaks", default=True, | ||
help="If specified, don't output leaked objects") | ||
parser.add_option("-n", "--suppress-normal", action="store_false", | ||
dest="normal", default=True, | ||
help="If specified, don't output objects with a " \ | ||
"complete lifetime") | ||
parser.add_option("-s", "--suppress-skewed", action="store_false", | ||
dest="skewed", default=True, | ||
help="If specified, don't output objects with a " \ | ||
"skewed lifetime") | ||
|
||
(options, args) = parser.parse_args(argv) | ||
|
||
if not os.path.isfile(options.filepath): | ||
print >>sys.stderr, "File not found: %s" % options.filepath | ||
return -1 | ||
|
||
try: | ||
(finished_objects, | ||
leaked_objects, | ||
skewed_objects) = process_file(options.filepath) | ||
|
||
if options.leaks and len(leaked_objects): | ||
print_objects(leaked_objects, "Leaked") | ||
ret_code |= 1 | ||
|
||
if options.skewed and len(skewed_objects): | ||
print_objects(skewed_objects, "Skewed") | ||
ret_code |= 2 | ||
|
||
if options.normal: | ||
print_objects(finished_objects, "Finalized") | ||
|
||
except (KeyboardInterrupt, SystemExit, IOError): | ||
print >>sys.stderr, "File processing cancelled" | ||
return -1 | ||
|
||
return ret_code | ||
|
||
|
||
if __name__ == "__main__": | ||
sys.exit(main(sys.argv)) |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.