Viewing: llapi_project_fgetnam.3
.TH LLAPI_PROJECT_FGETNAM 3 2025-07-01 "Lustre User API" "Lustre Library Functions"
.SH NAME
llapi_project_fgetnam \- read project matching a name from specified file into a buffer
.SH SYNOPSIS
.nf
.B #include <lustre/lustreapi.h>
.sp
.BI "int llapi_project_fgetnam(struct ll_project_handle *" hdl ", struct ll_project *" lprj ",
.BI " const char *" name );
.fi
.SH DESCRIPTION
The
.B llapi_project_fgetnam()
function reads the contents of the file specified by
.BR hdl->lph_file ,
until an entry matches the provided
.IR *name ,
and fills is the remaining space with the information provided in the file.
The buffer should be preallocated.
.SH RETURN VALUES
.TP
.B 0
on success
.TP
-ve
error code on failure and sets errno appropriately.
.SH ERRORS
.TP 15
.B -EINVAL
if either
.I lprj
is NULL, or
.I lprj->lprj_size
is invalid.
.SH AVAILABILITY
.B llapi_project_fgetnam()
is part of the
.BR lustre (7)
user application interface library since release 2.17.0
.\" Added in commit v2_16_55-17-g75c6d5636d
.SH SEE ALSO
.BR lfs_project (1),
.BR llapi_project_close (3),
.BR llapi_project_fgetprjid (3),
.BR llapi_project_get (3),
.BR llapi_project_getnam (3),
.BR llapi_project_getprjid (3),
.BR llapi_project_open (3),
.BR llapi_project_put (3),
.BR projid (5),
.BR lustreapi (7)
