man2type/open_how.2type

   1 .\" Copyright (c) 2022 by Alejandro Colomar <alx@kernel.org>
   2 .\"
   3 .\" SPDX-License-Identifier: Linux-man-pages-copyleft
   4 .\"
   5 .\"
   6 .TH open_how 2type (date) "Linux man-pages (unreleased)"
   7 .SH NAME
   8 open_how \- how to open a pathname
   9 .SH LIBRARY
  10 Linux kernel headers
  11 .SH SYNOPSIS
  12 .EX
  13 .B #include <linux/openat2.h>
  14 .P
  15 .B struct open_how {
  16 .BR "    u64  flags;" "    /* " O_ "* flags */"
  17 .BR "    u64  mode;" "     /* Mode for " O_ { CREAT , TMPFILE "} */"
  18 .BR "    u64  resolve;" "  /* " RESOLVE_ "* flags */"
  19     /* ... */
  20 .B };
  21 .EE
  22 .SH DESCRIPTION
  23 Specifies how a pathname should be opened.
  24 .P
  25 The fields are as follows:
  26 .TP
  27 .I flags
  28 This field specifies the file creation and file status flags
  29 to use when opening the file.
  30 .TP
  31 .I mode
  32 This field specifies the mode for the new file.
  33 .TP
  34 .I resolve
  35 This is a bit mask of flags that modify the way in which
  36 .I all
  37 components of a pathname will be resolved
  38 (see
  39 .BR path_resolution (7)
  40 for background information).
  41 .SH VERSIONS
  42 Extra fields may be appended to the structure,
  43 with a zero value in a new field resulting in
  44 the kernel behaving as though that extension field was not present.
  45 Therefore, a user
  46 .I must
  47 zero-fill this structure on initialization.
  48 .SH STANDARDS
  49 Linux.
  50 .SH SEE ALSO
  51 .BR openat2 (2)