Bug 126484 - libc function res-zonscut2 is not documented
Summary: libc function res-zonscut2 is not documented
Status: Open
Alias: None
Product: Documentation
Classification: Unclassified
Component: Manual Pages (show other bugs)
Version: Latest
Hardware: Any Any
: Normal Affects Only Me
Assignee: freebsd-bugs (Nobody)
URL:
Keywords:
Depends on:
Blocks: 108980
  Show dependency treegraph
 
Reported: 2008-08-12 21:50 UTC by Ronald F. Guilmette
Modified: 2023-01-22 17:59 UTC (History)
1 user (show)

See Also:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Ronald F. Guilmette 2008-08-12 21:50:01 UTC
	The resolver library routine called res_findzonecut2 which is part
	of libc isn't documented on any man page... at least none that I've
	found.  But this is a useful function, and should have a man page.

Fix: 

The man page for resolver(3) should be enhanced so as to also
	document res_findzonecut2.

	Depending on how the folks at IBM feel about it, you could probably
	just snatch most of the verbage necessary to document this function
	from the following URL:

	http://publib.boulder.ibm.com/infocenter/iseries/v5r3/index.jsp?topic=/apis/resfindzonecut.htm

	...where IBM seems to have already done a pretty Nice Job of documenting
	the original res_findzonecut function.  Note however that in the
	res_findzonecut2 function, the 7th parameter has type
	(union res_sockaddr_union *) rather than type (struct in_addr *) as
	for the original function, res_findzonecut.
How-To-Repeat: 	man res_findzonecut2
	man res_findzonecut
	man 3 resolver

	(The first two commands above just produce errors.  The third shows
	that the man page which documents all of the other res_* resolver
	library routines fails to even mention res_findzonecut.
Comment 1 Eitan Adler freebsd_committer freebsd_triage 2017-12-31 07:59:38 UTC
For bugs matching the following criteria:

Status: In Progress Changed: (is less than) 2014-06-01

Reset to default assignee and clear in-progress tags.

Mail being skipped