/* Definitions for the filesystem interface. 
   Copyright (C) 1994 Free Software Foundation

This file is part of the GNU Hurd.

The GNU Hurd is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2, or (at your option)
any later version.

The GNU Hurd is distributed in the hope that it will be useful, 
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with the GNU Hurd; see the file COPYING.  If not, write to
the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.  */


/* All these objects also implement the generic IO facilities. */

subsystem fs 20000;

#include <hurd/hurd_types.defs>

#ifdef FILE_IMPORTS
FILE_IMPORTS
#endif

/* Operations supported on all files */

/* Overlay a task with a file.  Necessary initialization, including
   authentication changes associated with set[ug]id execution must be
   handled by the filesystem.  Filesystems normally implement this by
   using exec_newtask or exec_loadtask as appropriate.  */
INTR_ROUTINE (file_exec, (
	exec_file: file_t;
	exec_task: task_t;
	flags: int;
	argv: data_t;
	envp: data_t;
	fdarray: portarray_t;
	portarray: portarray_t;
	intarray: intarray_t;
	deallocnames: mach_port_name_array_t;
	destroynames: mach_port_name_array_t))

/* Change owner and/or group */
INTR_ROUTINE (file_chown, (
	chown_file: file_t;
	new_owner: uid_t;
	new_group: gid_t))

/*
Whan that Aprill with hith thoureth thoote
The droghte of March hath perthed to the roote,
And bathed every veyne in thwith licour,
Of which vertu engendred is the flour;
Whan Zephiruth eek with hith thweete breeth
Inthpired hath in every holt and heeth
The tender croppeth, and the yonge thonne
Hath in the Ram his halve courth yronne,
And thmale foweleth maken melodye,
That thlepen all the nyght with open ye
(Tho Priketh hem Nature in hir corageth),
Thanne longen folk to goon on pligrimageth,
And palmereth for to theken thtraunge thtrondeth,
To ferne halweth, kowthe in thondry londeth:
And thpethially, from every thireth ende
Of Engelond to Cantebury they wende,
The hooly blithful martyr for to theke,
That hem hath holpen whan that they were theeke.
*/
INTR_ROUTINE (file_chauthor, (
	chauth_file: file_t;
	new_author: uid_t))

/* Change mode bits */
INTR_ROUTINE (file_chmod, (
	chmod_file: file_t;
	new_mode: mode_t))

/* Change file flags */
INTR_ROUTINE (file_chflags, (
	chflags_file: file_t;
	new_flags: int))

/* Change access and modify times */
INTR_ROUTINE (file_utimes, (
	utimes_file: file_t;
	new_atime: time_value_t;
	new_mtime: time_value_t))

/* Truncate file */
INTR_ROUTINE (file_truncate, (
	trunc_file: file_t;
	new_size: off_t))

/* Apply/manipulate advisory lock */
INTR_ROUTINE (file_lock, (
	lock_file: file_t;
	flags: int))

/* Return current lock status.  Mystatus tells what kind of lock the
   caller has; otherstatus tells what kind of lock anyone has
   (including the caller).  */
routine file_lock_stat (
	lock_file: file_t;
	out mystatus: int;
	out otherstatus: int);

/* Find out what kind of access this file permits the current user
   (regardless of the current open modes for this port).  ALLOWED is a
   bitwise OR of O_READ, O_WRITE, and O_EXEC.  This is not necessarily the
   same as what an open or exec would allow; O_EXEC is set for root even if
   no executable bits are on (in which case file_exec should fail) and
   O_WRITE is set a directory can be modified, even though it can't be
   written directly.  */
routine file_check_access (
	file: file_t;
	out allowed: int);

/* Notice changes to file FILE.  Send notification messages (see
   msg.defs) to PORT as they occur. */
routine file_notice_changes (
	file: file_t;
	port: mach_port_send_t);

/* Return control port for this filesystem */
routine file_getcontrol (
	file: file_t;
	out control: mach_port_send_t);

/* Return filesystem status */
INTR_ROUTINE (file_statfs, (
	file: file_t;
	out info: fsys_statfsbuf_t))

/* Sync the individual file */
INTR_ROUTINE (file_sync, (
	file: file_t;
	wait: int))

/* Sync the entire filesystem */
INTR_ROUTINE (file_syncfs, (
	file: file_t;
	wait: int;
	do_children: int))

/* Return Posix.1 pathconf information */
INTR_ROUTINE (file_pathconf, (
	file: file_t;
	name: int;
	out value: int))

/* Return the node for hard links to this potentially translated file.
   This returns a potentially unauthenticated node.  */
routine file_getlinknode (
	file: file_t;
	out linknode: mach_port_send_t);

/* Return a file handle for this file.  This can be used by NFS and such.
   It is not guaranteed that this call will work...if it doesn't, then this
   filesystem cannot be NFS mounted.  */
routine file_getfh (
	file: file_t;
	out filehandle: data_t);

/* Operations supported on directories */

/* Translate a pathname, following all symlinks.  Upon return, if
   do_retry is FS_RETRY_NONE, then result is a port referencing the
   pathname's target.  If do_retry is FS_RETRY_NORMAL, then the call
   needs to be repeated.  If retry_name starts with a slash, then the
   new call needs to be made to the caller's root directory (without
   the leading slash).  If it does not start with a slash, then the
   new call needs to be made to result.  If do_retry is
   FS_RETRY_REAUTH, then the same procedure is followed as for
   FS_RETRY_NORMAL, except retry will need to be reauthenticated
   before use.  */
INTR_ROUTINE (dir_pathtrans, (
	start_dir: file_t;
	pathname: string_t;
	flags: int;
	mode: mode_t;
	out do_retry: retry_type;
	out retry_name: string_t;
	out result: mach_port_send_t))

/* Read entries from the directory.  Each entry is identified
   by an index number starting at 0 and running through the file.  This
   call fetches NENTRIES (or any convenient number if NENTRIES is -1)
   entries starting at ENTRY, returning an array of struct directs in DATA.
   The number of entries successfully read is returned in AMOUNT.  If ENTRY
   is bigger than the index of the last entry, then 0 is returned in
   AMOUNT.  If BUFSIZE is nonzero, never return more than BUFSIZE bytes of
   data regardless.  */
INTR_ROUTINE (dir_readdir, (
	dir: file_t;
	out data: data_t;
	entry: int;
	nentries: int;
	bufsiz: vm_size_t;
	out amount: int))

/* Create directory */
INTR_ROUTINE (dir_mkdir, (
	directory: file_t;
	name: string_t;
	mode: mode_t))

/* Remove directory */
INTR_ROUTINE (dir_rmdir, (
	directory: file_t;
	name: string_t))

/* Remove non-directory */
INTR_ROUTINE (dir_unlink, (
	directory: file_t;
	name: string_t))
 
/* Create a hard link.

   If OLDFILE and NEWDIRECTORY are not implemented by the same filesystem,
   EXDEV should be returned.  If the two filesystems, however can
   inter-operate and guarantee the appropriate Posix semantics, they can
   communicate by a private protocol and allow hard links between them.  */
INTR_ROUTINE (dir_link, (
	oldfile: file_t;
	newdirectory: file_t;
	newname: string_t))

/* Rename file -- comments similar to those for dir_link apply here
   about EXDEV. */
INTR_ROUTINE (dir_rename, (
	olddirectory: file_t;
	oldname: string_t;
	newdirectory: file_t;
	newname: string_t))

/* Create a new file without linking it into the filesystem.  You
   still must have write permission on the specified directory, even
   though it will not actually be written.  Return in *newnode a port
   to the file.  Flags are the same as for dir_pathtrans, but 
   O_CREAT and O_TRUNC are assumed even if not specified.  */
INTR_ROUTINE (dir_mkfile, (
	directory: file_t;
	flags: int;
	mode: mode_t;
	out newnode: mach_port_send_t))

/* Notice changes to directory DIR.  Send directory change notifications
   (see msg.defs) to PORT as they occur.  */
routine dir_notice_changes (
	directory: file_t;
	port: mach_port_send_t);

/* To get or set the translator currently running on a file, use
   file_set_translator, file_get_translator, or
   file_get_translator_cntl on a port gotten with the
   FS_LOOKUP_NOTRANS flag to dir_pathtrans.  You can send these RPCs
   to a port to a translated node (looked up without
   FS_LOOKUP_NOTRANS) to stack a new translator on top of the existing
   one.  */

/* Set a translator for future lookups to a file.  Any existing
   translator is sent an fsys_goaway message with the flags coming
   from oldtrans_flags.  Only if the old translator goes away will
   this call succeed.  If existing is not MACH_PORT_NULL, then there
   is already a translator for this file, and it should be used, with
   the program specified by NAME to be used only if the EXISTING port
   dies.  If TRANSLATOR is empty, then EXISTING is registered and the
   node becomes untranslated if EXISTING becomes dead.  If TRANSLATOR 
   is empty and EXISTING is null, then nothing happens.

   Some filesystems understand some translators directly and
   short-circuit the creation of the translator by the normal process.
   To prevent this optimization, set FS_TRANS_FORCE.  */
INTR_ROUTINE (file_set_translator, (
	file: file_t;
	flags: int;
	oldtrans_flags: int;
	translator: data_t;
	existing: mach_port_send_t))

/* Return the stored permanent translator for this file.  */
INTR_ROUTINE (file_get_translator, (
	file: file_t;
	out translator: data_t))

/* Return the translator control port to the
   active translator (if any) for this file.  */
INTR_ROUTINE (file_get_translator_cntl, (
	file: file_t;
	out translator_cntl: mach_port_send_t))

/* Activate FILE's translator if necessary, and open a port to it with
   FLAGS and retry protocol as for dir_pathtrans; if FLAGS contains
   O_NOTRANS, this will start the translator set on FILE, but circumvent
   the translator set on the resultant node.  */
INTR_ROUTINE (file_invoke_translator, (
	file: file_t;
	flags: int;
	out do_retry: retry_type;
	out retry_name: string_t;
	out result: mach_port_send_t))