summaryrefslogtreecommitdiff
path: root/devio/open.h
diff options
context:
space:
mode:
authorMiles Bader <miles@gnu.org>1995-04-05 00:54:58 +0000
committerMiles Bader <miles@gnu.org>1995-04-05 00:54:58 +0000
commit28630f6da0ab09f1a87852b7221f7b99bc2ef21c (patch)
treebbec9dc8f3c59b5dba5f7f9ef48a524d916923b7 /devio/open.h
parent5360e84d14494a6bc105edca255dcd3afe327848 (diff)
Initial revision
Diffstat (limited to 'devio/open.h')
-rw-r--r--devio/open.h67
1 files changed, 67 insertions, 0 deletions
diff --git a/devio/open.h b/devio/open.h
new file mode 100644
index 00000000..c202d9ed
--- /dev/null
+++ b/devio/open.h
@@ -0,0 +1,67 @@
+/* Per-open information for devio.
+
+ Copyright (C) 1995 Free Software Foundation, Inc.
+
+ Written by Miles Bader <miles@gnu.ai.mit.edu>
+
+ This program 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.
+
+ This program 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 this program; if not, write to the Free Software
+ Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. */
+
+#ifndef __OPEN_H__
+#define __OPEN_H__
+
+#include "iostate.h"
+
+/* ---------------------------------------------------------------- */
+
+/* A structure describing a particular i/o stream on this device. */
+struct open
+{
+ /* Current state of our output stream -- location and the buffer used to do
+ buffered i/o. */
+ struct io_state io_state;
+
+ /* The memory window we're using to do i/o. This may be NULL, indicating
+ we're not doing buffered random access i/o. */
+ struct window *window;
+
+ /* The device that this an open on. */
+ struct dev *dev;
+};
+
+/* Returns a new per-open structure for the device DEV in OPEN. If an error
+ occurs, the error-code is returned, otherwise 0. */
+error_t open_create(struct dev *dev, struct open **open);
+
+/* Free OPEN and any resources it holds. */
+void open_free(struct open *open);
+
+/* Returns the appropiate io_state object for OPEN (which may be either
+ per-open or a per-device depending on the device). */
+struct io_state *open_get_io_state(struct open *open);
+
+/* Writes up to LEN bytes from BUF to OPEN's device at device offset OFFS
+ (which may be ignored if the device doesn't support random access),
+ and returns the number of bytes written in AMOUNT. If no error occurs,
+ zero is returned, otherwise the error code is returned. */
+error_t open_write(struct open *open, vm_address_t buf, vm_size_t len,
+ vm_size_t *amount, off_t offs);
+
+/* Reads up to AMOUNT bytes from the device into BUF and BUF_LEN using the
+ standard mach out-array convention. If no error occurs, zero is returned,
+ otherwise the error code is returned. */
+error_t open_read(struct open *open, vm_address_t *buf, vm_size_t *buf_len,
+ vm_size_t amount, off_t offs);
+
+#endif /* !__OPEN_H__ */