1 /* 2 * Copyright (C) 2020 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 17 #pragma once 18 19 #include <android/binder_ibinder.h> 20 21 __BEGIN_DECLS 22 23 /** 24 * Function to execute a shell command. 25 * 26 * Available since API level 30. 27 * 28 * \param binder the binder executing the command 29 * \param in input file descriptor, should be flushed, ownership is not passed 30 * \param out output file descriptor, should be flushed, ownership is not passed 31 * \param err error file descriptor, should be flushed, ownership is not passed 32 * \param argv array of null-terminated strings for command (may be null if argc 33 * is 0) 34 * \param argc length of argv array 35 * 36 * \return binder_status_t result of transaction 37 */ 38 typedef binder_status_t (*AIBinder_handleShellCommand)(AIBinder* binder, int in, int out, int err, 39 const char** argv, uint32_t argc); 40 41 /** 42 * This sets the implementation of handleShellCommand for a class. 43 * 44 * If this isn't set, nothing will be executed when handleShellCommand is called. 45 * 46 * Available since API level 30. 47 * 48 * \param handleShellCommand function to call when a shell transaction is 49 * received 50 */ 51 __attribute__((weak)) void AIBinder_Class_setHandleShellCommand( 52 AIBinder_Class* clazz, AIBinder_handleShellCommand handleShellCommand) __INTRODUCED_IN(30); 53 54 __END_DECLS 55