From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1753158AbcGYRqo (ORCPT ); Mon, 25 Jul 2016 13:46:44 -0400 Received: from tex.lwn.net ([70.33.254.29]:38846 "EHLO vena.lwn.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1752941AbcGYRqm (ORCPT ); Mon, 25 Jul 2016 13:46:42 -0400 Date: Mon, 25 Jul 2016 11:46:35 -0600 From: Jonathan Corbet To: Charlemagne Lasse Cc: linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org Subject: Re: Visualizing linux kernel datastructures Message-ID: <20160725114635.32210732@lwn.net> In-Reply-To: References: Organization: LWN.net MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 8bit Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On Mon, 25 Jul 2016 16:56:46 +0200 Charlemagne Lasse wrote: > So my questions would be: > > 1. is there a standard (machine readable?) how to correctly document > (kernel-doc?) in the code if a struct list_head is the head/root of a > list or the anchor of the item in a list? > > 2. is there a standard (machine readable?) how to correctly document > the type of objects stored in a list/hlist/rbtree? > > 3. is there already some kind of tool to visualize data structures > from the Linux kernel which supports list/hlist/rbtree and shows it in > the diagram (image, graphviz, ...) as 1:n relation? As far as I know, the answer to all three questions would be "no." Confusion about such things has not generally been a problem with the code, so there hasn't been a push for such tools (or a person motivated to create them). Thanks, jon