1ec617e2cb4a374f0fd8fbda4a633214cf23a59a9Elliott Hughes/* 2ec617e2cb4a374f0fd8fbda4a633214cf23a59a9Elliott Hughes * Copyright (C) 2011 The Android Open Source Project 3ec617e2cb4a374f0fd8fbda4a633214cf23a59a9Elliott Hughes * 4ec617e2cb4a374f0fd8fbda4a633214cf23a59a9Elliott Hughes * Licensed under the Apache License, Version 2.0 (the "License"); 5ec617e2cb4a374f0fd8fbda4a633214cf23a59a9Elliott Hughes * you may not use this file except in compliance with the License. 6ec617e2cb4a374f0fd8fbda4a633214cf23a59a9Elliott Hughes * You may obtain a copy of the License at 7ec617e2cb4a374f0fd8fbda4a633214cf23a59a9Elliott Hughes * 8ec617e2cb4a374f0fd8fbda4a633214cf23a59a9Elliott Hughes * http://www.apache.org/licenses/LICENSE-2.0 9ec617e2cb4a374f0fd8fbda4a633214cf23a59a9Elliott Hughes * 10ec617e2cb4a374f0fd8fbda4a633214cf23a59a9Elliott Hughes * Unless required by applicable law or agreed to in writing, software 11ec617e2cb4a374f0fd8fbda4a633214cf23a59a9Elliott Hughes * distributed under the License is distributed on an "AS IS" BASIS, 12ec617e2cb4a374f0fd8fbda4a633214cf23a59a9Elliott Hughes * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13ec617e2cb4a374f0fd8fbda4a633214cf23a59a9Elliott Hughes * See the License for the specific language governing permissions and 14ec617e2cb4a374f0fd8fbda4a633214cf23a59a9Elliott Hughes * limitations under the License. 15ec617e2cb4a374f0fd8fbda4a633214cf23a59a9Elliott Hughes */ 16ec617e2cb4a374f0fd8fbda4a633214cf23a59a9Elliott Hughes 17ec617e2cb4a374f0fd8fbda4a633214cf23a59a9Elliott Hughespackage libcore.io; 18ec617e2cb4a374f0fd8fbda4a633214cf23a59a9Elliott Hughes 195d930cadc8f62aee5f18e7921296fe66a54f18abElliott Hughesimport android.system.ErrnoException; 205d930cadc8f62aee5f18e7921296fe66a54f18abElliott Hughesimport android.system.GaiException; 215d930cadc8f62aee5f18e7921296fe66a54f18abElliott Hughesimport android.system.StructAddrinfo; 225d930cadc8f62aee5f18e7921296fe66a54f18abElliott Hughesimport android.system.StructFlock; 235d930cadc8f62aee5f18e7921296fe66a54f18abElliott Hughesimport android.system.StructGroupReq; 245d930cadc8f62aee5f18e7921296fe66a54f18abElliott Hughesimport android.system.StructGroupSourceReq; 255d930cadc8f62aee5f18e7921296fe66a54f18abElliott Hughesimport android.system.StructLinger; 265d930cadc8f62aee5f18e7921296fe66a54f18abElliott Hughesimport android.system.StructPasswd; 275d930cadc8f62aee5f18e7921296fe66a54f18abElliott Hughesimport android.system.StructPollfd; 285d930cadc8f62aee5f18e7921296fe66a54f18abElliott Hughesimport android.system.StructStat; 295d930cadc8f62aee5f18e7921296fe66a54f18abElliott Hughesimport android.system.StructStatVfs; 305d930cadc8f62aee5f18e7921296fe66a54f18abElliott Hughesimport android.system.StructTimeval; 315d930cadc8f62aee5f18e7921296fe66a54f18abElliott Hughesimport android.system.StructUcred; 325d930cadc8f62aee5f18e7921296fe66a54f18abElliott Hughesimport android.system.StructUtsname; 335d930cadc8f62aee5f18e7921296fe66a54f18abElliott Hughesimport android.util.MutableInt; 345d930cadc8f62aee5f18e7921296fe66a54f18abElliott Hughesimport android.util.MutableLong; 3552724d3ebd4ccaaa4b9f5576e329d4272cde8ea9Elliott Hughesimport java.io.FileDescriptor; 36f0d40d662d9dfdb04215c718961765837d2cf00cNeil Fullerimport java.io.InterruptedIOException; 370a9d1ee45a9884a9616624d747172e18734e8fe0Elliott Hughesimport java.net.InetAddress; 3823ec09188303a874b3b391f96ae0a29af002bff9Elliott Hughesimport java.net.InetSocketAddress; 390a9d1ee45a9884a9616624d747172e18734e8fe0Elliott Hughesimport java.net.SocketAddress; 4026010ab930a2cee3bf10b9612cf070183c21228bElliott Hughesimport java.net.SocketException; 4126c7025a7a919044771fb89031161bd26fe03032Elliott Hughesimport java.nio.ByteBuffer; 4252724d3ebd4ccaaa4b9f5576e329d4272cde8ea9Elliott Hughes 43ec617e2cb4a374f0fd8fbda4a633214cf23a59a9Elliott Hughespublic interface Os { 4426010ab930a2cee3bf10b9612cf070183c21228bElliott Hughes public FileDescriptor accept(FileDescriptor fd, InetSocketAddress peerAddress) throws ErrnoException, SocketException; 45ddfdbb9d172fe9b72e08e8d7deab0aa3b8acf044Elliott Hughes public boolean access(String path, int mode) throws ErrnoException; 463e58734d651080009c9190c7062837fca5c7cf4ePaul Jensen public InetAddress[] android_getaddrinfo(String node, StructAddrinfo hints, int netId) throws GaiException; 4726010ab930a2cee3bf10b9612cf070183c21228bElliott Hughes public void bind(FileDescriptor fd, InetAddress address, int port) throws ErrnoException, SocketException; 48b7190190e0ef8de883c952efb319ce7748831faaElliott Hughes public void chmod(String path, int mode) throws ErrnoException; 4944f7875f2985d7944c5afecc8394ad9f2219c806Elliott Hughes public void chown(String path, int uid, int gid) throws ErrnoException; 50462bdac45c10f43d88d8f07f6994e272a27c14a2Elliott Hughes public void close(FileDescriptor fd) throws ErrnoException; 5126010ab930a2cee3bf10b9612cf070183c21228bElliott Hughes public void connect(FileDescriptor fd, InetAddress address, int port) throws ErrnoException, SocketException; 52396a9c666da353b910b515d12eb1c43adfddb0c8Elliott Hughes public FileDescriptor dup(FileDescriptor oldFd) throws ErrnoException; 53396a9c666da353b910b515d12eb1c43adfddb0c8Elliott Hughes public FileDescriptor dup2(FileDescriptor oldFd, int newFd) throws ErrnoException; 54ddfdbb9d172fe9b72e08e8d7deab0aa3b8acf044Elliott Hughes public String[] environ(); 55798f855f67b74d481346d9dc2293ba0eedd8daf9Nick Kralevich public void execv(String filename, String[] argv) throws ErrnoException; 56798f855f67b74d481346d9dc2293ba0eedd8daf9Nick Kralevich public void execve(String filename, String[] argv, String[] envp) throws ErrnoException; 5744f7875f2985d7944c5afecc8394ad9f2219c806Elliott Hughes public void fchmod(FileDescriptor fd, int mode) throws ErrnoException; 5844f7875f2985d7944c5afecc8394ad9f2219c806Elliott Hughes public void fchown(FileDescriptor fd, int uid, int gid) throws ErrnoException; 59fc549a0b0388987b26dea524894d75a63d14783bElliott Hughes public int fcntlVoid(FileDescriptor fd, int cmd) throws ErrnoException; 60fc549a0b0388987b26dea524894d75a63d14783bElliott Hughes public int fcntlLong(FileDescriptor fd, int cmd, long arg) throws ErrnoException; 611791f6be1bd2733babb0c862ad8509f4c847b48fNeil Fuller public int fcntlFlock(FileDescriptor fd, int cmd, StructFlock arg) throws ErrnoException, InterruptedIOException; 6252724d3ebd4ccaaa4b9f5576e329d4272cde8ea9Elliott Hughes public void fdatasync(FileDescriptor fd) throws ErrnoException; 6347cb338d43f75dd998b29caaaa9446c5705217d1Elliott Hughes public StructStat fstat(FileDescriptor fd) throws ErrnoException; 64721ceca2a52a3c27aa751476c8562e1e68088e15Elliott Hughes public StructStatVfs fstatvfs(FileDescriptor fd) throws ErrnoException; 6552724d3ebd4ccaaa4b9f5576e329d4272cde8ea9Elliott Hughes public void fsync(FileDescriptor fd) throws ErrnoException; 66f5333fd2094bdac4d6506177b1964b79afa64d77Elliott Hughes public void ftruncate(FileDescriptor fd, long length) throws ErrnoException; 674f11ebea266eada830d507b8f011e811a8e5d7bcElliott Hughes public String gai_strerror(int error); 68396a9c666da353b910b515d12eb1c43adfddb0c8Elliott Hughes public int getegid(); 69396a9c666da353b910b515d12eb1c43adfddb0c8Elliott Hughes public int geteuid(); 70396a9c666da353b910b515d12eb1c43adfddb0c8Elliott Hughes public int getgid(); 71ec617e2cb4a374f0fd8fbda4a633214cf23a59a9Elliott Hughes public String getenv(String name); 724f11ebea266eada830d507b8f011e811a8e5d7bcElliott Hughes /* TODO: break into getnameinfoHost and getnameinfoService? */ 734f11ebea266eada830d507b8f011e811a8e5d7bcElliott Hughes public String getnameinfo(InetAddress address, int flags) throws GaiException; 74482a3fc5635ac431b8a7476d7fe3397af4c2e8ecElliott Hughes public SocketAddress getpeername(FileDescriptor fd) throws ErrnoException; 75396a9c666da353b910b515d12eb1c43adfddb0c8Elliott Hughes public int getpid(); 76396a9c666da353b910b515d12eb1c43adfddb0c8Elliott Hughes public int getppid(); 77d4419fce71d11ec8494525eca65e54d1aab51de6Elliott Hughes public StructPasswd getpwnam(String name) throws ErrnoException; 78d4419fce71d11ec8494525eca65e54d1aab51de6Elliott Hughes public StructPasswd getpwuid(int uid) throws ErrnoException; 790a9d1ee45a9884a9616624d747172e18734e8fe0Elliott Hughes public SocketAddress getsockname(FileDescriptor fd) throws ErrnoException; 800a9d1ee45a9884a9616624d747172e18734e8fe0Elliott Hughes public int getsockoptByte(FileDescriptor fd, int level, int option) throws ErrnoException; 810a9d1ee45a9884a9616624d747172e18734e8fe0Elliott Hughes public InetAddress getsockoptInAddr(FileDescriptor fd, int level, int option) throws ErrnoException; 820a9d1ee45a9884a9616624d747172e18734e8fe0Elliott Hughes public int getsockoptInt(FileDescriptor fd, int level, int option) throws ErrnoException; 830a9d1ee45a9884a9616624d747172e18734e8fe0Elliott Hughes public StructLinger getsockoptLinger(FileDescriptor fd, int level, int option) throws ErrnoException; 840a9d1ee45a9884a9616624d747172e18734e8fe0Elliott Hughes public StructTimeval getsockoptTimeval(FileDescriptor fd, int level, int option) throws ErrnoException; 85482a3fc5635ac431b8a7476d7fe3397af4c2e8ecElliott Hughes public StructUcred getsockoptUcred(FileDescriptor fd, int level, int option) throws ErrnoException; 86069525a39125c203b658c805685b6045a7d4dfebElliott Hughes public int gettid(); 87396a9c666da353b910b515d12eb1c43adfddb0c8Elliott Hughes public int getuid(); 88a37e971343883bb582a93ffbd9f0ba84f10e55baElliott Hughes public String if_indextoname(int index); 89fc041ff241f9a7556e72236f130de0215ecd17dbElliott Hughes public InetAddress inet_pton(int family, String address); 90a37e971343883bb582a93ffbd9f0ba84f10e55baElliott Hughes public InetAddress ioctlInetAddress(FileDescriptor fd, int cmd, String interfaceName) throws ErrnoException; 918b15dcc5890963edad4dfcf558cc16027c7985e5Elliott Hughes public int ioctlInt(FileDescriptor fd, int cmd, MutableInt arg) throws ErrnoException; 929a3f363523000704205df288f8b6f2f48c0d8563Elliott Hughes public boolean isatty(FileDescriptor fd); 93a5fb706fe4a6dbeaaf4cb1f8bbc2c68b0a2a3f3cElliott Hughes public void kill(int pid, int signal) throws ErrnoException; 9444f7875f2985d7944c5afecc8394ad9f2219c806Elliott Hughes public void lchown(String path, int uid, int gid) throws ErrnoException; 9504428d61d7000e17ab21d08a1d672c34eb68f6e2Elliott Hughes public void link(String oldPath, String newPath) throws ErrnoException; 96e1502d64e937001636fca3d62b2552ef2a34d05fElliott Hughes public void listen(FileDescriptor fd, int backlog) throws ErrnoException; 97dedaccdfa07c370a58cba08b096133ad9eec0ec3Elliott Hughes public long lseek(FileDescriptor fd, long offset, int whence) throws ErrnoException; 98e3b6fa2bf357f2712ab2ee9e8487f157595ea0c7Elliott Hughes public StructStat lstat(String path) throws ErrnoException; 990f746ff511162add42eeabaf14ba70ace874c6f4Elliott Hughes public void mincore(long address, long byteCount, byte[] vector) throws ErrnoException; 100c7fa20701d5e9398c38f4615ed293acfce1c0cf6Elliott Hughes public void mkdir(String path, int mode) throws ErrnoException; 101f0d40d662d9dfdb04215c718961765837d2cf00cNeil Fuller public void mkfifo(String path, int mode) throws ErrnoException; 1027e13c0f05ac9e7c55682d10e953dd4cbd5e6107cElliott Hughes public void mlock(long address, long byteCount) throws ErrnoException; 1037e25eff38a191d9c19e45093f4fde5102fb09d78Elliott Hughes public long mmap(long address, long byteCount, int prot, int flags, FileDescriptor fd, long offset) throws ErrnoException; 1047e25eff38a191d9c19e45093f4fde5102fb09d78Elliott Hughes public void msync(long address, long byteCount, int flags) throws ErrnoException; 1057e13c0f05ac9e7c55682d10e953dd4cbd5e6107cElliott Hughes public void munlock(long address, long byteCount) throws ErrnoException; 1067e25eff38a191d9c19e45093f4fde5102fb09d78Elliott Hughes public void munmap(long address, long byteCount) throws ErrnoException; 1070ac77ac8e915bff1a863e371f9b363033f9cf759Elliott Hughes public FileDescriptor open(String path, int flags, int mode) throws ErrnoException; 10841f0605d2c809bd9bc1c0fb68d86b49a0f59b6c5Elliott Hughes public FileDescriptor[] pipe() throws ErrnoException; 10970c820401677ca251ad09ac64cc23c760764e75dElliott Hughes /* TODO: if we used the non-standard ppoll(2) behind the scenes, we could take a long timeout. */ 11070c820401677ca251ad09ac64cc23c760764e75dElliott Hughes public int poll(StructPollfd[] fds, int timeoutMs) throws ErrnoException; 11111f07d30d2e344b48f132ec6ed105d85423052c2Elliott Hughes public void posix_fallocate(FileDescriptor fd, long offset, long length) throws ErrnoException; 1125215e4c0db7530519981f1e505e6db82401802f2Nick Kralevich public int prctl(int option, long arg2, long arg3, long arg4, long arg5) throws ErrnoException; 113f0d40d662d9dfdb04215c718961765837d2cf00cNeil Fuller public int pread(FileDescriptor fd, ByteBuffer buffer, long offset) throws ErrnoException, InterruptedIOException; 114f0d40d662d9dfdb04215c718961765837d2cf00cNeil Fuller public int pread(FileDescriptor fd, byte[] bytes, int byteOffset, int byteCount, long offset) throws ErrnoException, InterruptedIOException; 115f0d40d662d9dfdb04215c718961765837d2cf00cNeil Fuller public int pwrite(FileDescriptor fd, ByteBuffer buffer, long offset) throws ErrnoException, InterruptedIOException; 116f0d40d662d9dfdb04215c718961765837d2cf00cNeil Fuller public int pwrite(FileDescriptor fd, byte[] bytes, int byteOffset, int byteCount, long offset) throws ErrnoException, InterruptedIOException; 117f0d40d662d9dfdb04215c718961765837d2cf00cNeil Fuller public int read(FileDescriptor fd, ByteBuffer buffer) throws ErrnoException, InterruptedIOException; 118f0d40d662d9dfdb04215c718961765837d2cf00cNeil Fuller public int read(FileDescriptor fd, byte[] bytes, int byteOffset, int byteCount) throws ErrnoException, InterruptedIOException; 1190b6b3e10459fc3a3f4dd280dab8d4a145f7bf2f0Elliott Hughes public String readlink(String path) throws ErrnoException; 120f0d40d662d9dfdb04215c718961765837d2cf00cNeil Fuller public int readv(FileDescriptor fd, Object[] buffers, int[] offsets, int[] byteCounts) throws ErrnoException, InterruptedIOException; 12126010ab930a2cee3bf10b9612cf070183c21228bElliott Hughes public int recvfrom(FileDescriptor fd, ByteBuffer buffer, int flags, InetSocketAddress srcAddress) throws ErrnoException, SocketException; 12226010ab930a2cee3bf10b9612cf070183c21228bElliott Hughes public int recvfrom(FileDescriptor fd, byte[] bytes, int byteOffset, int byteCount, int flags, InetSocketAddress srcAddress) throws ErrnoException, SocketException; 123c7fa20701d5e9398c38f4615ed293acfce1c0cf6Elliott Hughes public void remove(String path) throws ErrnoException; 124a20cc6fca30d18e05db67ceeb0403b7b58ffd364Elliott Hughes public void rename(String oldPath, String newPath) throws ErrnoException; 12526010ab930a2cee3bf10b9612cf070183c21228bElliott Hughes public int sendto(FileDescriptor fd, ByteBuffer buffer, int flags, InetAddress inetAddress, int port) throws ErrnoException, SocketException; 12626010ab930a2cee3bf10b9612cf070183c21228bElliott Hughes public int sendto(FileDescriptor fd, byte[] bytes, int byteOffset, int byteCount, int flags, InetAddress inetAddress, int port) throws ErrnoException, SocketException; 1278b15dcc5890963edad4dfcf558cc16027c7985e5Elliott Hughes public long sendfile(FileDescriptor outFd, FileDescriptor inFd, MutableLong inOffset, long byteCount) throws ErrnoException; 128396a9c666da353b910b515d12eb1c43adfddb0c8Elliott Hughes public void setegid(int egid) throws ErrnoException; 129895a613aa2aec6aa6d03b29755cf2fea584909adElliott Hughes public void setenv(String name, String value, boolean overwrite) throws ErrnoException; 130396a9c666da353b910b515d12eb1c43adfddb0c8Elliott Hughes public void seteuid(int euid) throws ErrnoException; 131396a9c666da353b910b515d12eb1c43adfddb0c8Elliott Hughes public void setgid(int gid) throws ErrnoException; 1326c9b5377550a9649ed1532d1fcdfeba116c74eadElliott Hughes public int setsid() throws ErrnoException; 133c63f0d4e80a9fd3bdf99cd438d108b750226736aElliott Hughes public void setsockoptByte(FileDescriptor fd, int level, int option, int value) throws ErrnoException; 134b974666d79ebc392b37ec1ae83aae57ae6331c08Elliott Hughes public void setsockoptIfreq(FileDescriptor fd, int level, int option, String value) throws ErrnoException; 135454a95f6a28855aa3c88d168b15a45bf315efc99Elliott Hughes public void setsockoptInt(FileDescriptor fd, int level, int option, int value) throws ErrnoException; 136b974666d79ebc392b37ec1ae83aae57ae6331c08Elliott Hughes public void setsockoptIpMreqn(FileDescriptor fd, int level, int option, int value) throws ErrnoException; 137438cb9e440d250c8aa5daf4fae0c400dce8b1499Elliott Hughes public void setsockoptGroupReq(FileDescriptor fd, int level, int option, StructGroupReq value) throws ErrnoException; 138df29508a7aa622f265aaebdc472eb7d679185ebbNeil Fuller public void setsockoptGroupSourceReq(FileDescriptor fd, int level, int option, StructGroupSourceReq value) throws ErrnoException; 139c63f0d4e80a9fd3bdf99cd438d108b750226736aElliott Hughes public void setsockoptLinger(FileDescriptor fd, int level, int option, StructLinger value) throws ErrnoException; 140c63f0d4e80a9fd3bdf99cd438d108b750226736aElliott Hughes public void setsockoptTimeval(FileDescriptor fd, int level, int option, StructTimeval value) throws ErrnoException; 141396a9c666da353b910b515d12eb1c43adfddb0c8Elliott Hughes public void setuid(int uid) throws ErrnoException; 14259e4744d27231f260271dbbca406e0cc39768116Elliott Hughes public void shutdown(FileDescriptor fd, int how) throws ErrnoException; 143454a95f6a28855aa3c88d168b15a45bf315efc99Elliott Hughes public FileDescriptor socket(int domain, int type, int protocol) throws ErrnoException; 1443218082325b6b8713a8ac15731482e3da86a7df9Elliott Hughes public void socketpair(int domain, int type, int protocol, FileDescriptor fd1, FileDescriptor fd2) throws ErrnoException; 14547cb338d43f75dd998b29caaaa9446c5705217d1Elliott Hughes public StructStat stat(String path) throws ErrnoException; 146721ceca2a52a3c27aa751476c8562e1e68088e15Elliott Hughes public StructStatVfs statvfs(String path) throws ErrnoException; 147ddfdbb9d172fe9b72e08e8d7deab0aa3b8acf044Elliott Hughes public String strerror(int errno); 148763f8ed6195707d0c30bfae1ca8a3bb886b746ccElliott Hughes public String strsignal(int signal); 149a20cc6fca30d18e05db67ceeb0403b7b58ffd364Elliott Hughes public void symlink(String oldPath, String newPath) throws ErrnoException; 1506fc1a0e1e68dc2e0d12341548e58fa7f1c5dafc4Elliott Hughes public long sysconf(int name); 151bb5816aa1626eb2f6263bd21479600b114c8a1bdJohan Redestig public void tcdrain(FileDescriptor fd) throws ErrnoException; 152039f7599559fd7e48c354b99dcb94ff391f53349Elliott Hughes public void tcsendbreak(FileDescriptor fd, int duration) throws ErrnoException; 15344f7875f2985d7944c5afecc8394ad9f2219c806Elliott Hughes public int umask(int mask); 1549b510df35b57946d843ffc34cf23fdcfc84c5220Elliott Hughes public StructUtsname uname(); 155895a613aa2aec6aa6d03b29755cf2fea584909adElliott Hughes public void unsetenv(String name) throws ErrnoException; 1569e67ca71d3d4a489a157abadc5ba519ced7a0b50Elliott Hughes public int waitpid(int pid, MutableInt status, int options) throws ErrnoException; 157f0d40d662d9dfdb04215c718961765837d2cf00cNeil Fuller public int write(FileDescriptor fd, ByteBuffer buffer) throws ErrnoException, InterruptedIOException; 158f0d40d662d9dfdb04215c718961765837d2cf00cNeil Fuller public int write(FileDescriptor fd, byte[] bytes, int byteOffset, int byteCount) throws ErrnoException, InterruptedIOException; 159f0d40d662d9dfdb04215c718961765837d2cf00cNeil Fuller public int writev(FileDescriptor fd, Object[] buffers, int[] offsets, int[] byteCounts) throws ErrnoException, InterruptedIOException; 160ec617e2cb4a374f0fd8fbda4a633214cf23a59a9Elliott Hughes} 161