Blame doc/ieee1284_free_ports.3

Packit d36e9b
.\"     Title: ieee1284_free_ports
Packit d36e9b
.\"    Author: Tim Waugh <twaugh@redhat.com>
Packit d36e9b
.\" Generator: DocBook XSL Stylesheets v1.72.0 <http://docbook.sf.net/>
Packit d36e9b
.\"      Date: 09/18/2007
Packit d36e9b
.\"    Manual: Functions
Packit d36e9b
.\"    Source: 
Packit d36e9b
.\"
Packit d36e9b
.TH "IEEE1284_FREE_PORTS" "3" "09/18/2007" "" "Functions"
Packit d36e9b
.\" disable hyphenation
Packit d36e9b
.nh
Packit d36e9b
.\" disable justification (adjust text to left margin only)
Packit d36e9b
.ad l
Packit d36e9b
.SH "NAME"
Packit d36e9b
ieee1284_free_ports \- safely deallocate a port list
Packit d36e9b
.SH "SYNOPSIS"
Packit d36e9b
.sp
Packit d36e9b
.ft B
Packit d36e9b
.nf
Packit d36e9b
#include <ieee1284.h>
Packit d36e9b
.fi
Packit d36e9b
.ft
Packit d36e9b
.HP 25
Packit d36e9b
.BI "void ieee1284_free_ports(struct\ parport_list\ *" "list" ");"
Packit d36e9b
.SH "DESCRIPTION"
Packit d36e9b
.PP
Packit d36e9b
When the port list will no longer be used, the program should call
Packit d36e9b
\fBieee1284_free_ports\fR
Packit d36e9b
giving it a pointer to the
Packit d36e9b
parport_list
Packit d36e9b
structure that holds the list of ports returned by
Packit d36e9b
\fBieee1284_find_ports\fR(3). The ports are reference counted with the
Packit d36e9b
\fBieee1284_open\fR
Packit d36e9b
and
Packit d36e9b
\fBieee1284_close\fR
Packit d36e9b
functions, and so the port list may be freed even if it contains pointers to ports that are still open.
Packit d36e9b
.SH "AUTHOR"
Packit d36e9b
.PP
Packit d36e9b
\fBTim Waugh\fR <\&twaugh@redhat.com\&>
Packit d36e9b
.sp -1n
Packit d36e9b
.IP "" 4
Packit d36e9b
Author.
Packit d36e9b
.SH "COPYRIGHT"
Packit d36e9b
Copyright \(co 2001\-2003 Tim Waugh
Packit d36e9b
.br
Packit d36e9b