1/*
2 * Copyright (C) 2011 The Android Open Source Project
3 *
4 * Licensed under the Apache License, Version 2.0 (the "License");
5 * you may not use this file except in compliance with the License.
6 * You may obtain a copy of the License at
7 *
8 *      http://www.apache.org/licenses/LICENSE-2.0
9 *
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 * See the License for the specific language governing permissions and
14 * limitations under the License.
15 */
16
17package libcore.io;
18
19import android.system.ErrnoException;
20import android.system.GaiException;
21import android.system.StructAddrinfo;
22import android.system.StructFlock;
23import android.system.StructGroupReq;
24import android.system.StructGroupSourceReq;
25import android.system.StructLinger;
26import android.system.StructPasswd;
27import android.system.StructPollfd;
28import android.system.StructStat;
29import android.system.StructStatVfs;
30import android.system.StructTimeval;
31import android.system.StructUcred;
32import android.system.StructUtsname;
33import android.util.MutableInt;
34import android.util.MutableLong;
35import java.io.FileDescriptor;
36import java.io.InterruptedIOException;
37import java.net.InetAddress;
38import java.net.InetSocketAddress;
39import java.net.SocketAddress;
40import java.net.SocketException;
41import java.nio.ByteBuffer;
42
43public interface Os {
44    public FileDescriptor accept(FileDescriptor fd, InetSocketAddress peerAddress) throws ErrnoException, SocketException;
45    public boolean access(String path, int mode) throws ErrnoException;
46    public InetAddress[] android_getaddrinfo(String node, StructAddrinfo hints, int netId) throws GaiException;
47    public void bind(FileDescriptor fd, InetAddress address, int port) throws ErrnoException, SocketException;
48    public void bind(FileDescriptor fd, SocketAddress address) throws ErrnoException, SocketException;
49    public void chmod(String path, int mode) throws ErrnoException;
50    public void chown(String path, int uid, int gid) throws ErrnoException;
51    public void close(FileDescriptor fd) throws ErrnoException;
52    public void connect(FileDescriptor fd, InetAddress address, int port) throws ErrnoException, SocketException;
53    public void connect(FileDescriptor fd, SocketAddress address) throws ErrnoException, SocketException;
54    public FileDescriptor dup(FileDescriptor oldFd) throws ErrnoException;
55    public FileDescriptor dup2(FileDescriptor oldFd, int newFd) throws ErrnoException;
56    public String[] environ();
57    public void execv(String filename, String[] argv) throws ErrnoException;
58    public void execve(String filename, String[] argv, String[] envp) throws ErrnoException;
59    public void fchmod(FileDescriptor fd, int mode) throws ErrnoException;
60    public void fchown(FileDescriptor fd, int uid, int gid) throws ErrnoException;
61    public int fcntlFlock(FileDescriptor fd, int cmd, StructFlock arg) throws ErrnoException, InterruptedIOException;
62    public int fcntlInt(FileDescriptor fd, int cmd, int arg) throws ErrnoException;
63    public int fcntlVoid(FileDescriptor fd, int cmd) throws ErrnoException;
64    public void fdatasync(FileDescriptor fd) throws ErrnoException;
65    public StructStat fstat(FileDescriptor fd) throws ErrnoException;
66    public StructStatVfs fstatvfs(FileDescriptor fd) throws ErrnoException;
67    public void fsync(FileDescriptor fd) throws ErrnoException;
68    public void ftruncate(FileDescriptor fd, long length) throws ErrnoException;
69    public String gai_strerror(int error);
70    public int getegid();
71    public int geteuid();
72    public int getgid();
73    public String getenv(String name);
74    /* TODO: break into getnameinfoHost and getnameinfoService? */
75    public String getnameinfo(InetAddress address, int flags) throws GaiException;
76    public SocketAddress getpeername(FileDescriptor fd) throws ErrnoException;
77    public int getpgid(int pid) throws ErrnoException;
78    public int getpid();
79    public int getppid();
80    public StructPasswd getpwnam(String name) throws ErrnoException;
81    public StructPasswd getpwuid(int uid) throws ErrnoException;
82    public SocketAddress getsockname(FileDescriptor fd) throws ErrnoException;
83    public int getsockoptByte(FileDescriptor fd, int level, int option) throws ErrnoException;
84    public InetAddress getsockoptInAddr(FileDescriptor fd, int level, int option) throws ErrnoException;
85    public int getsockoptInt(FileDescriptor fd, int level, int option) throws ErrnoException;
86    public StructLinger getsockoptLinger(FileDescriptor fd, int level, int option) throws ErrnoException;
87    public StructTimeval getsockoptTimeval(FileDescriptor fd, int level, int option) throws ErrnoException;
88    public StructUcred getsockoptUcred(FileDescriptor fd, int level, int option) throws ErrnoException;
89    public int gettid();
90    public int getuid();
91    public int getxattr(String path, String name, byte[] outValue) throws ErrnoException;
92    public String if_indextoname(int index);
93    public InetAddress inet_pton(int family, String address);
94    public InetAddress ioctlInetAddress(FileDescriptor fd, int cmd, String interfaceName) throws ErrnoException;
95    public int ioctlInt(FileDescriptor fd, int cmd, MutableInt arg) throws ErrnoException;
96    public boolean isatty(FileDescriptor fd);
97    public void kill(int pid, int signal) throws ErrnoException;
98    public void lchown(String path, int uid, int gid) throws ErrnoException;
99    public void link(String oldPath, String newPath) throws ErrnoException;
100    public void listen(FileDescriptor fd, int backlog) throws ErrnoException;
101    public long lseek(FileDescriptor fd, long offset, int whence) throws ErrnoException;
102    public StructStat lstat(String path) throws ErrnoException;
103    public void mincore(long address, long byteCount, byte[] vector) throws ErrnoException;
104    public void mkdir(String path, int mode) throws ErrnoException;
105    public void mkfifo(String path, int mode) throws ErrnoException;
106    public void mlock(long address, long byteCount) throws ErrnoException;
107    public long mmap(long address, long byteCount, int prot, int flags, FileDescriptor fd, long offset) throws ErrnoException;
108    public void msync(long address, long byteCount, int flags) throws ErrnoException;
109    public void munlock(long address, long byteCount) throws ErrnoException;
110    public void munmap(long address, long byteCount) throws ErrnoException;
111    public FileDescriptor open(String path, int flags, int mode) throws ErrnoException;
112    public FileDescriptor[] pipe2(int flags) throws ErrnoException;
113    /* TODO: if we used the non-standard ppoll(2) behind the scenes, we could take a long timeout. */
114    public int poll(StructPollfd[] fds, int timeoutMs) throws ErrnoException;
115    public void posix_fallocate(FileDescriptor fd, long offset, long length) throws ErrnoException;
116    public int prctl(int option, long arg2, long arg3, long arg4, long arg5) throws ErrnoException;
117    public int pread(FileDescriptor fd, ByteBuffer buffer, long offset) throws ErrnoException, InterruptedIOException;
118    public int pread(FileDescriptor fd, byte[] bytes, int byteOffset, int byteCount, long offset) throws ErrnoException, InterruptedIOException;
119    public int pwrite(FileDescriptor fd, ByteBuffer buffer, long offset) throws ErrnoException, InterruptedIOException;
120    public int pwrite(FileDescriptor fd, byte[] bytes, int byteOffset, int byteCount, long offset) throws ErrnoException, InterruptedIOException;
121    public int read(FileDescriptor fd, ByteBuffer buffer) throws ErrnoException, InterruptedIOException;
122    public int read(FileDescriptor fd, byte[] bytes, int byteOffset, int byteCount) throws ErrnoException, InterruptedIOException;
123    public String readlink(String path) throws ErrnoException;
124    public int readv(FileDescriptor fd, Object[] buffers, int[] offsets, int[] byteCounts) throws ErrnoException, InterruptedIOException;
125    public int recvfrom(FileDescriptor fd, ByteBuffer buffer, int flags, InetSocketAddress srcAddress) throws ErrnoException, SocketException;
126    public int recvfrom(FileDescriptor fd, byte[] bytes, int byteOffset, int byteCount, int flags, InetSocketAddress srcAddress) throws ErrnoException, SocketException;
127    public void remove(String path) throws ErrnoException;
128    public void removexattr(String path, String name) throws ErrnoException;
129    public void rename(String oldPath, String newPath) throws ErrnoException;
130    public int sendto(FileDescriptor fd, ByteBuffer buffer, int flags, InetAddress inetAddress, int port) throws ErrnoException, SocketException;
131    public int sendto(FileDescriptor fd, byte[] bytes, int byteOffset, int byteCount, int flags, InetAddress inetAddress, int port) throws ErrnoException, SocketException;
132    public int sendto(FileDescriptor fd, byte[] bytes, int byteOffset, int byteCount, int flags, SocketAddress address) throws ErrnoException, SocketException;
133    public long sendfile(FileDescriptor outFd, FileDescriptor inFd, MutableLong inOffset, long byteCount) throws ErrnoException;
134    public void setegid(int egid) throws ErrnoException;
135    public void setenv(String name, String value, boolean overwrite) throws ErrnoException;
136    public void seteuid(int euid) throws ErrnoException;
137    public void setgid(int gid) throws ErrnoException;
138    public void setpgid(int pid, int pgid) throws ErrnoException;
139    public void setregid(int rgid, int egid) throws ErrnoException;
140    public void setreuid(int ruid, int euid) throws ErrnoException;
141    public int setsid() throws ErrnoException;
142    public void setsockoptByte(FileDescriptor fd, int level, int option, int value) throws ErrnoException;
143    public void setsockoptIfreq(FileDescriptor fd, int level, int option, String value) throws ErrnoException;
144    public void setsockoptInt(FileDescriptor fd, int level, int option, int value) throws ErrnoException;
145    public void setsockoptIpMreqn(FileDescriptor fd, int level, int option, int value) throws ErrnoException;
146    public void setsockoptGroupReq(FileDescriptor fd, int level, int option, StructGroupReq value) throws ErrnoException;
147    public void setsockoptGroupSourceReq(FileDescriptor fd, int level, int option, StructGroupSourceReq value) throws ErrnoException;
148    public void setsockoptLinger(FileDescriptor fd, int level, int option, StructLinger value) throws ErrnoException;
149    public void setsockoptTimeval(FileDescriptor fd, int level, int option, StructTimeval value) throws ErrnoException;
150    public void setuid(int uid) throws ErrnoException;
151    public void setxattr(String path, String name, byte[] value, int flags) throws ErrnoException;
152    public void shutdown(FileDescriptor fd, int how) throws ErrnoException;
153    public FileDescriptor socket(int domain, int type, int protocol) throws ErrnoException;
154    public void socketpair(int domain, int type, int protocol, FileDescriptor fd1, FileDescriptor fd2) throws ErrnoException;
155    public StructStat stat(String path) throws ErrnoException;
156    public StructStatVfs statvfs(String path) throws ErrnoException;
157    public String strerror(int errno);
158    public String strsignal(int signal);
159    public void symlink(String oldPath, String newPath) throws ErrnoException;
160    public long sysconf(int name);
161    public void tcdrain(FileDescriptor fd) throws ErrnoException;
162    public void tcsendbreak(FileDescriptor fd, int duration) throws ErrnoException;
163    public int umask(int mask);
164    public StructUtsname uname();
165    public void unsetenv(String name) throws ErrnoException;
166    public int waitpid(int pid, MutableInt status, int options) throws ErrnoException;
167    public int write(FileDescriptor fd, ByteBuffer buffer) throws ErrnoException, InterruptedIOException;
168    public int write(FileDescriptor fd, byte[] bytes, int byteOffset, int byteCount) throws ErrnoException, InterruptedIOException;
169    public int writev(FileDescriptor fd, Object[] buffers, int[] offsets, int[] byteCounts) throws ErrnoException, InterruptedIOException;
170}
171