From owner-freebsd-doc@freebsd.org Thu Jan 25 14:37:48 2018 Return-Path: Delivered-To: freebsd-doc@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id E4F93EDBAFD for ; Thu, 25 Jan 2018 14:37:47 +0000 (UTC) (envelope-from philneaton95@gmail.com) Received: from mail-qt0-x230.google.com (mail-qt0-x230.google.com [IPv6:2607:f8b0:400d:c0d::230]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (Client CN "smtp.gmail.com", Issuer "Google Internet Authority G2" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 8C9F87F9AC for ; Thu, 25 Jan 2018 14:37:44 +0000 (UTC) (envelope-from philneaton95@gmail.com) Received: by mail-qt0-x230.google.com with SMTP id z10so19672323qti.5 for ; Thu, 25 Jan 2018 06:37:44 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=mime-version:from:date:message-id:subject:to; bh=NRX4Gp726fuskKE8K9NZ2pBY3kvEgjz0CEjrWWflwKM=; b=ZvBsIOEtbCf+YZ9PoTjmyiZBQhnYwjbbOVZKajs9qPzAl5u54SYDJKvGkoUZXn6BB9 sV6QwZ312NN51z7ghqOZ0D2fElK4GCNvy7p3xLhQmWwf/4xTmHyBB1uWzM9wQO8RkE7G QSEbbNMcUnmNEiTtqU5ymOzi4FPlc3k+t20Wbc2fmntku2Fyf403ylbrnqdRkZLjX7At Gx/gnMsrKYwtm9KNkLlCq2PH1i7KqmE7Uft+0CTZiSzC6b25U23Y+F8YajvnQX3M9YIg pd7c6bfVVqy3W+4LvRZ/gnEOxQkx+SfvYJa5mam/evnjkAbAETRPJdpJs5FBqaZpj19/ v9Bg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:from:date:message-id:subject:to; bh=NRX4Gp726fuskKE8K9NZ2pBY3kvEgjz0CEjrWWflwKM=; b=FDLF/tyUmb3VDr5FlILBZkbIOmKMf73NIXzx5rgKe6ocZt8oE1EvDS1ybFrDP66IjD /z51dwfzLcATw0iq1DwUqqA14QFTA50vkaMTYZ6CZS5aT4x8k8q+NcJPs6sIi2PWizCz 53olUXq/6h8374rST7Thkl+Ts04JFHC0oCZaviC4ESjz1dJsbHKhvqWmQq5cHY5EJJuk jDg6WBmUzjBnhHSArEFQpdFhxrf9Quk1gq4hq4RAJY8gJLlL5GSICZuJC2X6cO1xRBMi JKTKweHLuUZaJDICw9v7UD43sOBaUhnkutudaUXgV8efBKvlhLfn8ltYm7h4eXty5Gla gVAA== X-Gm-Message-State: AKwxyted23UXJXhfTI63vkGzfyZGvVMg7omcsyZTGBawu2uMd0A5aDsq kxadsExG92lou2JErEkAtTPXAj3g7m65CGF+0tJR1Q== X-Google-Smtp-Source: AH8x2274e8NLuNlAIAHHk+OKmC0YO6Dd0gVO9FjKs93iAQ38mVntHBMBfko7mekVFiutUv4vEx42UUrQgNJNbdVZ7YE= X-Received: by 10.200.15.141 with SMTP id b13mr11785290qtk.301.1516891063742; Thu, 25 Jan 2018 06:37:43 -0800 (PST) MIME-Version: 1.0 Received: by 10.12.153.219 with HTTP; Thu, 25 Jan 2018 06:37:43 -0800 (PST) From: Phil Eaton Date: Thu, 25 Jan 2018 09:37:43 -0500 Message-ID: Subject: Question about docs and FreeBSD CURRENT To: FreeBSD-doc@freebsd.org Content-Type: text/plain; charset="UTF-8" X-Content-Filtered-By: Mailman/MimeDel 2.1.25 X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.25 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 25 Jan 2018 14:37:48 -0000 Hey! I was recently trying to debug a kernel module that causes a kernel panic on load. I tried following the docs in the FreeBSD Handbook for debugging a kernel panic, but a few of the steps were slightly off for me on CURRENTl. The docs do clearly state that the docs are only for 10.4-RELEASE and 11.1-RELEASE. So my first question: is there a hosted version (e.g. freebsd.org/doc/CURRENT/en/books) of the handbook that tracks CURRENT? If not, do I just have to follow along on CURRENT of the docs svn repo and build the docs myself manually to see current information? In particular I was confused about all the references to kgdb in the FreeBSD handbook docs related to debugging the kernel. On my system there was no kgdb and there is no gdb of course by default either because FreeBSD switched off it. I later understood that I could just install gdb from ports and run `gdb -k` to get similar behavior. But the docs continued to suggest that kgdb was a built-in binary. Later I found out that kgdb _is_ in fact installed on the base system but it was in an undocumented location: /usr/libexec/kgdb. The next issue I had was which directory to start in to find debugging symbols. The docs suggested going to */usr/obj/usr/src/sys/**KERNCONF* but I actually had to go to */usr/obj/usr/src/amd64.amd64/sys/GENERIC*. I don't know if this is because I installed the system oddly (I don't believe I did), or if this was a location change in CURRENT. In any case, I'm just trying to find the best way to stay current on docs while I'm running CURRENT. If any of these notes I made has not yet been updated in docs, I'd be happy to submit some changes myself. Thank you! -- Phil Eaton