Skip to content

src: add proper MemoryInfoName to wrappers - #21939

Closed
joyeecheung wants to merge 1 commit into
nodejs:masterfrom
joyeecheung:wrap-node-name
Closed

src: add proper MemoryInfoName to wrappers#21939
joyeecheung wants to merge 1 commit into
nodejs:masterfrom
joyeecheung:wrap-node-name

Conversation

@joyeecheung

@joyeecheungjoyeecheung commented Jul 23, 2018

Copy link
Copy Markdown
Member
  • Use camel case names for memory retainers inherited from AsyncWrap
    instead of their provider names (which are all in upper case)
  • Assign class names to wraps so that they appear in the heap snapshot
    as nodes with class names as node names. Previously some nodes are
    named with reference names, which are supposed to be edge names
    instead.

Before (in DevTools):
screen shot 2018-07-22 at 9 13 32 am

After:
screen shot 2018-07-22 at 9 11 46 am

Checklist
  • make -j4 test (UNIX), or vcbuild test (Windows) passes
  • tests and/or benchmarks are included
  • commit message follows commit guidelines

@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

@nodejs-github-botnodejs-github-bot added c++ Issues and PRs that require attention from people who are familiar with C++. lib / src Issues and PRs related to general changes in the lib or src directory. labels Jul 23, 2018
- Use camel case names for memory retainers inherited from AsyncWrap
instead of their provider names (which are all in upper case)
- Assign class names to wraps so that they appear in the heap snapshot
as nodes with class names as node names. Previously some nodes are
named with reference names, which are supposed to be edge names
instead.
@joyeecheung

Copy link
Copy Markdown
MemberAuthor

cc @addaleax

@addaleaxaddaleax added the memory Issues and PRs related to the memory management or memory footprint. label Jul 23, 2018
@addaleax

Copy link
Copy Markdown
Member

Hm... I think I'd prefer it if we could stick to one naming scheme for diagnostic information we provide for AsyncWraps. I do prefer CamelCase like you introduce it here, and I think we should have also been providing CamelCase in async_hooks from the very beginning. I'm not sure we can still make that switch? /cc @nodejs/async_hooks

@joyeecheung

joyeecheung commented Jul 23, 2018

Copy link
Copy Markdown
MemberAuthor

@addaleax We have more wraps than just the async wraps though, if we want to stick to the naming scheme we will end up polluting all the names including those that do not have async resource provider equivalents and types of different levels, e.g. QueryNaptrWrap v.s. QUERYWRAP.

Also for tooling, it's easy to convert camel cases to upper cases, but not the way around.

For the async hooks the ship may have already sailed since we have documented those types for quite some time? For heap snapshots the names are mainly used for aggregation, the users may still end up going back to the source so I don't think there is a need to document them down.

@devsnek

Copy link
Copy Markdown
Member

just out of curiosity, do any of these not match the class name? maybe you could set it up with like typeid(this).name() or something

@joyeecheung

joyeecheung commented Jul 23, 2018

Copy link
Copy Markdown
MemberAuthor

@devsnek Some of them do, e.g. TCPWrap is divided into TCPSocketWrap and TCPServerWrap mainly because they are also differentiated as async resources. We could probably make this the default behavior of BaseObject, although RTTI (in non-tests) is advised against in Google's style guide and V8 always avoid using that by explicitly using macros (which is also done in this PR)

@addaleaxaddaleax left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Okay, makes sense -- I still think it would be great to eventually have consistency between this and async_hooks. It's not just casing that's different currently, though (e.g. ZLIB vs ZCtx)...

@joyeecheung

Copy link
Copy Markdown
MemberAuthor

@joyeecheung

Copy link
Copy Markdown
MemberAuthor

@joyeecheungjoyeecheung mentioned this pull request Jul 26, 2018
1 task
@joyeecheung

Copy link
Copy Markdown
MemberAuthor

Landed in 28a3e28, thanks!

joyeecheung added a commit that referenced this pull request Jul 27, 2018
- Use camel case names for memory retainers inherited from AsyncWrap
instead of their provider names (which are all in upper case)
- Assign class names to wraps so that they appear in the heap snapshot
as nodes with class names as node names. Previously some nodes are
named with reference names, which are supposed to be edge names
instead.
PR-URL: #21939
Reviewed-By: Anna Henningsen <anna@addaleax.net>
Reviewed-By: Colin Ihrig <cjihrig@gmail.com>
Reviewed-By: Gus Caplan <me@gus.host>
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Tobias Nießen <tniessen@tnie.de>
targos pushed a commit that referenced this pull request Jul 31, 2018
- Use camel case names for memory retainers inherited from AsyncWrap
instead of their provider names (which are all in upper case)
- Assign class names to wraps so that they appear in the heap snapshot
as nodes with class names as node names. Previously some nodes are
named with reference names, which are supposed to be edge names
instead.
PR-URL: #21939
Reviewed-By: Anna Henningsen <anna@addaleax.net>
Reviewed-By: Colin Ihrig <cjihrig@gmail.com>
Reviewed-By: Gus Caplan <me@gus.host>
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Tobias Nießen <tniessen@tnie.de>
@targostargos mentioned this pull request Jul 31, 2018
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

c++Issues and PRs that require attention from people who are familiar with C++.lib / srcIssues and PRs related to general changes in the lib or src directory.memoryIssues and PRs related to the memory management or memory footprint.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

7 participants

@joyeecheung@nodejs-github-bot@addaleax@devsnek@jasnell@cjihrig@tniessen