Merge "libbinder: update getCallingPid docs" into main (e615929b) · Commits · e / devices / smdk4412 / android_frameworks_native

libs/binder/include/binder/IPCThreadState.h

+7 −2

Original line number	Diff line number	Diff line
		@@ -62,8 +62,13 @@ public:

		/**
		* Returns the PID of the process which has made the current binder
		* call. If not in a binder call, this will return getpid. If the
		* call is oneway, this will return 0.
		* call. If not in a binder call, this will return getpid.
		*
		* Warning: oneway transactions do not receive PID. Even if you expect
		* a transaction to be synchronous, a misbehaving client could send it
		* as an asynchronous call and result in a 0 PID here. Additionally, if
		* there is a race and the calling process dies, the PID may still be
		* 0 for a synchronous call.
		*/
		[[nodiscard]] pid_t getCallingPid() const;

+6 −0

Original line number	Diff line number	Diff line
		@@ -390,6 +390,12 @@ uid_t AIBinder_getCallingUid() __INTRODUCED_IN(29);
		* calling process dies and is replaced with another process with elevated permissions and the same
		* PID.
		*
		* Warning: oneway transactions do not receive PID. Even if you expect
		* a transaction to be synchronous, a misbehaving client could send it
		* as a synchronous call and result in a 0 PID here. Additionally, if
		* there is a race and the calling process dies, the PID may still be
		* 0 for a synchronous call.
		*
		* Available since API level 29.
		*
		* \return calling pid or the current process's PID if this thread isn't processing a transaction.

+6 −3

Original line number	Diff line number	Diff line
		@@ -101,13 +101,16 @@ impl ThreadState {
		/// dies and is replaced with another process with elevated permissions and
		/// the same PID.
		///
		/// Warning: oneway transactions do not receive PID. Even if you expect
		/// a transaction to be synchronous, a misbehaving client could send it
		/// as a synchronous call and result in a 0 PID here. Additionally, if
		/// there is a race and the calling process dies, the PID may still be
		/// 0 for a synchronous call.
		///
		/// Available since API level 29.
		///
		/// \return calling pid or the current process's PID if this thread isn't
		/// processing a transaction.
		///
		/// If the transaction being processed is a oneway transaction, then this
		/// method will return 0.
		pub fn get_calling_pid() -> pid_t {
		// Safety: Safe FFI
		unsafe { sys::AIBinder_getCallingPid() }