Rewrite to allow omitting initialization of global variables.
[kopensolaris-gnu/glibc.git] / misc / mntent.h
1 /* Utilities for reading/writing fstab, mtab, etc.
2    Copyright (C) 1995, 1996, 1997, 1998 Free Software Foundation, Inc.
3    This file is part of the GNU C Library.
4
5    The GNU C Library is free software; you can redistribute it and/or
6    modify it under the terms of the GNU Library General Public License as
7    published by the Free Software Foundation; either version 2 of the
8    License, or (at your option) any later version.
9
10    The GNU C Library is distributed in the hope that it will be useful,
11    but WITHOUT ANY WARRANTY; without even the implied warranty of
12    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
13    Library General Public License for more details.
14
15    You should have received a copy of the GNU Library General Public
16    License along with the GNU C Library; see the file COPYING.LIB.  If not,
17    write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
18    Boston, MA 02111-1307, USA.  */
19
20 #ifndef _MNTENT_H
21 #define _MNTENT_H       1
22
23 #include <features.h>
24 #define __need_FILE
25 #include <stdio.h>
26 #include <paths.h>
27
28
29 /* File listing canonical interesting mount points.  */
30 #define MNTTAB          _PATH_MNTTAB    /* Deprecated alias.  */
31
32 /* File listing currently active mount points.  */
33 #define MOUNTED         _PATH_MOUNTED   /* Deprecated alias.  */
34
35
36 /* General filesystem types.  */
37 #define MNTTYPE_IGNORE  "ignore"        /* Ignore this entry.  */
38 #define MNTTYPE_NFS     "nfs"           /* Network file system.  */
39 #define MNTTYPE_SWAP    "swap"          /* Swap device.  */
40
41
42 /* Generic mount options.  */
43 #define MNTOPT_DEFAULTS "defaults"      /* Use all default options.  */
44 #define MNTOPT_RO       "ro"            /* Read only.  */
45 #define MNTOPT_RW       "rw"            /* Read/write.  */
46 #define MNTOPT_SUID     "suid"          /* Set uid allowed.  */
47 #define MNTOPT_NOSUID   "nosuid"        /* No set uid allowed.  */
48 #define MNTOPT_NOAUTO   "noauto"        /* Do not auto mount.  */
49
50
51 __BEGIN_DECLS
52
53 /* Structure describing a mount table entry.  */
54 struct mntent
55   {
56     char *mnt_fsname;           /* Device or server for filesystem.  */
57     char *mnt_dir;              /* Directory mounted on.  */
58     char *mnt_type;             /* Type of filesystem: ufs, nfs, etc.  */
59     char *mnt_opts;             /* Comma-separated options for fs.  */
60     int mnt_freq;               /* Dump frequency (in days).  */
61     int mnt_passno;             /* Pass number for `fsck'.  */
62   };
63
64
65 /* Prepare to begin reading and/or writing mount table entries from the
66    beginning of FILE.  MODE is as for `fopen'.  */
67 extern FILE *setmntent __P ((__const char *__file, __const char *__mode));
68
69 /* Read one mount table entry from STREAM.  Returns a pointer to storage
70    reused on the next call, or null for EOF or error (use feof/ferror to
71    check).  */
72 extern struct mntent *getmntent __P ((FILE *__stream));
73
74 #ifdef __USE_MISC
75 /* Reentrant version of the above function.  */
76 extern struct mntent *getmntent_r __P ((FILE *__restrict __stream,
77                                         struct mntent *__restrict __result,
78                                         char *__restrict __buffer,
79                                         int __bufsize));
80 #endif
81
82 /* Write the mount table entry described by MNT to STREAM.
83    Return zero on success, nonzero on failure.  */
84 extern int addmntent __P ((FILE *__restrict __stream,
85                            __const struct mntent *__restrict __mnt));
86
87 /* Close a stream opened with `setmntent'.  */
88 extern int endmntent __P ((FILE *__stream));
89
90 /* Search MNT->mnt_opts for an option matching OPT.
91    Returns the address of the substring, or null if none found.  */
92 extern char *hasmntopt __P ((__const struct mntent *__mnt,
93                              __const char *__opt));
94
95
96 __END_DECLS
97
98 #endif  /* mntent.h */