Case Study: Reference Pages

This is the DocBook XML source for a reference page.

<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"

<refpurpose>get password file entry</refpurpose>


#include &lt;pwd.h>
#include &lt;sys/types.h>

struct passwd *getpwnam(const char * name);

struct passwd *getpwuid(uid_t uid);



<para>The <function>getpwnam</function> function returns a pointer to
a structure containing the broken out fields of a line from
<filename>/etc/passwd</filename> for the entry that matches the
user name <parameter>name</parameter>.





The reference page is also available in HTML and PDF