docs/51480: Multiple undefined references in the FreeBSD manual pages

[Jim Brown]

The following reply was made to PR docs/51480; it has been noted by GNATS.

From: Jim Brown <jpb at sixshooter.v6.thrupoint.net>
To: freebsd-gnats-submit at FreeBSD.org, dds at aueb.gr
Cc:  
Subject: Re: docs/51480: Multiple undefined references in the FreeBSD manual pages
Date: Tue, 6 May 2003 20:45:56 -0400

 Hi,
 
 I hand checked section 9 of the manual to see if these assertions
 are correct.  My results are shown below.
 
 KEY:
 
 FOUND   = I did find the reference in a man page .  Assertion is incorrect.
 REF?    = I could not verify the assertion.  Man page likely changed since this PR was filed.
 MISSING = I did not find the reference in a man page.  Assertion is correct.
 
 -------------------------------------------------------------------------------------------------------------
 FOUND   /usr/share/man/man9/VFS_UNMOUNT.9.gz(60): Undefined reference to vflush(9)
 MISSING /usr/share/man/man9/VFS_CHECKEXP.9.gz(63): Undefined reference to vfs_export_lookup(9)
 REF?    /usr/share/man/man9/VOP_LOOKUP.9.gz(433): Undefined reference to VOP_ABORTOP(9)
 REF?    /usr/share/man/man9/boot.9.gz(83): Undefined reference to at_shutdown(9)
 FOUND   /usr/share/man/man9/crypto.9.gz(211): Undefined reference to ((ipsec)
 FOUND   /usr/share/man/man9/mi_switch.9.gz(87): Undefined reference to issignal(9)
 FOUND   /usr/share/man/man9/namei.9.gz(192): Undefined reference to NDFREE(9)
 MISSING /usr/share/man/man9/time.9.gz(109): Undefined reference to gettime(9)
 FOUND   /usr/share/man/man9/vnode.9.gz(167): Undefined reference to vhold(9)
 FOUND   /usr/share/man/man9/vnode.9.gz(169): Undefined reference to vdrop(9)
 FOUND   /usr/share/man/man9/vnode.9.gz(177): Undefined reference to getnewvnode(9)
 MISSING /usr/share/man/man9/vnode.9.gz(178): Undefined reference to vfree(9)
 MISSING /usr/share/man/man9/vnode.9.gz(180): Undefined reference to vbusy(9)
 MISSING /usr/share/man/man9/vnode.9.gz(189): Undefined reference to VFS_GET(9)
 MISSING /usr/share/man/man9/vnode.9.gz(224): Undefined reference to vfs_object_create(9)
 FOUND   /usr/share/man/man9/device.9.gz(55): Undefined reference to device_get_parent(9)
 MISSING /usr/share/man/man9/device_quiet.9.gz(56): Undefined reference to device_detach(9)
 FOUND   /usr/share/man/man9/BUS_SETUP_INTR.9.gz(60): Undefined reference to BUS_TEARDOWN_INTR(9)
 MISSING /usr/share/man/man9/bus_generic_map_intr.9.gz(46): Undefined reference to BUS_MAP_INTR(9)
 REF?    /usr/share/man/man9/bus_alloc_resource.9.gz(115): Undefined reference to rman_activate_resource(9)
 FOUND   /usr/share/man/man9/bus_release_resource.9.gz(51): Undefined reference to bus_teardown_intr(9)
 MISSING /usr/share/man/man9/DEVICE_IDENTIFY.9.gz(49): Undefined reference to BUS_ADD_CHILD(9)
 FOUND   /usr/share/man/man9/DEVICE_IDENTIFY.9.gz(55): Undefined reference to bus_set_resource(9)
 FOUND   /usr/share/man/man9/DEVICE_IDENTIFY.9.gz(90): Undefined reference to device_set_driver(9)
 FOUND   /usr/share/man/man9/sbuf.9.gz(339): Undefined reference to printf(9)
 -------------------------------------------------------------------------------------------------------------
 
 
 The large number of FOUND entries causes me to wonder
 if the tool operates correctly.
 
 Three thoughts:
 
 1. Ensure your sources are up to date.  Some FOUND entries
    noted above were right in the directory.  Either your sources
    are incomplete, or the tool doesn't work right.  See #2.
 
 2. The tool may not find references that are 
    second or third entries in a man page (such as printf(3)
    which has printf, fprintf, sprintf, snprintf, asprintf ...)
    Check the tool for correctness.
 
 3. This PR is too large- you are better off closing this PR and
    submitting a separate PR for each section.
 
 
 jpb
 ===
 
 My uname -a
 FreeBSD jpb-wks.v6.thrupoint.net 4.8-STABLE FreeBSD 
 4.8-STABLE #0: Mon Apr 21 15:21:29 EDT 2003
 root at jpb-wks.v6.thrupoint.net:/usr/obj/usr/src/sys/JPB02  i386