Os.java revision 44f7875f2985d7944c5afecc8394ad9f2219c806
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 java.io.FileDescriptor; 20import java.net.InetAddress; 21import java.net.InetSocketAddress; 22import java.net.SocketAddress; 23import java.net.SocketException; 24import java.nio.ByteBuffer; 25import libcore.util.MutableInt; 26import libcore.util.MutableLong; 27 28public interface Os { 29 public FileDescriptor accept(FileDescriptor fd, InetSocketAddress peerAddress) throws ErrnoException, SocketException; 30 public boolean access(String path, int mode) throws ErrnoException; 31 public void bind(FileDescriptor fd, InetAddress address, int port) throws ErrnoException, SocketException; 32 public void chmod(String path, int mode) throws ErrnoException; 33 public void chown(String path, int uid, int gid) throws ErrnoException; 34 public void close(FileDescriptor fd) throws ErrnoException; 35 public void connect(FileDescriptor fd, InetAddress address, int port) throws ErrnoException, SocketException; 36 public FileDescriptor dup(FileDescriptor oldFd) throws ErrnoException; 37 public FileDescriptor dup2(FileDescriptor oldFd, int newFd) throws ErrnoException; 38 public String[] environ(); 39 public void fchmod(FileDescriptor fd, int mode) throws ErrnoException; 40 public void fchown(FileDescriptor fd, int uid, int gid) throws ErrnoException; 41 public int fcntlVoid(FileDescriptor fd, int cmd) throws ErrnoException; 42 public int fcntlLong(FileDescriptor fd, int cmd, long arg) throws ErrnoException; 43 public int fcntlFlock(FileDescriptor fd, int cmd, StructFlock arg) throws ErrnoException; 44 public void fdatasync(FileDescriptor fd) throws ErrnoException; 45 public StructStat fstat(FileDescriptor fd) throws ErrnoException; 46 public StructStatFs fstatfs(FileDescriptor fd) throws ErrnoException; 47 public void fsync(FileDescriptor fd) throws ErrnoException; 48 public void ftruncate(FileDescriptor fd, long length) throws ErrnoException; 49 public String gai_strerror(int error); 50 public InetAddress[] getaddrinfo(String node, StructAddrinfo hints) throws GaiException; 51 public int getegid(); 52 public int geteuid(); 53 public int getgid(); 54 public String getenv(String name); 55 /* TODO: break into getnameinfoHost and getnameinfoService? */ 56 public String getnameinfo(InetAddress address, int flags) throws GaiException; 57 public int getpid(); 58 public int getppid(); 59 public StructPasswd getpwnam(String name) throws ErrnoException; 60 public StructPasswd getpwuid(int uid) throws ErrnoException; 61 public SocketAddress getsockname(FileDescriptor fd) throws ErrnoException; 62 public int getsockoptByte(FileDescriptor fd, int level, int option) throws ErrnoException; 63 public InetAddress getsockoptInAddr(FileDescriptor fd, int level, int option) throws ErrnoException; 64 public int getsockoptInt(FileDescriptor fd, int level, int option) throws ErrnoException; 65 public StructLinger getsockoptLinger(FileDescriptor fd, int level, int option) throws ErrnoException; 66 public StructTimeval getsockoptTimeval(FileDescriptor fd, int level, int option) throws ErrnoException; 67 public int getuid(); 68 public String if_indextoname(int index); 69 public InetAddress inet_pton(int family, String address); 70 public InetAddress ioctlInetAddress(FileDescriptor fd, int cmd, String interfaceName) throws ErrnoException; 71 public int ioctlInt(FileDescriptor fd, int cmd, MutableInt arg) throws ErrnoException; 72 public boolean isatty(FileDescriptor fd); 73 public void kill(int pid, int signal) throws ErrnoException; 74 public void lchown(String path, int uid, int gid) throws ErrnoException; 75 public void listen(FileDescriptor fd, int backlog) throws ErrnoException; 76 public long lseek(FileDescriptor fd, long offset, int whence) throws ErrnoException; 77 public StructStat lstat(String path) throws ErrnoException; 78 public void mincore(long address, long byteCount, byte[] vector) throws ErrnoException; 79 public void mkdir(String path, int mode) throws ErrnoException; 80 public void mlock(long address, long byteCount) throws ErrnoException; 81 public long mmap(long address, long byteCount, int prot, int flags, FileDescriptor fd, long offset) throws ErrnoException; 82 public void msync(long address, long byteCount, int flags) throws ErrnoException; 83 public void munlock(long address, long byteCount) throws ErrnoException; 84 public void munmap(long address, long byteCount) throws ErrnoException; 85 public FileDescriptor open(String path, int flags, int mode) throws ErrnoException; 86 public FileDescriptor[] pipe() throws ErrnoException; 87 /* TODO: if we used the non-standard ppoll(2) behind the scenes, we could take a long timeout. */ 88 public int poll(StructPollfd[] fds, int timeoutMs) throws ErrnoException; 89 public int pread(FileDescriptor fd, ByteBuffer buffer, long offset) throws ErrnoException; 90 public int pread(FileDescriptor fd, byte[] bytes, int byteOffset, int byteCount, long offset) throws ErrnoException; 91 public int pwrite(FileDescriptor fd, ByteBuffer buffer, long offset) throws ErrnoException; 92 public int pwrite(FileDescriptor fd, byte[] bytes, int byteOffset, int byteCount, long offset) throws ErrnoException; 93 public int read(FileDescriptor fd, ByteBuffer buffer) throws ErrnoException; 94 public int read(FileDescriptor fd, byte[] bytes, int byteOffset, int byteCount) throws ErrnoException; 95 public int readv(FileDescriptor fd, Object[] buffers, int[] offsets, int[] byteCounts) throws ErrnoException; 96 public int recvfrom(FileDescriptor fd, ByteBuffer buffer, int flags, InetSocketAddress srcAddress) throws ErrnoException, SocketException; 97 public int recvfrom(FileDescriptor fd, byte[] bytes, int byteOffset, int byteCount, int flags, InetSocketAddress srcAddress) throws ErrnoException, SocketException; 98 public void remove(String path) throws ErrnoException; 99 public void rename(String oldPath, String newPath) throws ErrnoException; 100 public int sendto(FileDescriptor fd, ByteBuffer buffer, int flags, InetAddress inetAddress, int port) throws ErrnoException, SocketException; 101 public int sendto(FileDescriptor fd, byte[] bytes, int byteOffset, int byteCount, int flags, InetAddress inetAddress, int port) throws ErrnoException, SocketException; 102 public long sendfile(FileDescriptor outFd, FileDescriptor inFd, MutableLong inOffset, long byteCount) throws ErrnoException; 103 public void setegid(int egid) throws ErrnoException; 104 public void seteuid(int euid) throws ErrnoException; 105 public void setgid(int gid) throws ErrnoException; 106 public void setsockoptByte(FileDescriptor fd, int level, int option, int value) throws ErrnoException; 107 public void setsockoptIfreq(FileDescriptor fd, int level, int option, String value) throws ErrnoException; 108 public void setsockoptInt(FileDescriptor fd, int level, int option, int value) throws ErrnoException; 109 public void setsockoptIpMreqn(FileDescriptor fd, int level, int option, int value) throws ErrnoException; 110 public void setsockoptGroupReq(FileDescriptor fd, int level, int option, StructGroupReq value) throws ErrnoException; 111 public void setsockoptLinger(FileDescriptor fd, int level, int option, StructLinger value) throws ErrnoException; 112 public void setsockoptTimeval(FileDescriptor fd, int level, int option, StructTimeval value) throws ErrnoException; 113 public void setuid(int uid) throws ErrnoException; 114 public void shutdown(FileDescriptor fd, int how) throws ErrnoException; 115 public FileDescriptor socket(int domain, int type, int protocol) throws ErrnoException; 116 public StructStat stat(String path) throws ErrnoException; 117 /* TODO: replace statfs with statvfs. */ 118 public StructStatFs statfs(String path) throws ErrnoException; 119 public String strerror(int errno); 120 public void symlink(String oldPath, String newPath) throws ErrnoException; 121 public long sysconf(int name); 122 public int umask(int mask); 123 public StructUtsname uname(); 124 public int waitpid(int pid, MutableInt status, int options) throws ErrnoException; 125 public int write(FileDescriptor fd, ByteBuffer buffer) throws ErrnoException; 126 public int write(FileDescriptor fd, byte[] bytes, int byteOffset, int byteCount) throws ErrnoException; 127 public int writev(FileDescriptor fd, Object[] buffers, int[] offsets, int[] byteCounts) throws ErrnoException; 128} 129