/*
* Copyright (C) 2012 The Android Open Source Project
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package android.os;
import android.util.Slog;
import java.io.IOException;
import java.io.File;
import java.io.FileDescriptor;
/**
* This class provides access to the centralized jni bindings for
* SELinux interaction.
* {@hide}
*/
public class SELinux {
private static final String TAG = "SELinux";
/**
* Determine whether SELinux is disabled or enabled.
* @return a boolean indicating whether SELinux is enabled.
*/
public static final native boolean isSELinuxEnabled();
/**
* Determine whether SELinux is permissive or enforcing.
* @return a boolean indicating whether SELinux is enforcing.
*/
public static final native boolean isSELinuxEnforced();
/**
* Set whether SELinux is permissive or enforcing.
* @param boolean representing whether to set SELinux to enforcing
* @return a boolean representing whether the desired mode was set
*/
public static final native boolean setSELinuxEnforce(boolean value);
/**
* Sets the security context for newly created file objects.
* @param context a security context given as a String.
* @return a boolean indicating whether the operation succeeded.
*/
public static final native boolean setFSCreateContext(String context);
/**
* Change the security context of an existing file object.
* @param path representing the path of file object to relabel.
* @param con new security context given as a String.
* @return a boolean indicating whether the operation succeeded.
*/
public static final native boolean setFileContext(String path, String context);
/**
* Get the security context of a file object.
* @param path the pathname of the file object.
* @return a security context given as a String.
*/
public static final native String getFileContext(String path);
/**
* Get the security context of a peer socket.
* @param fd FileDescriptor class of the peer socket.
* @return a String representing the peer socket security context.
*/
public static final native String getPeerContext(FileDescriptor fd);
/**
* Gets the security context of the current process.
* @return a String representing the security context of the current process.
*/
public static final native String getContext();
/**
* Gets the security context of a given process id.
* Use of this function is discouraged for Binder transactions.
* Use Binder.getCallingSecctx() instead.
* @param pid an int representing the process id to check.
* @return a String representing the security context of the given pid.
*/
public static final native String getPidContext(int pid);
/**
* Gets a list of the SELinux boolean names.
* @return an array of strings containing the SELinux boolean names.
*/
public static final native String[] getBooleanNames();
/**
* Gets the value for the given SELinux boolean name.
* @param String The name of the SELinux boolean.
* @return a boolean indicating whether the SELinux boolean is set.
*/
public static final native boolean getBooleanValue(String name);
/**
* Sets the value for the given SELinux boolean name.
* @param String The name of the SELinux boolean.
* @param Boolean The new value of the SELinux boolean.
* @return a boolean indicating whether or not the operation succeeded.
*/
public static final native boolean setBooleanValue(String name, boolean value);
/**
* Check permissions between two security contexts.
* @param scon The source or subject security context.
* @param tcon The target or object security context.
* @param tclass The object security class name.
* @param perm The permission name.
* @return a boolean indicating whether permission was granted.
*/
public static final native boolean checkSELinuxAccess(String scon, String tcon, String tclass, String perm);
/**
* Restores a file to its default SELinux security context.
* If the system is not compiled with SELinux, then {@code true}
* is automatically returned.
* If SELinux is compiled in, but disabled, then {@code true} is
* returned.
*
* @param pathname The pathname of the file to be relabeled.
* @return a boolean indicating whether the relabeling succeeded.
* @exception NullPointerException if the pathname is a null object.
*/
public static boolean restorecon(String pathname) throws NullPointerException {
if (pathname == null) { throw new NullPointerException(); }
return native_restorecon(pathname);
}
/**
* Restores a file to its default SELinux security context.
* If the system is not compiled with SELinux, then {@code true}
* is automatically returned.
* If SELinux is compiled in, but disabled, then {@code true} is
* returned.
*
* @param pathname The pathname of the file to be relabeled.
* @return a boolean indicating whether the relabeling succeeded.
*/
private static native boolean native_restorecon(String pathname);
/**
* Restores a file to its default SELinux security context.
* If the system is not compiled with SELinux, then {@code true}
* is automatically returned.
* If SELinux is compiled in, but disabled, then {@code true} is
* returned.
*
* @param file The File object representing the path to be relabeled.
* @return a boolean indicating whether the relabeling succeeded.
* @exception NullPointerException if the file is a null object.
*/
public static boolean restorecon(File file) throws NullPointerException {
try {
return native_restorecon(file.getCanonicalPath());
} catch (IOException e) {
Slog.e(TAG, "Error getting canonical path. Restorecon failed for " +
file.getPath(), e);
return false;
}
}
}