src/main/java/jnr/posix/POSIX.java

package jnr.posix;

import jnr.constants.platform.Fcntl;
import jnr.constants.platform.Signal;
import jnr.constants.platform.Sysconf;
import jnr.ffi.Pointer;
import jnr.posix.util.ProcessMaker;

import java.io.FileDescriptor;
import java.io.IOException;
import java.nio.ByteBuffer;
import java.util.Collection;
import jnr.constants.platform.Confstr;
import jnr.constants.platform.Pathconf;
import jnr.ffi.annotations.Out;

public interface POSIX {
    CharSequence crypt(CharSequence key, CharSequence salt);

    /**
     * Call the crypt function with the given key and salt as raw null-terminated byte (C char) strings.
     *
     * @param key null-terminated key bytes
     * @param salt null-terminated salt bytes
     * @return null-terminated crypted bytes, or null if there was an error
     */
    byte[] crypt(byte[] key, byte[] salt);

    FileStat allocateStat();
    int chmod(String filename, int mode);
    int fchmod(int fd, int mode);
    int chown(String filename, int user, int group);
    int fchown(int fd, int user, int group);
    /**
     * Shell expanding and escaping version of exec which handles all the
     * preparation of a command line or command list.
     *
     * @param path the path to execute
     * @param argv the arguments to pass, with arg0 equal to the desired process name
     * @return does not return if successful; -1 if failed
     */
    int exec(String path, String... argv);
    
    /**
     * Shell expanding and escaping version of exec which handles all the
     * preparation of a command line or command list.
     *
     * @param path the path to execute
     * @param argv the arguments to pass, with arg0 equal to the desired process name
     * @param envp a set of KEY=VALUE environment strings to set for the new execution
     * @return does not return if successful; -1 if failed
     */
    int exec(String path, String[] argv, String[] envp);
    
    int execv(String path, String[] argv);  
    int execve(String path, String[] argv, String[] envp);    
    int fork();
    FileStat fstat(FileDescriptor descriptor);
    FileStat fstat(int descriptor);
    int fstat(FileDescriptor descriptor, FileStat stat);
    int fstat(int fd, FileStat stat);
    Pointer environ();
    String getenv(String envName);
    int getegid();
    int geteuid();
    int seteuid(int euid);
    int getgid();
    int getdtablesize();
    String getlogin();
    int getpgid();
    int getpgid(int pid);
    int getpgrp();
    int getpid();
    int getppid();
    int getpriority(int which, int who);
    Passwd getpwent();
    Passwd getpwuid(int which);
    Passwd getpwnam(String which);
    Group getgrgid(int which);
    Group getgrnam(String which);
    Group getgrent();
    int endgrent();
    int setgrent();
    int endpwent();
    int setpwent();
    int getuid();
    int getrlimit(int resource, RLimit rlim);
    int getrlimit(int resource, Pointer rlim);
    RLimit getrlimit(int resource);
    int setrlimit(int resource, RLimit rlim);
    int setrlimit(int resource, Pointer rlim);
    int setrlimit(int resource, long rlimCur, long rlimMax);
    boolean isatty(FileDescriptor descriptor);
    int isatty(int descriptor);
    int kill(int pid, int signal);
    int kill(long pid, int signal);
    SignalHandler signal(Signal sig, SignalHandler handler);
    int raise(int sig);
    int lchmod(String filename, int mode);
    int lchown(String filename, int user, int group);
    int link(String oldpath,String newpath);
    FileStat lstat(String path);
    int lstat(String path, FileStat stat);
    int mkdir(String path, int mode);
    String readlink(String path) throws IOException;
    int readlink(CharSequence path, byte[] buf, int bufsize);
    int readlink(CharSequence path, ByteBuffer buf, int bufsize);
    int readlink(CharSequence path, Pointer bufPtr, int bufsize);
    int rmdir(String path);
    int setenv(String envName, String envValue, int overwrite); // 0 no !0 yes
    int setsid();
    int setgid(int gid);
    int setegid(int egid);
    int setpgid(int pid, int pgid);
    int setpgrp(int pid, int pgrp);
    int setpriority(int which, int who, int prio);
    int setuid(int uid);
    FileStat stat(String path);
    int stat(String path, FileStat stat);
    int symlink(String oldpath,String newpath);
    int umask(int mask);
    int unsetenv(String envName);
    int utimes(String path, long[] atimeval, long[] mtimeval);
    int utimes(String path, Pointer times);
    int futimes(int fd, long[] atimeval, long[] mtimeval);
    int lutimes(String path, long[] atimeval, long[] mtimeval);
    int utimensat(int dirfd, String path, long[] atimespec, long[] mtimespec, int flag);
    int utimensat(int dirfd, String path, Pointer times, int flag);
    int futimens(int fd, long[] atimespec, long[] mtimespec);
    int futimens(int fd, Pointer times);
    int waitpid(int pid, int[] status, int flags);
    int waitpid(long pid, int[] status, int flags);
    int wait(int[] status);
    int errno();
    void errno(int value);
    String strerror(int code);
    int chdir(String path);
    boolean isNative();
    /**
     * Returns null if isNative returns false.
     *
     * @return the LibC implementation for this POSIX
     */
    LibC libc();
    ProcessMaker newProcessMaker(String... command);
    ProcessMaker newProcessMaker();

    public long sysconf(Sysconf name);

    public int confstr(Confstr name, @Out ByteBuffer buf, int len);

    public int fpathconf(int fd, Pathconf name);

    public Times times();

    public long posix_spawnp(String path, Collection<? extends SpawnFileAction> fileActions,
                            Collection<? extends CharSequence> argv, Collection<? extends CharSequence> envp);

    public long posix_spawnp(String path, Collection<? extends SpawnFileAction> fileActions,
                             Collection<? extends SpawnAttribute> spawnAttributes,
                             Collection<? extends CharSequence> argv, Collection<? extends CharSequence> envp);
    
    public int flock(int fd, int operation);

    int dup(int fd);

    int dup2(int oldFd, int newFd);

    int fcntlInt(int fd, Fcntl fcntlConst, int arg);
    int fcntl(int fd, Fcntl fcntlConst, int arg);
    int fcntl(int fd, Fcntl fcntlConst);
    int access(CharSequence path, int amode);
    int close(int fd);
    int unlink(CharSequence path);
    int open(CharSequence path, int flags, int perm);

    long read(int fd, byte[] buf, long n);
    long write(int fd, byte[] buf, long n);
    long read(int fd, ByteBuffer buf, long n);
    long write(int fd, ByteBuffer buf, long n);
    long pread(int fd, byte[] buf, long n, long offset);
    long pwrite(int fd, byte[] buf, long n, long offset);
    long pread(int fd, ByteBuffer buf, long n, long offset);
    long pwrite(int fd, ByteBuffer buf, long n, long offset);

    int read(int fd, byte[] buf, int n);
    int write(int fd, byte[] buf, int n);
    int read(int fd, ByteBuffer buf, int n);
    int write(int fd, ByteBuffer buf, int n);
    int pread(int fd, byte[] buf, int n, int offset);
    int pwrite(int fd, byte[] buf, int n, int offset);
    int pread(int fd, ByteBuffer buf, int n, int offset);
    int pwrite(int fd, ByteBuffer buf, int n, int offset);

    int lseek(int fd, long offset, int whence);
    long lseekLong(int fd, long offset, int whence);
    int pipe(int[] fds);
    int truncate(CharSequence path, long length);
    int ftruncate(int fd, long offset);
    int rename(CharSequence oldName, CharSequence newName);
    String getcwd();
    String gethostname();

    int socketpair(int domain, int type, int protocol, int[] fds);
    int sendmsg(int socket, MsgHdr message, int flags);
    int recvmsg(int socket, MsgHdr message, int flags);

    MsgHdr allocateMsgHdr();

    /**
     * fcntl(2)
     *
     * @deprecated This version does not pass args because jnr-ffi does not support variadic invocation.
     * @see jnr.posix.POSIX#fcntlInt(int, jnr.constants.platform.Fcntl, int)
     *
     * @param fd the file descriptor on which to act
     * @param fcntlConst the {@link Fcntl} enum value for the flag to set
     * @param arg arguments for the flag or null if none
     * @return 0 if success, -1 if error
     */
    @Deprecated
    int fcntl(int fd, Fcntl fcntlConst, int... arg);
    int fsync(int fd);
    int fdatasync(int fd);
    int mkfifo(String filename, int mode);

    int daemon(int nochdir, int noclose);

    long[] getgroups();
    int getgroups(int size, int[] groups);

    String nl_langinfo(int item);
    String setlocale(int category, String locale);

    Timeval allocateTimeval();
    int gettimeofday(Timeval tv);
}