Filing useful bug reports - Traffic Server - Apache Software Foundation

<!DOCTYPE html> <html lang="en-GB" > <head> <title>Filing useful bug reports - Traffic Server - Apache Software Foundation</title> <meta http-equiv="X-UA-Compatible" content="IE=EDGE,chrome=IE7"> <meta charset="UTF-8"> <meta id="confluence-context-path" name="confluence-context-path" content="/confluence"> <meta id="confluence-base-url" name="confluence-base-url" content="https://cwiki.apache.org/confluence"> <meta id="atlassian-token" name="atlassian-token" content="a46d4273997043fe131d661e6c66759c29f768e8"> <meta id="confluence-space-key" name="confluence-space-key" content="TS"> <script type="text/javascript"> var contextPath = '/confluence'; </script> <meta name="confluence-request-time" content="1739785753980"> <meta name="ajs-use-keyboard-shortcuts" content="true"> <meta name="ajs-com.comalatech.checklists-stats-friendApps" content="sr-rep" /><meta name="ajs-com.comalatech.checklists-stats-comalatechToken" content="pWETbB+4f8H2i/XPRvCgv0F5bnCn3SBaMkEZnn063ojGjC8VVNQsam7XD2fUfTvcL6OapIZqxbZWLzPgt8mXb/FSsXdHfzbwq3w70bfv4bt4R4eRkDNJM0vAjxfZUAZjcxkwAti+S7GKpBuTEAgdSFsT20RVP4dlU/PKM1AHDil7Qr+HlGO8HQQ+s8KrlkEY94BCzHVI2pn+XK7i97z6nCyjtNdsai68xuOwDGbVxJLAZ/g0qV1dNpiJRr12jPAT6shvQOFq9Pqn5bZm/cexzSQ/zaCB3+czALAmMCSJGGjQKr1en8P4ckTs9zki5FiMVpVWDoDH5isKaZJysbpT0w==" /><meta name="ajs-com.comalatech.checklists-stats-pluginLicenseType" content="PAID" /><meta name="ajs-com.comalatech.checklists-stats-licenseType" content="OPEN_SOURCE" /><meta name="ajs-com.comalatech.checklists-stats-checklistExcerptMacroTotal" content="0" /><meta name="ajs-com.comalatech.checklists-stats-timestamp" content="1739757600034" /><meta name="ajs-com.comalatech.checklists-stats-checklistAttributeMacroTotal" content="0" /><meta name="ajs-com.comalatech.checklists-dev-mode" content="false" /><meta name="ajs-com.comalatech.checklists-trace" content="false" /><meta name="ajs-com.comalatech.checklists-stats-checklistLogMacroTotal" content="0" /><meta name="ajs-com.comalatech.checklists-stats-checklistWikiinputMacroTotal" content="0" /><meta name="ajs-com.comalatech.checklists-stats-checklistLabelMacroTotal" content="0" /><meta name="ajs-com.comalatech.checklists-stats-licenseSize" content="10000" /><meta name="ajs-com.comalatech.checklists-stats-checklistWikiMacroTotal" content="0" /><meta name="ajs-com.comalatech.checklists-stats-instanceId" content="782e50b8e4252e986d61834beb7b94ab" /><meta name="ajs-com.comalatech.checklists-stats-checklistMetadataMacroTotal" content="0" /><meta name="ajs-com.comalatech.checklists-stats-checklistPagelinkMacroTotal" content="0" /><meta name="ajs-com.comalatech.checklists-stats-checklistSelectMacroTotal" content="0" /><meta name="ajs-com.comalatech.checklists-stats-checklistMacroTotal" content="1" /><meta name="ajs-com.comalatech.checklists-stats-totalSpaces" content="444" /><meta name="ajs-com.comalatech.checklists-stats-app" content="chks" /><meta name="ajs-com.comalatech.checklists-stats-checklistInputMacroTotal" content="0" /><meta name="ajs-com.comalatech.checklists-stats-checklistIncludeMacroTotal" content="0" /><meta name="ajs-com.comalatech.checklists-stats-hostVersion" content="7.19.30" /><meta name="ajs-com.comalatech.checklists-stats-totalVersions" content="1027505" /><meta name="ajs-com.comalatech.checklists-stats-totalPages" content="253155" /><meta name="ajs-com.comalatech.checklists-stats-version" content="2.6.13" /><meta name="ajs-com.comalatech.checklists-stats-pluginLicenseSize" content="0" /> <meta name="ajs-is-confluence-admin" content="false"> <meta name="ajs-connection-timeout" content="10000"> <script type="text/x-template" title="gliffy-webpanel-footer"> <div class="gliffy-webpanel-footer"><span>This Confluence installation runs a Free Gliffy License - Evaluate the <a href="http://www.gliffy.com/products/confluence-plugin/">Gliffy Confluence Plugin</a> for your Wiki!</span></div> </script> <style>.ia-fixed-sidebar, .ia-splitter-left {width: 285px;}.theme-default .ia-splitter #main {margin-left: 285px;}.ia-fixed-sidebar {visibility: hidden;}</style> <meta name="ajs-discovered-plugin-features" content="$discoveredList"> <meta name="ajs-keyboardshortcut-hash" content="95e6cf78361ee8015b99709ad8a920de"> <meta name="ajs-page-title" content="Filing useful bug reports"> <meta name="ajs-latest-published-page-title" content="Filing useful bug reports"> <meta name="ajs-space-name" content="Traffic Server"> <meta name="ajs-page-id" content="26805171"> <meta name="ajs-latest-page-id" content="26805171"> <meta name="ajs-content-type" content="page"> <meta name="ajs-parent-page-title" content="Contributing"> <meta name="ajs-parent-page-id" content="62686935"> <meta name="ajs-space-key" content="TS"> <meta name="ajs-max-number-editors" content="12"> <meta name="ajs-macro-placeholder-timeout" content="5000"> <meta name="ajs-jira-metadata-count" content="-1"> <meta name="ajs-from-page-title" content=""> <meta name="ajs-can-remove-page" content="false"> <meta name="ajs-can-remove-page-hierarchy" content="false"> <meta name="ajs-browse-page-tree-mode" content="view"> <meta name="ajs-shared-drafts" content="true"> <meta name="ajs-context-path" content="/confluence"> <meta name="ajs-base-url" content="https://cwiki.apache.org/confluence"> <meta name="ajs-version-number" content="7.19.30"> <meta name="ajs-build-number" content="8804"> <meta name="ajs-remote-user" content=""> <meta name="ajs-remote-user-key" content=""> <meta name="ajs-remote-user-has-licensed-access" content="false"> <meta name="ajs-remote-user-has-browse-users-permission" content="false"> <meta name="ajs-current-user-fullname" content=""> <meta name="ajs-current-user-avatar-url" content=""> <meta name="ajs-current-user-avatar-uri-reference" content="/confluence/images/icons/profilepics/anonymous.svg"> <meta name="ajs-static-resource-url-prefix" content="/confluence/s/5tj15x/8804/z1btw/_"> <meta name="ajs-global-settings-attachment-max-size" content="20971520"> <meta name="ajs-global-settings-quick-search-enabled" content="true"> <meta name="ajs-user-locale" content="en_GB"> <meta name="ajs-user-timezone-offset" content="0"> <meta name="ajs-enabled-dark-features" content="site-wide.shared-drafts,site-wide.synchrony,migration-assistant.enable.assess-l1-cloud-tooling.feature,clc.quick.create,confluence.view.edit.transition,cql.search.screen,confluence-inline-comments-resolved,frontend.editor.v4,http.session.registrar,nps.survey.inline.dialog,confluence.efi.onboarding.new.templates,frontend.editor.v4.compatibility,atlassian.cdn.static.assets,pdf-preview,previews.sharing,previews.versions,file-annotations,confluence.efi.onboarding.rich.space.content,collaborative-audit-log,confluence.reindex.improvements,previews.conversion-service,editor.ajax.save,read.only.mode,graphql,previews.trigger-all-file-types,attachment.extracted.text.extractor,lucene.caching.filter,confluence.table.resizable,notification.batch,previews.sharing.pushstate,confluence-inline-comments-rich-editor,tc.tacca.dacca,site-wide.synchrony.opt-in,atlassian.webresource.twophase.js.i18n.disabled,confluence.denormalisedpermissions,file-annotations.likes,gatekeeper-ui-v2,v2.content.name.searcher,mobile.supported.version,confluence.editor.tinymce.tables,pulp,confluence-inline-comments,confluence-inline-comments-dangling-comment,quick-reload-inline-comments-flags,confluence.retention.rules"> <meta name="ajs-atl-token" content="a46d4273997043fe131d661e6c66759c29f768e8"> <meta name="ajs-confluence-flavour" content="VANILLA"> <meta name="ajs-user-date-pattern" content="dd MMM yyyy"> <meta name="ajs-access-mode" content="READ_WRITE"> <meta name="ajs-render-mode" content="READ_WRITE"> <meta name="ajs-date.format" content="MMM dd, yyyy"> <link rel="shortcut icon" href="/confluence/s/5tj15x/8804/z1btw/1/_/favicon.ico"> <link rel="icon" type="image/x-icon" href="/confluence/s/5tj15x/8804/z1btw/1/_/favicon.ico"> <link rel="search" type="application/opensearchdescription+xml" href="/confluence/opensearch/osd.action" title="Apache Software Foundation"/> <meta name="ajs-create-issue-metadata-show-discovery" content="false"> <script> window.WRM=window.WRM||{};window.WRM._unparsedData=window.WRM._unparsedData||{};window.WRM._unparsedErrors=window.WRM._unparsedErrors||{}; WRM._unparsedData["com.atlassian.applinks.applinks-plugin:applinks-common-exported.entity-types"]="{\u0022singular\u0022:{\u0022refapp.charlie\u0022:\u0022Charlie\u0022,\u0022fecru.project\u0022:\u0022Crucible Project\u0022,\u0022fecru.repository\u0022:\u0022FishEye Repository\u0022,\u0022stash.project\u0022:\u0022Stash Project\u0022,\u0022generic.entity\u0022:\u0022Generic Project\u0022,\u0022confluence.space\u0022:\u0022Confluence Space\u0022,\u0022bamboo.project\u0022:\u0022Bamboo Project\u0022,\u0022jira.project\u0022:\u0022Jira Project\u0022},\u0022plural\u0022:{\u0022refapp.charlie\u0022:\u0022Charlies\u0022,\u0022fecru.project\u0022:\u0022Crucible Projects\u0022,\u0022fecru.repository\u0022:\u0022FishEye Repositories\u0022,\u0022stash.project\u0022:\u0022Stash Projects\u0022,\u0022generic.entity\u0022:\u0022Generic Projects\u0022,\u0022confluence.space\u0022:\u0022Confluence Spaces\u0022,\u0022bamboo.project\u0022:\u0022Bamboo Projects\u0022,\u0022jira.project\u0022:\u0022Jira Projects\u0022}}"; WRM._unparsedData["com.atlassian.analytics.analytics-client:programmatic-analytics-init.programmatic-analytics-data-provider"]="false"; WRM._unparsedData["com.atlassian.confluence.plugins.confluence-license-banner:confluence-license-banner-resources.license-details"]="{\u0022daysBeforeLicenseExpiry\u0022:0,\u0022daysBeforeMaintenanceExpiry\u0022:0,\u0022showLicenseExpiryBanner\u0022:false,\u0022showMaintenanceExpiryBanner\u0022:false,\u0022renewUrl\u0022:null,\u0022salesUrl\u0022:null}"; WRM._unparsedData["com.atlassian.plugins.atlassian-plugins-webresource-plugin:context-path.context-path"]="\u0022/confluence\u0022"; WRM._unparsedData["com.atlassian.analytics.analytics-client:policy-update-init.policy-update-data-provider"]="false"; WRM._unparsedData["com.atlassian.applinks.applinks-plugin:applinks-common-exported.authentication-types"]="{\u0022com.atlassian.applinks.api.auth.types.BasicAuthenticationProvider\u0022:\u0022Basic Access\u0022,\u0022com.atlassian.applinks.api.auth.types.TrustedAppsAuthenticationProvider\u0022:\u0022Trusted Applications\u0022,\u0022com.atlassian.applinks.api.auth.types.CorsAuthenticationProvider\u0022:\u0022CORS\u0022,\u0022com.atlassian.applinks.api.auth.types.OAuthAuthenticationProvider\u0022:\u0022OAuth\u0022,\u0022com.atlassian.applinks.api.auth.types.TwoLeggedOAuthAuthenticationProvider\u0022:\u0022OAuth\u0022,\u0022com.atlassian.applinks.api.auth.types.TwoLeggedOAuthWithImpersonationAuthenticationProvider\u0022:\u0022OAuth\u0022}"; WRM._unparsedData["com.atlassian.confluence.plugins.confluence-search-ui-plugin:confluence-search-ui-plugin-resources.i18n-data"]="{\u0022search.ui.recent.link.text\u0022:\u0022View more recently visited\u0022,\u0022search.ui.search.results.empty\u0022:\u0022We couldn\u0027\u0027t find anything matching \u005C\u0022{0}\u005C\u0022.\u0022,\u0022search.ui.filter.clear.selected\u0022:\u0022Clear selected items\u0022,\u0022search.ui.content.name.search.items.panel.load.all.top.items.button.text\u0022:\u0022Show more app results...\u0022,\u0022search.ui.filter.contributor.button.text\u0022:\u0022Contributor\u0022,\u0022search.ui.filter.space.current.label\u0022:\u0022CURRENT\u0022,\u0022search.ui.clear.input.button.text\u0022:\u0022Clear text\u0022,\u0022search.ui.search.results.clear.button\u0022:\u0022clear your filters.\u0022,\u0022help.search.ui.link.title\u0022:\u0022Search tips\u0022,\u0022search.ui.container.close.text\u0022:\u0022Close\u0022,\u0022search.ui.filter.date.month.text\u0022:\u0022The past month\u0022,\u0022search.ui.infinite.scroll.button.text\u0022:\u0022More results\u0022,\u0022search.ui.filter.date.button.text\u0022:\u0022Date\u0022,\u0022search.ui.filter.date.week.text\u0022:\u0022The past week\u0022,\u0022search.ui.result.subtitle.calendar\u0022:\u0022Team calendar\u0022,\u0022search.ui.filter.date.heading\u0022:\u0022Last modified within\u0022,\u0022search.ui.filter.space.input.label\u0022:\u0022Find spaces...\u0022,\u0022search.ui.generic.error\u0022:\u0022Something went wrong. Refresh the page, or contact your admin if this keeps happening.\u0022,\u0022search.ui.recent.spaces\u0022:\u0022Recent Spaces\u0022,\u0022search.ui.result.subtitle.space\u0022:\u0022Space\u0022,\u0022search.ui.filter.space.category.input.label\u0022:\u0022Find space categories...\u0022,\u0022search.ui.filter.space.archive.label\u0022:\u0022Search archived spaces\u0022,\u0022search.ui.filter.label\u0022:\u0022filter\u0022,\u0022search.ui.filter.date.all.text\u0022:\u0022Any time\u0022,\u0022search.ui.filter.date.hour.text\u0022:\u0022The past day\u0022,\u0022search.ui.filters.heading\u0022:\u0022Filter by\u0022,\u0022search.ui.filter.label.input.label\u0022:\u0022Find labels...\u0022,\u0022search.ui.recent.items.anonymous\u0022:\u0022Start exploring. Your search results will appear here.\u0022,\u0022search.ui.input.label\u0022:\u0022Search\u0022,\u0022search.ui.input.aria.label\u0022:\u0022Search, when you type, your results will be displayed below.\u0022,\u0022search.ui.search.result\u0022:\u0022{0,choice,1#{0} search result|1\u003c{0} search results}\u0022,\u0022search.ui.filter.label.button.text\u0022:\u0022Label\u0022,\u0022search.ui.container.clear.ariaLabel\u0022:\u0022Clear\u0022,\u0022search.ui.input.alert\u0022:\u0022Hit enter to search\u0022,\u0022search.ui.filter.no.result.text\u0022:\u0022We can\u0027\u0027t find anything matching your search\u0022,\u0022search.ui.result.subtitle.user\u0022:\u0022User profile\u0022,\u0022search.ui.filter.contributor.input.label\u0022:\u0022Find people...\u0022,\u0022search.ui.filter.content.type.button.text\u0022:\u0022Type\u0022,\u0022search.ui.filter.date.year.text\u0022:\u0022The past year\u0022,\u0022search.ui.advanced.search.link.text\u0022:\u0022Advanced search\u0022,\u0022search.ui.filter.space.button.text\u0022:\u0022Space\u0022,\u0022search.ui.search.results.clear.line2\u0022:\u0022Try a different search term or\u0022,\u0022search.ui.filter.space.category.button.text\u0022:\u0022Space category\u0022,\u0022search.ui.search.results.clear.line1\u0022:\u0022We couldn\u0027\u0027t find anything matching your search.\u0022,\u0022search.ui.content.name.search.items.panel.load.all.top.items.admin.button.text\u0022:\u0022Show more settings and app results...\u0022,\u0022search.ui.recent.pages\u0022:\u0022Recently visited\u0022,\u0022search.ui.search.result.anonymous\u0022:\u0022{0,choice,1#{0} search result|1\u003c{0} search results}. Have an account? {1}Log in{2} to expand your search.\u0022,\u0022search.ui.recent.items.empty\u0022:\u0022Start exploring. Pages and spaces you\u0027\u0027ve visited recently will appear here.\u0022,\u0022search.ui.filter.space.init.heading\u0022:\u0022recent spaces\u0022}"; WRM._unparsedData["com.atlassian.applinks.applinks-plugin:applinks-common-exported.applinks-types"]="{\u0022crowd\u0022:\u0022Crowd\u0022,\u0022confluence\u0022:\u0022Confluence\u0022,\u0022fecru\u0022:\u0022FishEye / Crucible\u0022,\u0022stash\u0022:\u0022Stash\u0022,\u0022jira\u0022:\u0022Jira\u0022,\u0022refapp\u0022:\u0022Reference Application\u0022,\u0022bamboo\u0022:\u0022Bamboo\u0022,\u0022generic\u0022:\u0022Generic Application\u0022}"; WRM._unparsedData["com.atlassian.confluence.plugins.synchrony-interop:synchrony-status-banner-loader.synchrony-status"]="false"; WRM._unparsedData["com.atlassian.applinks.applinks-plugin:applinks-common-exported.applinks-help-paths"]="{\u0022entries\u0022:{\u0022applinks.docs.root\u0022:\u0022https://confluence.atlassian.com/display/APPLINKS-082/\u0022,\u0022applinks.docs.diagnostics.troubleshoot.sslunmatched\u0022:\u0022SSL+and+application+link+troubleshooting+guide\u0022,\u0022applinks.docs.diagnostics.troubleshoot.oauthsignatureinvalid\u0022:\u0022OAuth+troubleshooting+guide\u0022,\u0022applinks.docs.diagnostics.troubleshoot.oauthtimestamprefused\u0022:\u0022OAuth+troubleshooting+guide\u0022,\u0022applinks.docs.delete.entity.link\u0022:\u0022Create+links+between+projects\u0022,\u0022applinks.docs.adding.application.link\u0022:\u0022Link+Atlassian+applications+to+work+together\u0022,\u0022applinks.docs.administration.guide\u0022:\u0022Application+Links+Documentation\u0022,\u0022applinks.docs.oauth.security\u0022:\u0022OAuth+security+for+application+links\u0022,\u0022applinks.docs.troubleshoot.application.links\u0022:\u0022Troubleshoot+application+links\u0022,\u0022applinks.docs.diagnostics.troubleshoot.unknownerror\u0022:\u0022Network+and+connectivity+troubleshooting+guide\u0022,\u0022applinks.docs.configuring.auth.trusted.apps\u0022:\u0022Configuring+Trusted+Applications+authentication+for+an+application+link\u0022,\u0022applinks.docs.diagnostics.troubleshoot.authlevelunsupported\u0022:\u0022OAuth+troubleshooting+guide\u0022,\u0022applinks.docs.diagnostics.troubleshoot.ssluntrusted\u0022:\u0022SSL+and+application+link+troubleshooting+guide\u0022,\u0022applinks.docs.diagnostics.troubleshoot.unknownhost\u0022:\u0022Network+and+connectivity+troubleshooting+guide\u0022,\u0022applinks.docs.delete.application.link\u0022:\u0022Link+Atlassian+applications+to+work+together\u0022,\u0022applinks.docs.adding.project.link\u0022:\u0022Configuring+Project+links+across+Applications\u0022,\u0022applinks.docs.link.applications\u0022:\u0022Link+Atlassian+applications+to+work+together\u0022,\u0022applinks.docs.diagnostics.troubleshoot.oauthproblem\u0022:\u0022OAuth+troubleshooting+guide\u0022,\u0022applinks.docs.diagnostics.troubleshoot.migration\u0022:\u0022Update+application+links+to+use+OAuth\u0022,\u0022applinks.docs.relocate.application.link\u0022:\u0022Link+Atlassian+applications+to+work+together\u0022,\u0022applinks.docs.administering.entity.links\u0022:\u0022Create+links+between+projects\u0022,\u0022applinks.docs.upgrade.application.link\u0022:\u0022OAuth+security+for+application+links\u0022,\u0022applinks.docs.diagnostics.troubleshoot.connectionrefused\u0022:\u0022Network+and+connectivity+troubleshooting+guide\u0022,\u0022applinks.docs.configuring.auth.oauth\u0022:\u0022OAuth+security+for+application+links\u0022,\u0022applinks.docs.insufficient.remote.permission\u0022:\u0022OAuth+security+for+application+links\u0022,\u0022applinks.docs.configuring.application.link.auth\u0022:\u0022OAuth+security+for+application+links\u0022,\u0022applinks.docs.diagnostics\u0022:\u0022Application+links+diagnostics\u0022,\u0022applinks.docs.configured.authentication.types\u0022:\u0022OAuth+security+for+application+links\u0022,\u0022applinks.docs.adding.entity.link\u0022:\u0022Create+links+between+projects\u0022,\u0022applinks.docs.diagnostics.troubleshoot.unexpectedresponse\u0022:\u0022Network+and+connectivity+troubleshooting+guide\u0022,\u0022applinks.docs.configuring.auth.basic\u0022:\u0022Configuring+Basic+HTTP+Authentication+for+an+Application+Link\u0022,\u0022applinks.docs.diagnostics.troubleshoot.authlevelmismatch\u0022:\u0022OAuth+troubleshooting+guide\u0022}}"; WRM._unparsedData["com.atlassian.confluence.plugins.confluence-feature-discovery-plugin:confluence-feature-discovery-plugin-resources.test-mode"]="false"; if(window.WRM._dataArrived)window.WRM._dataArrived();</script> <link rel="stylesheet" href="/confluence/s/d6471d1c50e67be40ce86e07bf67754d-CDN/5tj15x/8804/z1btw/55eed36097aa36aaf1d3b4f127b4978b/_/download/contextbatch/css/_super,-com.atlassian.plugins.atlassian-plugins-webresource-rest:data-collector-perf-observer/batch.css" data-wrm-key="_super,-com.atlassian.plugins.atlassian-plugins-webresource-rest:data-collector-perf-observer" data-wrm-batch-type="context" media="all"> <link rel="stylesheet" href="/confluence/s/a8c44b1457eedf95e76973a891028674-CDN/5tj15x/8804/z1btw/ef0531fbb164e3e31f12ab8e86a16528/_/download/contextbatch/css/atl.confluence.plugins.pagetree-desktop,main,viewcontent,atl.general,page,atl.comments,-_super/batch.css?gatekeeper-ui-v2=true&highlightactions=true&hostenabled=true" data-wrm-key="atl.confluence.plugins.pagetree-desktop,main,viewcontent,atl.general,page,atl.comments,-_super" data-wrm-batch-type="context" media="all"> <link rel="stylesheet" href="/confluence/s/d41d8cd98f00b204e9800998ecf8427e-CDN/5tj15x/8804/z1btw/3.9.4/_/download/batch/com.stiltsoft.confluence.handy.macros:handy-header-url-resources/com.stiltsoft.confluence.handy.macros:handy-header-url-resources.css" data-wrm-key="com.stiltsoft.confluence.handy.macros:handy-header-url-resources" data-wrm-batch-type="resource" media="all"> <script data-wrm-key="com.atlassian.plugins.atlassian-plugins-webresource-rest:data-collector-perf-observer" data-wrm-batch-type="resource" data-initially-rendered> !function(){"use strict";if("PerformanceObserver"in window){const e=[];window.__observedResources=e;const r=e=>"script"===e?"script":"css";new PerformanceObserver((n=>{n.getEntries().filter((({initiatorType:e,name:r})=>{const n="script"===e||((e,r)=>"link"===e&&"css"===new URL(r).pathname.split(".").pop())(e,r),i=new URL(location.href).origin===new URL(r).origin;return n&&i})).forEach((({name:n,transferSize:i,encodedBodySize:s,initiatorType:o})=>{e.push([i,s,n,r(o)])}))})).observe({type:"resource"})}}(); </script> <script src="/confluence/s/7fd0279747e215ea352367d8e6f12c35-CDN/5tj15x/8804/z1btw/55eed36097aa36aaf1d3b4f127b4978b/_/download/contextbatch/js/_super,-com.atlassian.plugins.atlassian-plugins-webresource-rest:data-collector-perf-observer/batch.js?locale=en-GB" data-wrm-key="_super,-com.atlassian.plugins.atlassian-plugins-webresource-rest:data-collector-perf-observer" data-wrm-batch-type="context" data-initially-rendered></script> <script src="/confluence/s/be992fddfe9e1b0234d88eedd239a538-CDN/5tj15x/8804/z1btw/ef0531fbb164e3e31f12ab8e86a16528/_/download/contextbatch/js/atl.confluence.plugins.pagetree-desktop,main,viewcontent,atl.general,page,atl.comments,-_super/batch.js?gatekeeper-ui-v2=true&highlightactions=true&hostenabled=true&locale=en-GB" data-wrm-key="atl.confluence.plugins.pagetree-desktop,main,viewcontent,atl.general,page,atl.comments,-_super" data-wrm-batch-type="context" data-initially-rendered></script> <script src="/confluence/s/65541f100b4b68367ffbcd5d5c4afdb1-CDN/5tj15x/8804/z1btw/3.9.4/_/download/batch/com.stiltsoft.confluence.handy.macros:handy-header-url-resources/com.stiltsoft.confluence.handy.macros:handy-header-url-resources.js?locale=en-GB" data-wrm-key="com.stiltsoft.confluence.handy.macros:handy-header-url-resources" data-wrm-batch-type="resource" data-initially-rendered></script> <script src="/confluence/s/d41d8cd98f00b204e9800998ecf8427e-T/5tj15x/8804/z1btw/2.6.13/_/download/batch/com.comalatech.checklists:analyticsResources/com.comalatech.checklists:analyticsResources.js" data-wrm-key="com.comalatech.checklists:analyticsResources" data-wrm-batch-type="resource" data-initially-rendered></script> <script type="module">WRM.requireLazily(["wr!com.atlassian.plugins.atlassian-plugins-webresource-rest:data-collector-async"])</script> <meta name="ajs-site-title" content="Apache Software Foundation" /> <link rel="canonical" href="https://cwiki.apache.org/confluence/display/TS/Filing+useful+bug+reports"> <link rel="shortlink" href="https://cwiki.apache.org/confluence/x/swOZAQ"> <meta name="wikilink" content="[TS:Filing useful bug reports]"> <meta name="page-version" content="15"> <meta name="ajs-page-version" content="15"> </head> <body id="com-atlassian-confluence" class="theme-default aui-layout aui-theme-default"> <div id='stp-licenseStatus-banner'></div> <div id="page"> <div id="full-height-container"> <div id="header-precursor"> <div class="cell"> </div> </div> <header id="header" role="banner"> <a class="aui-skip-link" href="https://cwiki.apache.org/confluence/login.action?os_destination=%2Fdisplay%2FTS%2FFiling%2Buseful%2Bbug%2Breports">Log in</a> <a class="aui-skip-link" href="#nav-sidebar">Skip to sidebar</a> <a class="aui-skip-link" href="#main">Skip to main content</a> <nav class="aui-header aui-dropdown2-trigger-group" aria-label="Site"><div class="aui-header-inner"><div class="aui-header-before"><button class=" aui-dropdown2-trigger app-switcher-trigger aui-dropdown2-trigger-arrowless" aria-controls="app-switcher" aria-haspopup="true" role="button" data-aui-trigger href="#app-switcher"><span class="aui-icon aui-icon-small aui-iconfont-appswitcher">Linked Applications</span></button><div id="app-switcher" class="aui-dropdown2 aui-style-default" role="menu" hidden data-is-user-admin="false" data-is-switcher="true"><div class="app-switcher-loading">Loading…</div></div></div><div class="aui-header-primary"><span id="logo" class="aui-header-logo aui-header-logo-confluence"><a href="/confluence/" aria-label="Go to home page"><span class="aui-header-logo-device">Apache Software Foundation</span></a></span><ul class="aui-nav"> <li> <a id="space-directory-link" href="/confluence/spacedirectory/view.action" class=" aui-nav-imagelink" title="Spaces"> <span>Spaces</span> </a> </li> <li class="aui-buttons"> </li> </ul> </div><div class="aui-header-secondary"><ul class="aui-nav"> <li> <div id="search-ui" class="aui-quicksearch dont-default-focus header-quicksearch"><button id="quick-search-query-button" aria-label="Search" aria-haspopup= "dialog" aria-controls="search_drawer" ></button><input id="quick-search-query" aria-label="Search" placeholder="Search" type="text" aria-haspopup= "dialog" aria-controls="search_drawer" /><div id="quick-search-alert" role="alert">Hit enter to search</div><aui-spinner size="small"></aui-spinner></div> </li> <li> <a id="help-menu-link" class="aui-nav-link aui-dropdown2-trigger aui-dropdown2-trigger-arrowless" href="#" aria-haspopup="true" aria-owns="help-menu-link-content" title="Help"> <span class="aui-icon aui-icon-small aui-iconfont-question-filled">Help</span> </a> <nav id="help-menu-link-content" class="aui-dropdown2 aui-style-default"> <div class="aui-dropdown2-section"> <ul id="help-menu-link-leading" class="aui-list-truncate section-leading first"> <li> <a id="confluence-help-link" href="https://docs.atlassian.com/confluence/docs-719/" class=" " title="Visit the Confluence documentation home" target="_blank" > Online Help </a> </li> <li> <a id="keyboard-shortcuts-link" href="/confluence" class=" " title="View available keyboard shortcuts" > Keyboard Shortcuts </a> </li> <li> <a id="feed-builder-link" href="/confluence/dashboard/configurerssfeed.action" class=" " title="Create your custom RSS feed." > Feed Builder </a> </li> <li> <a id="whats-new-menu-link" href="https://docs.atlassian.com/confluence/docs-719/help.whats.new.iframe.link" class=" " title="" > What’s new </a> </li> <li> <a id="whats-new-menu-link" href="https://confluence.atlassian.com/display/DOC/Confluence+7.19+Release+Notes" class=" " title="" > What’s new </a> </li> <li> <a id="gadget-directory-link" href="/confluence" class=" user-item administration-link " title="Browse gadgets provided by Confluence" > Available Gadgets </a> </li> <li> <a id="confluence-about-link" href="/confluence/aboutconfluencepage.action" class=" " title="Get more information about Confluence" > About Confluence </a> </li> </ul> </div> </nav> </li> <li> </li> <li> </li> <li> <li> <a id="login-link" href="/confluence/login.action?os_destination=%2Fdisplay%2FTS%2FFiling%2Buseful%2Bbug%2Breports" class=" user-item login-link " title="" > Log in </a> </li> </li> </ul> </div></div></nav> <br class="clear"> </header> <div class="ia-splitter"> <div class="ia-splitter-left"> <div class="ia-fixed-sidebar" role="complementary" aria-label=sidebar> <div class="acs-side-bar ia-scrollable-section"><div class="acs-side-bar-space-info tipsy-enabled" data-configure-tooltip="Edit space details"><div class="avatar"><div class="space-logo" data-key="TS" data-name="Traffic Server" data-entity-type="confluence.space"><div class="avatar-img-container"><div class="avatar-img-wrapper"><a href="/confluence/display/TS/Apache+Traffic+Server" title="Traffic Server"><img class="avatar-img" src="/confluence/download/attachments/4588508/TS?version=6&modificationDate=1387402830000&api=v2" alt="Traffic Server"></a></div></div></div></div><div class="space-information-container"><div class="name"><a href="/confluence/display/TS/Apache+Traffic+Server" title="Traffic Server">Traffic Server</a></div><div class="flyout-handle icon aui-icon aui-icon-small aui-iconfont-edit"></div></div></div><div class="acs-side-bar-content"><div class="acs-nav-wrapper"><div class="acs-nav" data-has-create-permission="false" data-quick-links-state="null" data-page-tree-state="null" data-nav-type="page-tree"><div class="acs-nav-sections"><div class="main-links-section "><ul class="acs-nav-list"><li class="acs-nav-item wiki current-item" aria-current="true" data-collector-key="spacebar-pages"><a class="acs-nav-item-link tipsy-enabled" href="/confluence/collector/pages.action?key=TS" data-collapsed-tooltip="Pages"><span class="icon"></span><span class="acs-nav-item-label">Pages</span></a></li><li class="acs-nav-item blog" data-collector-key="spacebar-blogs"><a class="acs-nav-item-link tipsy-enabled" href="/confluence/pages/viewrecentblogposts.action?key=TS" data-collapsed-tooltip="Blog"><span class="icon"></span><span class="acs-nav-item-label">Blog</span></a></li></ul></div><div class="quick-links-wrapper"><h2 class="ia-quick-links-header-title">Space shortcuts</h2><div class="quick-links-section tipsy-enabled "><ul class="acs-nav-list"><li class="acs-nav-item pinned_page blueprint kb-how-to-article"><a class="acs-nav-item-link tipsy-enabled" href="/confluence/display/TS/How-to+articles" data-collapsed-tooltip="null"><span class="icon"></span><span class="acs-nav-item-label">How-to articles</span></a></li></ul></div></div></div></div></div><div class="ia-secondary-container tipsy-enabled" data-tree-type="page-tree"><div class="ia-secondary-header"><h2 class="ia-secondary-header-title page-tree"><span class="icon"></span><span class="label">Page tree</span></h2></div><div class="ia-secondary-content"> <div class="plugin_pagetree conf-macro output-inline" data-hasbody="false" data-macro-name="pagetree"> <div class="plugin_pagetree_children_list plugin_pagetree_children_list_noleftspace"> <div class="plugin_pagetree_children"> </div> </div> <fieldset class="hidden"> <input type="hidden" name="treeId" value="" /> <input type="hidden" name="treeRequestId" value="/confluence/plugins/pagetree/naturalchildren.action?decorator=none&excerpt=false&sort=position&reverse=false&disableLinks=false&expandCurrent=true&placement=sidebar" /> <input type="hidden" name="treePageId" value="26805171" /> <input type="hidden" name="noRoot" value="false" /> <input type="hidden" name="rootPageId" value="4588509" /> <input type="hidden" name="rootPage" value="" /> <input type="hidden" name="startDepth" value="0" /> <input type="hidden" name="spaceKey" value="TS" /> <input type="hidden" name="i18n-pagetree.loading" value="Loading..." /> <input type="hidden" name="i18n-pagetree.error.permission" value="Unable to load page tree. It seems that you do not have permission to view the root page." /> <input type="hidden" name="i18n-pagetree.eeror.general" value="There was a problem retrieving the page tree. Please check the server log file for more information." /> <input type="hidden" name="loginUrl" value="/confluence/login.action?os_destination=%2Fpages%2Fviewpage.action%3FspaceKey%3DTS%26title%3DFiling%2Buseful%2Bbug%2Breports&permissionViolation=true" /> <input type="hidden" name="mobile" value="false" /> <input type="hidden" name="placement" value="sidebar" /> <fieldset class="hidden"> <input type="hidden" name="ancestorId" value="62686935" /> <input type="hidden" name="ancestorId" value="4588509" /> </fieldset> </fieldset> </div> </div></div></div><div class="hidden"><a href="/confluence/collector/pages.action?key=TS" id="space-pages-link"></a><script type="text/x-template" title="logo-config-content"><h2>Space Details</h2><div class="personal-space-logo-hint">Your profile picture is used as the logo for your personal space. <a href="/confluence/users/profile/editmyprofilepicture.action" target="_blank">Change your profile picture</a>.</div></script></div></div><div class="space-tools-section"><div id="space-tools-menu-additional-items" class="hidden"><div data-label="Browse pages" data-class="" data-href="/confluence/pages/reorderpages.action?key=TS">Browse pages</div></div><button id="space-tools-menu-trigger" class=" aui-dropdown2-trigger aui-button aui-button-subtle tipsy-enabled aui-dropdown2-trigger-arrowless " aria-controls="space-tools-menu" aria-haspopup="true" role="button" data-aui-trigger><span class="aui-icon aui-icon-small aui-iconfont-configure">Configure</span><span class="aui-button-label">Space tools</span><span class="aui-icon "></span></button><div id="space-tools-menu" class="aui-dropdown2 aui-style-default space-tools-dropdown" role="menu" hidden data-aui-alignment="top left"></div><a href="#" role="button" class="expand-collapse-trigger aui-icon aui-icon-small aui-iconfont-chevron-double-left" aria-expanded="true"></a></div> </div> </div>  <main role="main" id="main" class=" aui-page-panel"> <div id="main-header"> <div id="navigation" class="content-navigation view" role="region" aria-label="Page tools"> <ul class="ajs-menu-bar"> <li class="normal ajs-menu-item"> <a id="action-menu-link" class="action aui-dropdown2-trigger-arrowless aui-button aui-button-subtle ajs-menu-title aui-dropdown2-trigger" href="#" aria-haspopup="true" aria-label="More options" aria-owns="action-menu" data-container="#navigation"> <span> <span class="aui-icon aui-icon-small aui-iconfont-more" aria-label="More options"></span> </span> </a> <div id="action-menu" class="aui-dropdown2 aui-style-default" aria-hidden="true"> <div class="aui-dropdown2-section"> <ul id="action-menu-primary" class="section-primary first"> <li> <a id="view-attachments-link" href="/confluence/pages/viewpageattachments.action?pageId=26805171" rel="nofollow" class="action-view-attachments" accessKey="t" title="View Attachments" > <span> A<u>t</u>tachments (0) </span> </a> </li> <li> <a id="action-view-history-link" href="/confluence/pages/viewpreviousversions.action?pageId=26805171" rel="nofollow" class="action-view-history" title="" > <span> Page History </span> </a> </li> </ul> </div> <div class="aui-dropdown2-section"> <ul id="action-menu-secondary" class="section-secondary"> <li> <a id="view-resolved-comments" href="/confluence" rel="nofollow" class="" title="" > <span> Resolved comments </span> </a> </li> <li> <a id="view-page-info-link" href="/confluence/pages/viewinfo.action?pageId=26805171" rel="nofollow" class="action-view-info" title="" > <span> Page Information </span> </a> </li> <li> <a id="view-in-hierarchy-link" href="/confluence/pages/reorderpages.action?key=TS&openId=26805171#selectedPageInHierarchy" rel="nofollow" class="" title="" > <span> View in Hierarchy </span> </a> </li> <li> <a id="action-view-source-link" href="/confluence/plugins/viewsource/viewpagesrc.action?pageId=26805171" rel="nofollow" class="action-view-source popup-link" title="" > <span> View Source </span> </a> </li> <li> <a id="delete-all-comments-link-link" href="/confluence/plugins/aptis/deleteAllComments/ask-user.action?pageId=26805171" rel="nofollow" class="" title="" > <span> Delete comments </span> </a> </li> <li> <a id="action-export-pdf-link" href="/confluence/spaces/flyingpdf/pdfpageexport.action?pageId=26805171" rel="nofollow" class="" title="" > <span> Export to PDF </span> </a> </li> <li> <a id="action-export-word-link" href="/confluence/exportword?pageId=26805171" rel="nofollow" class="action-export-word" title="" > <span> Export to Word </span> </a> </li> </ul> </div> <div class="aui-dropdown2-section"> <ul id="action-menu-modify" class="section-modify"> <li> <a id="treecopy-action" href="/confluence/plugins/tree-copy/preparing-copying.action?pageId=26805171" rel="nofollow" class="" title="" > <span> Copy Page Tree </span> </a> </li> </ul> </div> </div> </li> </ul> </div> <div id="title-heading" class="pagetitle with-breadcrumbs"> <div id="breadcrumb-section"> <nav aria-label="Breadcrumbs"> <ol id="breadcrumbs"> <li class="first" > <span class=""><a href="/confluence/collector/pages.action?key=TS">Pages</a></span> <li> <span class=""><a href="/confluence/display/TS/Apache+Traffic+Server">Apache Traffic Server</a></span> <li> <span class=""><a href="/confluence/display/TS/Contributing">Contributing</a></span> </ol> </nav> </div> <div id="page-metadata-banner"><ul class="banner"><li id="system-content-items" class="noprint"><a href="" title="Unrestricted" id="content-metadata-page-restrictions-hidden" class="hidden"></a></li><li class="page-metadata-item noprinthas-button" id="content-metadata-jira-wrapper"><a href="" title="" id="content-metadata-jira" class="aui-button aui-button-subtle content-metadata-jira tipsy-disabled hidden"><span>Jira links</span></a></li></ul></div> <h1 id="title-text" class="with-breadcrumbs"> <a href="/confluence/display/TS/Filing+useful+bug+reports">Filing useful bug reports</a> </h1> </div> </div> <div id="sidebar-container"> </div> <div id="content" class="page view"> <div id="action-messages"> </div> <script type="text/x-template" title="searchResultsGrid"> <table class="aui"> <thead> <tr class="header"> <th class="search-result-title">Page Title</th> <th class="search-result-space">Space</th> <th class="search-result-date">Updated</th> </tr> </thead> </table> </script> <script type="text/x-template" title="searchResultsGridCount"> <p class="search-result-count">{0}</p> </script> <script type="text/x-template" title="searchResultsGridRow"> <tr class="search-result"> <td class="search-result-title"><a href="{1}" class="content-type-{2}"><span>{0}</span></a></td> <td class="search-result-space"><a class="space" href="/confluence/display/{4}/" title="{3}">{3}</a></td> <td class="search-result-date"><span class="date" title="{6}">{5}</span></td> </tr> </script> <div class="page-metadata"> <ul> <li class="page-metadata-modification-info"> Created by <span class='author'> <a href=" /confluence/display/~zwoop " aria-label="created by Leif Hedstrom" class="url fn" >Leif Hedstrom</a></span>, last modified by <span class='editor'> <a href=" /confluence/display/~shinrich " aria-label="modified by Susan Hinrichs" class="url fn" >Susan Hinrichs</a></span> on <a class='last-modified' aria-label='modified on Nov 17, 2014, select to show changes' title='Show changes' href='/confluence/pages/diffpagesbyversion.action?pageId=26805171&selectedPageVersions=14&selectedPageVersions=15'>Nov 17, 2014</a> </li> </ul> </div> <div id="main-content" class="wiki-content"> <p>This is a page that we hope will help you file useful bug reports. This is always going to be work in progress, please make changes and additions as necessary.</p><p><div class="toc-macro client-side-toc-macro conf-macro output-block" data-hasbody="false" data-headerelements="H1,H2,H3,H4,H5,H6,H7" data-macro-name="toc"> </div></p><h2 id="Filingusefulbugreports-Basicinformation">Basic information</h2><p>Before filing a new bug report, please spend a minute or two to see if there are already a bug filed identical or similar to your problem. You are also highly encouraged to reproduce and test your problem with the latest development release, or even better, a build from SVN trunk. With that said, here are a few bullets on information that each new bug should include:</p><ul><li>Version of Traffic Server used</li><li>Platform (Linux, 64-bit, compilers used etc.)</li><li>Any relevant configuration changes you've made from the default configurations (particularly for records.config).</li><li>If possible, how to reproduce the bug.</li></ul><h2 id="Filingusefulbugreports-Non-crashingproblems">Non-crashing problems</h2><p>For these types of bugs, where Traffic Server isn't behaving as you expect, it's vital that you document the following:</p><ul><li>How to reproduce the behavior, this includes full client headers, server headers (from the origin) etc.</li><li>What the expected result should be.</li><li>What the actual result is from Traffic Server</li></ul><h2 id="Filingusefulbugreports-Crashers">Crashers</h2><p>Crashers are difficult to debug, and some familiarity with the Gnu Debugger (gdb) is required to file any useful bug reports. We'll try to give a brief overview here how to do this, but you are encouraged to do some googling, and find some good on-line introductions to using gdb. The goal with GDB is two folded:</p><ol><li>Get a stack trace from the crash. This is done using the <strong>bt</strong> command in gdb.</li><li>Collect information about parameter and other variables near the crasher. This is done using the <strong>print</strong> command in gdb.</li></ol><h3 id="Filingusefulbugreports-BuildingTrafficServerforoptimaldebugging">Building Traffic Server for optimal debugging</h3><p>The default build, aka a release build, of ATS has debug information, but it's also an optimized build. This makes it more difficult to debug using such a binary, because code gets reorganized, variables and parameters gets optimized out, and so on. For best debugging, you should build Traffic Server in a debug-build mode. For example:</p><div class="code panel pdl conf-macro output-block" data-hasbody="true" data-macro-name="code" style="border-width: 1px;"><div class="codeContent panelContent pdl"> <pre class="syntaxhighlighter-pre" data-syntaxhighlighter-params="brush: java; gutter: false; theme: Default" data-theme="Default">$ ./configure --enable-debug $ gmake </pre> </div></div><h3 id="Filingusefulbugreports-DemangleC++symbols">Demangle C++ symbols</h3><p>When you get a stack trace (from gdb or the internal trace messages), please demangle the symbols by filtering it through the Unix command line utility <em><strong>c++filt</strong></em>. This makes the crash reports much easier to analyze, and provides a consistent format in all bug reports (so we can search and cross reference).</p><h3 id="Filingusefulbugreports-Debuggingmemoryrelatedcrashers">Debugging memory related crashers</h3><p>The environment variable MALLOC_CHECK_ can be useful in debugging certain malloc/free related bugs, such as double free (see: <a class="external-link" href="http://www.gnu.org/software/libc/manual/html_node/Heap-Consistency-Checking.html" rel="nofollow">http://www.gnu.org/software/libc/manual/html_node/Heap-Consistency-Checking.html</a>). Setting MALLOC_CHECK to 2 would cause an immediate abort and when properly configured to dump core this can be a useful mechanism for debugging these bugs.</p><h3 id="Filingusefulbugreports-SettingupGDB">Setting up GDB</h3><p>For best use of GDB, the following commands should be placed in your .gdbinit config, or done manually after you start gdb:</p><div class="code panel pdl conf-macro output-block" data-hasbody="true" data-macro-name="code" style="border-width: 1px;"><div class="codeContent panelContent pdl"> <pre class="syntaxhighlighter-pre" data-syntaxhighlighter-params="brush: java; gutter: false; theme: Default" data-theme="Default">set pagination 0 handle SIGPIPE nopass nostop noprint </pre> </div></div><p>The second configuration is absolutely vital, or you will like see SIGPIPE errors in write() while debugging, and these are not "crashers" even though they look like it.</p><h3 id="Filingusefulbugreports-StartingTrafficServerdirectlyingdb">Starting Traffic Server directly in gdb</h3><p>The easiest way to debug ATS is simply starting it directly under gdb. For example:</p><div class="code panel pdl conf-macro output-block" data-hasbody="true" data-macro-name="code" style="border-width: 1px;"><div class="codeContent panelContent pdl"> <pre class="syntaxhighlighter-pre" data-syntaxhighlighter-params="brush: java; gutter: false; theme: Default" data-theme="Default">$ sudo gdb bin/traffic_server ... Reading symbols from /usr/local/bin/traffic_server...done. (gdb) run </pre> </div></div><p>This will start up traffic_server inside gdb. You might get warnings telling you to install more detailed debug information, if so, you are encouraged to do so (just follow your Linux distributions instructions).</p><h3 id="Filingusefulbugreports-AttachinggdbtoarunningTrafficServerinstance">Attaching gdb to a running Traffic Server instance</h3><p>In a production environment, where you want to start Traffic Server in the normal way, you must attach gdb to the already running traffic_server process. This is easy, you just need to find the PID of the running traffic_server process (e.g. 12345), and then tell gdb to attach to that PID. For example:</p><div class="code panel pdl conf-macro output-block" data-hasbody="true" data-macro-name="code" style="border-width: 1px;"><div class="codeContent panelContent pdl"> <pre class="syntaxhighlighter-pre" data-syntaxhighlighter-params="brush: java; gutter: false; theme: Default" data-theme="Default">$ sudo gdb /usr/local/bin/traffic_server 12345 Loaded symbols for /lib64/libselinux.so.1 0x0000003f2dee1293 in epoll_wait () at ../sysdeps/unix/syscall-template.S:82 82 T_PSEUDO (SYSCALL_SYMBOL, SYSCALL_NAME, SYSCALL_NARGS) (gdb) continue Continuing. </pre> </div></div><p>It's important here that you either use a <strong>.gdbinit</strong> as above, or manually enter the required commands (see above), before you enter the <strong>continue</strong> command.</p><h3 id="Filingusefulbugreports-Debuggingacorefile">Debugging a core file</h3><p>With some luck, you might have gotten a core file from a running ATS system. If so, you can debug traffic_server without affecting the production system, and simply attach GDB to that core file. For example:</p><div class="code panel pdl conf-macro output-block" data-hasbody="true" data-macro-name="code" style="border-width: 1px;"><div class="codeContent panelContent pdl"> <pre class="syntaxhighlighter-pre" data-syntaxhighlighter-params="brush: java; gutter: false; theme: Default" data-theme="Default">$ sudo gdb /usr/local/bin/traffic_server /tmp/core.12345 ... (gdb) bt </pre> </div></div><h2 id="Filingusefulbugreports-Gettingcorefiles">Getting core files</h2><p>Getting a core file can sometimes be a bit complicated, and even when properly setup, you might not always get one. This section will explain for various platforms how to properly setup your system to allow it to generate core files.</p><p>For all systems, set the proxy.config.stack_dump_enabled config value to 0 in records.config. It is 1 by default which means that the traffic_server process will grab the SIGSEGV signal and print a stack trace rather than dumping the core. You must set this configuration variable to 0, so the traffic server process allows the signal to pass on and dump the core.</p><div class="code panel pdl conf-macro output-block" data-hasbody="true" data-macro-name="code" style="border-width: 1px;"><div class="codeContent panelContent pdl"> <pre class="syntaxhighlighter-pre" data-syntaxhighlighter-params="brush: java; gutter: false; theme: Default" data-theme="Default">CONFIG proxy.config.stack_dump_enabled INT 0 </pre> </div></div><h3 id="Filingusefulbugreports-Linux">Linux</h3><p>For an application to be able to generate a core file, it must have write permission to the directory where it should dump the core. This is by default $PWD, and for Traffic Server, this is not a directory that is typically writeable. Therefore, you should tell the kernel to generate core files in a different directory. The following example shows how to tell the system to generate core files like <code>/tmp/core.12345</code>:</p><div class="code panel pdl conf-macro output-block" data-hasbody="true" data-macro-name="code" style="border-width: 1px;"><div class="codeContent panelContent pdl"> <pre class="syntaxhighlighter-pre" data-syntaxhighlighter-params="brush: java; gutter: false; theme: Default" data-theme="Default">$ sudo sysctl kernel.core_pattern=/tmp/core.%p </pre> </div></div><p>Additional parameters are available for naming, see <code>man 5 core</code> or <a class="external-link" href="http://linux.die.net/man/5/core" rel="nofollow">here</a>.</p><p>On older Linux systems you may need to use the following instead.</p><div class="code panel pdl conf-macro output-block" data-hasbody="true" data-macro-name="code" style="border-width: 1px;"><div class="codeContent panelContent pdl"> <pre class="syntaxhighlighter-pre" data-syntaxhighlighter-params="brush: java; gutter: false; theme: Default" data-theme="Default">$ sudo sysctl kernel.core_uses_pid=1 $ sudo sysctl kernel.core_pattern=/tmp/core </pre> </div></div><p>You can add this to your <code>/etc/sysctl.conf</code> file. For more information please see the man page for core (i.e. <code>man 5 core</code>). Note that if you are currentlying using <a class="external-link" href="http://docs.fedoraproject.org/en-US/Fedora/15/html/Deployment_Guide/ch-abrt.html" rel="nofollow">ABRT</a> this will effectively disable that feature. You may instead be able to access the crash through ABRT rather than changing the core pattern.</p><p>In addition to being able to write to a directory, there are also a couple of resource limits that must be increased. Before starting traffic_server you must make sure that the process has unlimited core file size, and file size. You have a few options here, including modifying root's hard limits via <code>/etc/security/limits.conf</code> (but be aware that affects all of root's processes). Easiest is to do it from command line, e.g.</p><div class="code panel pdl conf-macro output-block" data-hasbody="true" data-macro-name="code" style="border-width: 1px;"><div class="codeContent panelContent pdl"> <pre class="syntaxhighlighter-pre" data-syntaxhighlighter-params="brush: java; gutter: false; theme: Default" data-theme="Default">$ sudo -s # ulimit -c unlimited # ulimit -f unlimited # /usr/local/bin/trafficserver start </pre> </div></div><p>If your traffic_server is started by root (via <code>init</code> or similar mechansim) it will call setuid/setgid. For Traffic Server versions before 3.1.1 (see <a class="external-link" href="https://issues.apache.org/jira/browse/TS-936" rel="nofollow">TS-936</a>) this will prevent a core file from being generated. To work around this you should set <code>/proc/sys/fs/suid_dumpable</code> to <code>1</code>.</p><div class="code panel pdl conf-macro output-block" data-hasbody="true" data-macro-name="code" style="border-width: 1px;"><div class="codeContent panelContent pdl"> <pre class="syntaxhighlighter-pre" data-syntaxhighlighter-params="brush: java; gutter: false; theme: Default" data-theme="Default"># echo 1 > /proc/sys/fs/suid_dumpable </pre> </div></div><p>Note that this is a global setting with security implications (as a setuid program may contain sensitive information which ends up in the core file).</p> </div> <div id="labels-section" class="pageSection group"> <div class="labels-section-content content-column" entityid="26805171" entitytype="page"> <div class="labels-content"> <ul class="label-list label-list-right "> <li class="no-labels-message"> No labels </li> </ul> </div> </div> </div> <div id="comments-section" class="pageSection group"> <div class="section-header"> <h2 id="comments-section-title" class="section-title"> 3 Comments </h2> </div> <ol class="comment-threads top-level" id="page-comments"> <li id="comment-thread-30738165" class="comment-thread"> <div class="comment " id="comment-30738165"> <p class="comment-user-logo"> <img class="userLogo logo anonymous" src="/confluence/s/5tj15x/8804/z1btw/_/images/icons/profilepics/anonymous.svg" alt="User icon: Anonymous" title="Anonymous"> </p> <div class="comment-header"> <h4 class="author"> <span class="anonymous-user">Anonymous</span></h4> </div> <div class="comment-body"> <div class="comment-content wiki-content"> <p>Dear Sir / Madam,</p> <p>we spent now about an entire week to get ATS compiled on Sun Solaris UltraSparc IIIi.</p> <p>We fatally failed on version 3.2.0 and version 3.3.0</p> <p>The build is not possible ein Sun Solaris 10 09/10 and also not on Sun Solaris 11 Nevada b130.</p> <p>Note: Sun Solaris 11 b130 is N.O.T. Oracle Solaris 11 !!!!!<br/> Oracle Solaris 11 is entirely based on openSolaris</p> <p>We could solve some compile issues to put the compile process a step forward:</p> <p>1.)<br/> on a very early stage the compiling fails on line 122 in lib/ink_queue.h.</p> <p>The reason is, that the CPU-Arch is not properly recognized. </p> <p>We implemented a "dirty" hack to go around this:</p> <ul class="alternate"> <li>// #error "unsupported processor"<br/> + #define FREELIST_POINTER(_x) ((void*)(((((intptr_t)(_x).data)<<16)>>16) | \<br/> + (((~((((intptr_t)(_x).data)<<16>>63)-1))>>48)<<48))) // sign extend<br/> + #define FREELIST_VERSION(_x) (((intptr_t)(_x).data)>>48)<br/> + #define SET_FREELIST_POINTER_VERSION(_x,_p,_v) \<br/> + (_x).data = ((((intptr_t)(_p))&0x0000FFFFFFFFFFFFULL) | (((_v)&0xFFFFULL) << 48))</li> </ul> <p>2.)<br/> All yacc, bison, lex and flex versions shipped with Sun Solaris 10/11 fail on the *.y yacc scripts <br/> located in lib/tsconfig</p> <p>Our solution: we renamed bison, yacc, lex & flex and worked only with bison and flex in their latest versions from csw/blaswave which are for bison 2.4.3 and for flex 2.5.35</p> <p>3.)<br/> the compiling fails another time because of lib/tsconfig/TsValue.h with the complaint, that strlen() function needs a prototype.</p> <p>Our solution: in TsConfig.h we added in line 27:</p> <ol> <li>include <string.h></li> </ol> <p>to continue the build.</p> <p>4.)<br/> the final issue we stuck now without any clue how to overcome this is here:</p> <p> CXXLD test-tsconfig<br/> ld: fatal: file ./.libs/libtsconfig.so: open failed: No such file or directory<br/> ld: fatal: file ../ts/.libs/libtsutil.so: open failed: No such file or directory<br/> ld: fatal: file processing errors. No output written to .libs/test-tsconfig</p> <p>libtsconfig.so and libtsutil.so both link in the same .libs-dir to non-existent libs which were <br/> never generated:</p> <p>libtsutil.la -> ../libtsutil.la<br/> libtsutil.lai<br/> libtsutil.a<br/> libtsutil.so -> libtsutil.so.3.2.0<br/> libtsutil.so.3 -> libtsutil.so.3.2.0</p> <p>We tried configure with a numberless set of parameters, it does not help at all.</p> <p>This was the last configure we tried:</p> <p>./configure --prefix=/opt/sfp/isp/ats/3.2.0 --enable-wccp CC='/opt/SUNWspro/prod/bin/cc' CFLAGS='-m64' --with-openssl=/opt/sfp/isp/ssl --with-tcl=/usr/lib/sparcv9/tclConfig.sh --with-expat=/opt/sfp/isp/expat/2.0.1 --with-pcre=/opt/sfp/isp/pcre/8.20</p> <p>We would be very happy to receive any help from you and apologize for the<br/> additional workload our inquiry might have caused you.</p> <p>Thank you very much in advance.</p> <p>Best Regards.</p> <p>Dave.<br/> <a class="unresolved" href="#">DE</a>SYSTEMS ENGINEERING Ltd.<br/> dese.co.uk / sunfreepacks.com</p> </div> <div class="comment-actions"> <ul class="comment-actions-secondary"> <li class="first comment-permalink"><a title="Permanent link to this comment" href="/confluence/display/TS/Filing+useful+bug+reports?focusedCommentId=30738165#comment-30738165" id="comment-permalink-30738165" ><span>Permalink</span></a></li> </ul> <ul class="comment-actions-primary"> <li class="first comment-date"><a title="Oct 06, 2012 15:54" href="/confluence/display/TS/Filing+useful+bug+reports?focusedCommentId=30738165#comment-30738165" ><span>Oct 06, 2012</span></a></li> <li class=" "><a href="/confluence/plugins/aptis/deleteAllComments/ask-user.action?pageId=26805171" id="delete-all-comments-link-comment-link-30738165" ><span>Delete comments</span></a></li> </ul> </div> </div> </div> <ol class="comment-threads"> <li id="comment-thread-30738166" class="comment-thread"> <div class="comment " id="comment-30738166"> <p class="comment-user-logo"> <img class="userLogo logo anonymous" src="/confluence/s/5tj15x/8804/z1btw/_/images/icons/profilepics/anonymous.svg" alt="User icon: Anonymous" title="Anonymous"> </p> <div class="comment-header"> <h4 class="author"> <span class="anonymous-user">Anonymous</span></h4> </div> <div class="comment-body"> <div class="comment-content wiki-content"> <p>Sorry, minor typo!</p> <p>regarding point 3.) in our above report, it is not TsConfig.h but TsValue.h which requires<br/> the additional line with #include <string.h></p> </div> <div class="comment-actions"> <ul class="comment-actions-secondary"> <li class="first comment-permalink"><a title="Permanent link to this comment" href="/confluence/display/TS/Filing+useful+bug+reports?focusedCommentId=30738166#comment-30738166" id="comment-permalink-30738166" ><span>Permalink</span></a></li> </ul> <ul class="comment-actions-primary"> <li class="first comment-date"><a title="Oct 06, 2012 16:02" href="/confluence/display/TS/Filing+useful+bug+reports?focusedCommentId=30738166#comment-30738166" ><span>Oct 06, 2012</span></a></li> <li class=" "><a href="/confluence/plugins/aptis/deleteAllComments/ask-user.action?pageId=26805171" id="delete-all-comments-link-comment-link-30738166" ><span>Delete comments</span></a></li> </ul> </div> </div> </div> </li> <li id="comment-thread-30741578" class="comment-thread"> <div class="comment " id="comment-30741578"> <p class="comment-user-logo"> <img class="userLogo logo anonymous" src="/confluence/s/5tj15x/8804/z1btw/_/images/icons/profilepics/anonymous.svg" alt="User icon: i.galic" title="i.galic"> </p> <div class="comment-header"> <h4 class="author"> <a href=" /confluence/display/~i.galic " class="url fn" >Igor Galić</a></h4> </div> <div class="comment-body"> <div class="comment-content wiki-content"> <p>First off: The comment system of this wiki isn't a good support channel. Especially since I have no idea how to setup alerting for new changes.<br/> Second: This particular question is offtopic here.</p> <p>But most importantly: No. As of yet we do not support Sparc platforms. If I had a spark machine and free time I would have already ported it. Alas…</p> </div> <div class="comment-actions"> <ul class="comment-actions-secondary"> <li class="first comment-permalink"><a title="Permanent link to this comment" href="/confluence/display/TS/Filing+useful+bug+reports?focusedCommentId=30741578#comment-30741578" id="comment-permalink-30741578" ><span>Permalink</span></a></li> </ul> <ul class="comment-actions-primary"> <li class="first comment-date"><a title="Nov 08, 2012 19:25" href="/confluence/display/TS/Filing+useful+bug+reports?focusedCommentId=30741578#comment-30741578" ><span>Nov 08, 2012</span></a></li> <li class=" "><a href="/confluence/plugins/aptis/deleteAllComments/ask-user.action?pageId=26805171" id="delete-all-comments-link-comment-link-30741578" ><span>Delete comments</span></a></li> </ul> </div> </div> </div> </li> </ol> </li> </ol> </div> </div> <div id="space-tools-web-items" class="hidden"> <div data-label="Overview" data-href="/confluence/spaces/viewspacesummary.action?key=TS">Overview</div> <div data-label="Content Tools" data-href="/confluence/pages/reorderpages.action?key=TS">Content Tools</div> <div data-label="Apps" data-href="/confluence/spaces/snippeterrors.action?key=TS">Apps</div> </div> </main> <div id="footer" role="contentinfo"> <section class="footer-body"> <p class="license license-opensource"> Powered by a free <b>Atlassian Confluence Open Source Project License</b> granted to Apache Software Foundation. <a href="https://www.atlassian.com/software/views/opensource-community-additional-license-offer">Evaluate Confluence today</a>.<br> </p> <ul id="poweredby"> <li class="noprint">Powered by <a href="https://www.atlassian.com/software/confluence" class="hover-footer-link" rel="nofollow">Atlassian Confluence</a> <span id='footer-build-information'>7.19.30</span></li> <li class="print-only">Printed by Atlassian Confluence 7.19.30</li> <li class="noprint"><a href="https://support.atlassian.com/confluence-server/" class="hover-footer-link" rel="nofollow">Report a bug</a></li> <li class="noprint"><a href="https://www.atlassian.com/company" class="hover-footer-link" rel="nofollow">Atlassian News</a></li> </ul> <div id="footer-logo"><a href="https://www.atlassian.com/" rel="nofollow">Atlassian</a></div> </section> </div> </div> </div> </div> <span style="display:none;" id="confluence-server-performance">{"serverDuration": 131, "requestCorrelationId": "1deaec2aaf785c53"}</span> </body> </html>

CINXE.COM

Filing useful bug reports - Traffic Server - Apache Software Foundation