Android 的系统属性(SystemProperties)设置分析

作者：徐建祥([e-mail])
日期：2009/11/11
网址：http://www.anymobile.org

Android 的系统属性包括两部分：文件保存的持久属性和每次开机导入的cache属性。前者主要保存在下面几个文件中：

bionic / libc / include / sys / _system_properties.h

1     #define  PROP_SERVICE_NAME "property_service" 
2      #define  PROP_PATH_RAMDISK_DEFAULT  "/default.prop" 
3      #define  PROP_PATH_SYSTEM_BUILD     "/system/build.prop" 
4      #define  PROP_PATH_SYSTEM_DEFAULT   "/system/default.prop" 
5      #define  PROP_PATH_LOCAL_OVERRIDE   "/data/local.prop"

后者则通过frameworks/base/core/java/android/os/SystemProperties.java的接口定义，

 1       private   static   native  String native_get(String key);
 2       private   static   native  String native_get(String key, String def);
 3       private   static   native   void  native_set(String key, String def);
 4       public   static   void  set(String key, String val) {
 5           if  (key.length()  >  PROP_NAME_MAX) {
 6               throw   new  IllegalArgumentException( " key.length >  "   +  PROP_NAME_MAX);
 7          }
 8           if  (val  !=   null   &&  val.length()  >  PROP_VALUE_MAX) {
 9               throw   new  IllegalArgumentException( " val.length >  "   + 
10                  PROP_VALUE_MAX);
11          }
12          native_set(key, val);
13      }

该接口类在初始化运行环境中注册对应的cpp接口android_os_SystemProperties.cpp，实际操作通过JNI调用的是cpp文件对应的接口：

frameworks/base/core/jni/AndroidRuntime.cpp

1       namespace  android {
2       extern   int  register_android_os_SystemProperties(JNIEnv  * env);
3      }

frameworks/base/core/jni/android_os_SystemProperties.cpp

 1       static   void  SystemProperties_set(JNIEnv  * env, jobject clazz, jstring keyJ, jstring valJ)
 2      {
 3           int  err;
 4           const   char *  key;
 5           const   char *  val;
 6          key  =  env -> GetStringUTFChars(keyJ, NULL);
 7           if  (valJ  ==  NULL) {
 8              val  =   "" ;        /*  NULL pointer not allowed here  */ 
 9          }  else  {
10              val  =  env -> GetStringUTFChars(valJ, NULL);
11          }
12          err  =  property_set(key, val);
13          env -> ReleaseStringUTFChars(keyJ, key);        
14           if  (valJ  !=  NULL) {
15              env -> ReleaseStringUTFChars(valJ, val);
16          }
17      }

设置key的value时，需要作鉴权，根据设置程序所在进程的fd获知uid值，比如system server进程可以设置net打头的key，不可以设置gsm打头的key，相关的定义如下：

system/core/include/private/android_filesystem_config.h

1       #define  AID_ROOT             0  /* traditional unix root user */ 
2       #define  AID_SYSTEM        1000  /* system server */ 
3       #define  AID_RADIO         1001  /* telephony subsystem, RIL */ 
4       #define  AID_DHCP          1014  /* dhcp client */ 
5       #define  AID_SHELL         2000  /* adb and debug shell user */ 
6       #define  AID_CACHE         2001  /* cache access */ 
7       #define  AID_APP          10000 /* first app user */

system/core/init/property_service.c

 1       #define  PERSISTENT_PROPERTY_DIR  "/data/property" 
 2       struct  {
 3           const   char   * prefix;
 4          unsigned  int  uid;
 5      } property_perms[]  =  {
 6          {  " net.rmnet0. " ,    AID_RADIO },
 7          {  " net.gprs. " ,      AID_RADIO },
 8          {  " ril. " ,           AID_RADIO },
 9          {  " gsm. " ,           AID_RADIO },
10          {  " net.dns " ,        AID_RADIO },
11          {  " net.usb0 " ,       AID_RADIO },
12          {  " net. " ,           AID_SYSTEM },
13          {  " dev. " ,           AID_SYSTEM },
14          {  " runtime. " ,       AID_SYSTEM },
15          {  " hw. " ,            AID_SYSTEM },
16          {  " sys. " ,        AID_SYSTEM },
17          {  " service. " ,    AID_SYSTEM },
18          {  " wlan. " ,        AID_SYSTEM },
19          {  " dhcp. " ,        AID_SYSTEM },
20          {  " dhcp. " ,        AID_DHCP },
21          {  " debug. " ,        AID_SHELL },
22          {  " log. " ,        AID_SHELL },
23          {  " service.adb.root " ,    AID_SHELL },
24          {  " persist.sys. " ,    AID_SYSTEM },
25          {  " persist.service. " ,   AID_SYSTEM },
26          { NULL,  0  }
27      };
28       int  property_set( const   char   * name,  const   char   * value)
29      {
30          property_changed(name, value);
31           return   0 ;
32      }
33       int  start_property_service( void )
34      {
35           int  fd;
36  
37          load_properties_from_file(PROP_PATH_SYSTEM_BUILD);
38          load_properties_from_file(PROP_PATH_SYSTEM_DEFAULT);
39          load_properties_from_file(PROP_PATH_LOCAL_OVERRIDE);
40           /*  Read persistent properties after all default values have been loaded.  */ 
41          load_persistent_properties();
42  
43          fd  =  create_socket(PROP_SERVICE_NAME, SOCK_STREAM,  0666 ,  0 ,  0 );
44           if (fd  <   0 )  return   - 1 ;
45          fcntl(fd, F_SETFD, FD_CLOEXEC);
46          fcntl(fd, F_SETFL, O_NONBLOCK);
47  
48          listen(fd,  8 );
49           return  fd;
50      }
51       void  handle_property_set_fd( int  fd)
52      {
53           switch (msg.cmd) {
54           case  PROP_MSG_SETPROP:
55              msg.name[PROP_NAME_MAX - 1 ]  =   0 ;
56              msg.value[PROP_VALUE_MAX - 1 ]  =   0 ;
57  
58               if (memcmp(msg.name, " ctl. " , 4 )  ==   0 ) {
59                   if  (check_control_perms(msg.value, cr.uid)) {
60                      handle_control_message(( char * ) msg.name  +   4 , ( char * ) msg.value);
61                  }  else  {
62                      ERROR( " sys_prop: Unable to %s service ctl [%s] uid: %d pid:%d\n " ,
63                              msg.name  +   4 , msg.value, cr.uid, cr.pid);
64                  }
65              }  else  {
66                   if  (check_perms(msg.name, cr.uid)) {
67                      property_set(( char * ) msg.name, ( char * ) msg.value);
68                  }  else  {
69                      ERROR( " sys_prop: permission denied uid:%d  name:%s\n " ,
70                            cr.uid, msg.name);
71                  }
72              }
73               break ;
74  
75           default :
76               break ;
77          }
78      }

在开机启动后的init操作中，会执行一个loop循环，当检测到有新的设置时，进入设置流程，鉴权失败会提示相关的异常，如sys_prop: permission denied uid:1000  name:gsm.phone.id

system/core/init/init.c

 1       void  property_changed( const   char   * name,  const   char   * value)
 2      {
 3           if  (property_triggers_enabled) {
 4              queue_property_triggers(name, value);
 5              drain_action_queue();
 6          }
 7      }
 8       int  main( int  argc,  char   ** argv)
 9      {
10          parse_config_file( " /init.rc " );
11          qemu_init();
12          device_fd  =  device_init();
13          property_init();
14          fd  =  open(console_name, O_RDWR);
15          property_set_fd  =  start_property_service();
16          ufds[ 0 ].fd  =  device_fd;
17          ufds[ 0 ].events  =  POLLIN;
18          ufds[ 1 ].fd  =  property_set_fd;
19          ufds[ 1 ].events  =  POLLIN;
20          ufds[ 2 ].fd  =  signal_recv_fd;
21          ufds[ 2 ].events  =  POLLIN;
22          fd_count  =   3 ;
23           for (;;) {
24               if  (ufds[ 0 ].revents  ==  POLLIN)
25                  handle_device_fd(device_fd);
26  
27               if  (ufds[ 1 ].revents  ==  POLLIN)
28                  handle_property_set_fd(property_set_fd);
29               if  (ufds[ 3 ].revents  ==  POLLIN)
30                  handle_keychord(keychord_fd);
31          }
32           return   0 ;
33      }

OVER！