Os.java revision 4f11ebea266eada830d507b8f011e811a8e5d7bc
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 1952724d3ebd4ccaaa4b9f5576e329d4272cde8ea9Elliott Hughesimport java.io.FileDescriptor; 200a9d1ee45a9884a9616624d747172e18734e8fe0Elliott Hughesimport java.net.InetAddress; 210a9d1ee45a9884a9616624d747172e18734e8fe0Elliott Hughesimport java.net.SocketAddress; 2226c7025a7a919044771fb89031161bd26fe03032Elliott Hughesimport java.nio.ByteBuffer; 238b15dcc5890963edad4dfcf558cc16027c7985e5Elliott Hughesimport libcore.util.MutableInt; 248b15dcc5890963edad4dfcf558cc16027c7985e5Elliott Hughesimport libcore.util.MutableLong; 2552724d3ebd4ccaaa4b9f5576e329d4272cde8ea9Elliott Hughes 26ec617e2cb4a374f0fd8fbda4a633214cf23a59a9Elliott Hughespublic interface Os { 27ddfdbb9d172fe9b72e08e8d7deab0aa3b8acf044Elliott Hughes public boolean access(String path, int mode) throws ErrnoException; 28b7190190e0ef8de883c952efb319ce7748831faaElliott Hughes public void chmod(String path, int mode) throws ErrnoException; 29462bdac45c10f43d88d8f07f6994e272a27c14a2Elliott Hughes public void close(FileDescriptor fd) throws ErrnoException; 30ddfdbb9d172fe9b72e08e8d7deab0aa3b8acf044Elliott Hughes public String[] environ(); 31fc549a0b0388987b26dea524894d75a63d14783bElliott Hughes public int fcntlVoid(FileDescriptor fd, int cmd) throws ErrnoException; 32fc549a0b0388987b26dea524894d75a63d14783bElliott Hughes public int fcntlLong(FileDescriptor fd, int cmd, long arg) throws ErrnoException; 33fc549a0b0388987b26dea524894d75a63d14783bElliott Hughes public int fcntlFlock(FileDescriptor fd, int cmd, StructFlock arg) throws ErrnoException; 3452724d3ebd4ccaaa4b9f5576e329d4272cde8ea9Elliott Hughes public void fdatasync(FileDescriptor fd) throws ErrnoException; 3547cb338d43f75dd998b29caaaa9446c5705217d1Elliott Hughes public StructStat fstat(FileDescriptor fd) throws ErrnoException; 3659fa7163774d6930a174bc038414a4b780581957Elliott Hughes public StructStatFs fstatfs(FileDescriptor fd) throws ErrnoException; 3752724d3ebd4ccaaa4b9f5576e329d4272cde8ea9Elliott Hughes public void fsync(FileDescriptor fd) throws ErrnoException; 38f5333fd2094bdac4d6506177b1964b79afa64d77Elliott Hughes public void ftruncate(FileDescriptor fd, long length) throws ErrnoException; 394f11ebea266eada830d507b8f011e811a8e5d7bcElliott Hughes public String gai_strerror(int error); 40ec617e2cb4a374f0fd8fbda4a633214cf23a59a9Elliott Hughes public String getenv(String name); 414f11ebea266eada830d507b8f011e811a8e5d7bcElliott Hughes /* TODO: break into getnameinfoHost and getnameinfoService? */ 424f11ebea266eada830d507b8f011e811a8e5d7bcElliott Hughes public String getnameinfo(InetAddress address, int flags) throws GaiException; 430a9d1ee45a9884a9616624d747172e18734e8fe0Elliott Hughes public SocketAddress getsockname(FileDescriptor fd) throws ErrnoException; 440a9d1ee45a9884a9616624d747172e18734e8fe0Elliott Hughes public int getsockoptByte(FileDescriptor fd, int level, int option) throws ErrnoException; 450a9d1ee45a9884a9616624d747172e18734e8fe0Elliott Hughes public InetAddress getsockoptInAddr(FileDescriptor fd, int level, int option) throws ErrnoException; 460a9d1ee45a9884a9616624d747172e18734e8fe0Elliott Hughes public int getsockoptInt(FileDescriptor fd, int level, int option) throws ErrnoException; 470a9d1ee45a9884a9616624d747172e18734e8fe0Elliott Hughes public StructLinger getsockoptLinger(FileDescriptor fd, int level, int option) throws ErrnoException; 480a9d1ee45a9884a9616624d747172e18734e8fe0Elliott Hughes public StructTimeval getsockoptTimeval(FileDescriptor fd, int level, int option) throws ErrnoException; 498b15dcc5890963edad4dfcf558cc16027c7985e5Elliott Hughes public int ioctlInt(FileDescriptor fd, int cmd, MutableInt arg) throws ErrnoException; 509a3f363523000704205df288f8b6f2f48c0d8563Elliott Hughes public boolean isatty(FileDescriptor fd); 51e1502d64e937001636fca3d62b2552ef2a34d05fElliott Hughes public void listen(FileDescriptor fd, int backlog) throws ErrnoException; 52dedaccdfa07c370a58cba08b096133ad9eec0ec3Elliott Hughes public long lseek(FileDescriptor fd, long offset, int whence) throws ErrnoException; 530f746ff511162add42eeabaf14ba70ace874c6f4Elliott Hughes public void mincore(long address, long byteCount, byte[] vector) throws ErrnoException; 54c7fa20701d5e9398c38f4615ed293acfce1c0cf6Elliott Hughes public void mkdir(String path, int mode) throws ErrnoException; 557e13c0f05ac9e7c55682d10e953dd4cbd5e6107cElliott Hughes public void mlock(long address, long byteCount) throws ErrnoException; 567e25eff38a191d9c19e45093f4fde5102fb09d78Elliott Hughes public long mmap(long address, long byteCount, int prot, int flags, FileDescriptor fd, long offset) throws ErrnoException; 577e25eff38a191d9c19e45093f4fde5102fb09d78Elliott Hughes public void msync(long address, long byteCount, int flags) throws ErrnoException; 587e13c0f05ac9e7c55682d10e953dd4cbd5e6107cElliott Hughes public void munlock(long address, long byteCount) throws ErrnoException; 597e25eff38a191d9c19e45093f4fde5102fb09d78Elliott Hughes public void munmap(long address, long byteCount) throws ErrnoException; 600ac77ac8e915bff1a863e371f9b363033f9cf759Elliott Hughes public FileDescriptor open(String path, int flags, int mode) throws ErrnoException; 6141f0605d2c809bd9bc1c0fb68d86b49a0f59b6c5Elliott Hughes public FileDescriptor[] pipe() throws ErrnoException; 6247cb338d43f75dd998b29caaaa9446c5705217d1Elliott Hughes public StructStat lstat(String path) throws ErrnoException; 6326c7025a7a919044771fb89031161bd26fe03032Elliott Hughes public int read(FileDescriptor fd, ByteBuffer buffer) throws ErrnoException; 6426c7025a7a919044771fb89031161bd26fe03032Elliott Hughes public int read(FileDescriptor fd, byte[] bytes, int byteOffset, int byteCount) throws ErrnoException; 65bbac92e691de7d570928ddfba639067978e55b06Elliott Hughes public int readv(FileDescriptor fd, Object[] buffers, int[] offsets, int[] byteCounts) throws ErrnoException; 66c7fa20701d5e9398c38f4615ed293acfce1c0cf6Elliott Hughes public void remove(String path) throws ErrnoException; 67a20cc6fca30d18e05db67ceeb0403b7b58ffd364Elliott Hughes public void rename(String oldPath, String newPath) throws ErrnoException; 688b15dcc5890963edad4dfcf558cc16027c7985e5Elliott Hughes public long sendfile(FileDescriptor outFd, FileDescriptor inFd, MutableLong inOffset, long byteCount) throws ErrnoException; 69c63f0d4e80a9fd3bdf99cd438d108b750226736aElliott Hughes public void setsockoptByte(FileDescriptor fd, int level, int option, int value) throws ErrnoException; 70b974666d79ebc392b37ec1ae83aae57ae6331c08Elliott Hughes public void setsockoptIfreq(FileDescriptor fd, int level, int option, String value) throws ErrnoException; 71454a95f6a28855aa3c88d168b15a45bf315efc99Elliott Hughes public void setsockoptInt(FileDescriptor fd, int level, int option, int value) throws ErrnoException; 72b974666d79ebc392b37ec1ae83aae57ae6331c08Elliott Hughes public void setsockoptIpMreqn(FileDescriptor fd, int level, int option, int value) throws ErrnoException; 73438cb9e440d250c8aa5daf4fae0c400dce8b1499Elliott Hughes public void setsockoptGroupReq(FileDescriptor fd, int level, int option, StructGroupReq value) throws ErrnoException; 74c63f0d4e80a9fd3bdf99cd438d108b750226736aElliott Hughes public void setsockoptLinger(FileDescriptor fd, int level, int option, StructLinger value) throws ErrnoException; 75c63f0d4e80a9fd3bdf99cd438d108b750226736aElliott Hughes public void setsockoptTimeval(FileDescriptor fd, int level, int option, StructTimeval value) throws ErrnoException; 7659e4744d27231f260271dbbca406e0cc39768116Elliott Hughes public void shutdown(FileDescriptor fd, int how) throws ErrnoException; 77454a95f6a28855aa3c88d168b15a45bf315efc99Elliott Hughes public FileDescriptor socket(int domain, int type, int protocol) throws ErrnoException; 7847cb338d43f75dd998b29caaaa9446c5705217d1Elliott Hughes public StructStat stat(String path) throws ErrnoException; 79461d0d860814c68154d8dd06d24f94118f33d28aElliott Hughes /* TODO: replace statfs with statvfs. */ 8059fa7163774d6930a174bc038414a4b780581957Elliott Hughes public StructStatFs statfs(String path) throws ErrnoException; 81ddfdbb9d172fe9b72e08e8d7deab0aa3b8acf044Elliott Hughes public String strerror(int errno); 82a20cc6fca30d18e05db67ceeb0403b7b58ffd364Elliott Hughes public void symlink(String oldPath, String newPath) throws ErrnoException; 836fc1a0e1e68dc2e0d12341548e58fa7f1c5dafc4Elliott Hughes public long sysconf(int name); 847341b9ed7157a1e37a3e69a0974676da358b735aElliott Hughes public StructUtsname uname() throws ErrnoException; 8578c7cc547101002b9f9043cf3845970719d1bda8Elliott Hughes public int write(FileDescriptor fd, ByteBuffer buffer) throws ErrnoException; 8678c7cc547101002b9f9043cf3845970719d1bda8Elliott Hughes public int write(FileDescriptor fd, byte[] bytes, int byteOffset, int byteCount) throws ErrnoException; 87bbac92e691de7d570928ddfba639067978e55b06Elliott Hughes public int writev(FileDescriptor fd, Object[] buffers, int[] offsets, int[] byteCounts) throws ErrnoException; 88ec617e2cb4a374f0fd8fbda4a633214cf23a59a9Elliott Hughes} 89