From: Heinrich Schuchardt Date: Wed, 12 Sep 2018 17:00:02 +0000 (+0200) Subject: efi_loader: provide description of file_open() X-Git-Url: http://git.dujemihanovic.xyz/?a=commitdiff_plain;h=050cea770a873bc2d9210fb04c4db8fadbaa69ff;p=u-boot.git efi_loader: provide description of file_open() Replace urban slang by proper description. Signed-off-by: Heinrich Schuchardt Signed-off-by: Alexander Graf --- diff --git a/lib/efi_loader/efi_file.c b/lib/efi_loader/efi_file.c index 92ca444617..9ba7673fb6 100644 --- a/lib/efi_loader/efi_file.c +++ b/lib/efi_loader/efi_file.c @@ -127,8 +127,18 @@ static int sanitize_path(char *path) return 0; } -/* NOTE: despite what you would expect, 'file_name' is actually a path. - * With windoze style backlashes, ofc. +/** + * file_open() - open a file handle + * + * @fs: file system + * @parent: directory relative to which the file is to be opened + * @file_name: path of the file to be opened. '\', '.', or '..' may + * be used as modifiers. A leading backslash indicates an + * absolute path. + * @mode: bit mask indicating the access mode (read, write, + * create) + * @attributes: attributes for newly created file + * Returns: handle to the opened file or NULL */ static struct efi_file_handle *file_open(struct file_system *fs, struct file_handle *parent, s16 *file_name, u64 mode,