.\" Copyright 2015-2017 IBM Corp.
.\"
.TH CXL_AFU_SYSFS_PCI 3 2017-05-24 "LIBCXL 1.5" "CXL Programmer's Manual"
.SH NAME
cxl_afu_sysfs_pci \- get the sysfs path to the PCI device corresponding with 
an AFU
.SH SYNOPSIS
.B #include <libcxl.h>
.PP
.B "int cxl_afu_sysfs_pci(struct cxl_afu_h"
.BI * afu ", char **" pathp );
.SH DESCRIPTION
.BR cxl_afu_sysfs_pci ()
copies the address of a buffer containing the sysfs path to the
PCI device corresponding with
.I afu
into the pointer
.IR pathp .
.PP
On success, this function automatically allocates the returned
buffer, which must be freed by the caller (much like asprintf).
.SH RETURN VALUE
On success, 0 is returned.
On error, \-1 is returned and
.I errno
is set appropriately.
.SH ERRORS
.TP
.B EINVAL
Invalid argument value.
.TP
.B ENOMEM
Insufficient memory.
.SH SEE ALSO
.BR asprintf (3),
.BR cxl (3),
.BR cxl_adapter_afu_next (3),
.BR cxl_afu_dev_name (3),
.BR cxl_afu_next (3),
.BR free (3)