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 |
|