[转] romfs-inst.sh注释

uClinux一般都会建立一个ROMFS文件系统，而把其它文件向该文件系统添加一般都通过$(ROMFSINST)命令，而ROMFSINST变量值就是romfs-inst.sh（这文件一般在和linux-2.6.x同级的tools目录下），执行$(ROMFSINST）就是执行romfs-inst.sh。

用法：

romfs-inst.sh [options] [src] dst

-v：输出执行时过程时信息
-e env-var：如果env-var中含有y或Y字符，就执行，否则不做任何动作
-o option：功能和-e很像，只是它不用变量而是用字符串。如果当中含有y或Y字符，就执行，否则不做任何动作
-p perms：设置目标文件的权限
-a text：把text内容添加到目标文件
-A patten：只在目标文件不存在patten，text内容才添加目标文件
-l link：不是复制文件，而是执行硬链接
-s sym-link：不是复制文件，而是执行符号链接

如果参数没给出src，那romfs-inst.sh用basename函数从dst中得到基本文件名，这基本文件名加上当前目录成为src的全文件名。
多个-e和-o选项会被执行逻辑与运算，如果不想执行逻辑与而是执行逻辑或，在条件中使用1或更多的y/n/字符的单个的-e/-o
如果src是一个目录，那当中的所有文件都会被复制过去（除了CVS目录）

注：汉字部分是在源码上添加的注释。

 

uClinux一般都会建立一个ROMFS文件系统，而把其它文件向该文件系统添加一般都通过$(ROMFSINST)命令，而ROMFSINST变量值就是romfs-inst.sh（这文件一般在和linux-2.6.x同级的tools目录下），执行$(ROMFSINST）就是执行romfs-inst.sh。

用法：

romfs-inst.sh [options] [src] dst

-v：输出执行时过程时信息
-e env-var：如果env-var中含有y或Y字符，就执行，否则不做任何动作
-o option：功能和-e很像，只是它不用变量而是用字符串。如果当中含有y或Y字符，就执行，否则不做任何动作
-p perms：设置目标文件的权限
-a text：把text内容添加到目标文件
-A patten：只在目标文件不存在patten，text内容才添加目标文件
-l link：不是复制文件，而是执行硬链接
-s sym-link：不是复制文件，而是执行符号链接

如果参数没给出src，那romfs-inst.sh用basename函数从dst中得到基本文件名，这基本文件名加上当前目录成为src的全文件名。
多个-e和-o选项会被执行逻辑与运算，如果不想执行逻辑与而是执行逻辑或，在条件中使用1或更多的y/n/字符的单个的-e/-o
如果src是一个目录，那当中的所有文件都会被复制过去（除了CVS目录）

注：汉字部分是在源码上添加的注释。

1. #!/bin/sh
   
2. #
   
3. # A tool to simplify Makefiles that need to put something
   
4. # into the ROMFS
   
5. #
   
6. # Copyright (C) David McCullough, 2002,2003
   
7. #
   
8. #############################################################################
   
9. 
   
10. # Provide a default PATH setting to avoid potential problems...
    
11. PATH="/bin:/sbin:/usr/bin:/usr/sbin:/usr/local/bin:$PATH"
    
12. 
    
13. usage()
    
14. {
    
15. cat << !EOF >&2
    
16. $0: [options] [src] dst
    
17.     -v          : output actions performed.
    
18.     -e env-var  : only take action if env-var is set to "y".
    
19.     -o option   : only take action if option is set to "y".
    
20.     -p perms    : chmod style permissions for dst.
    
21.     -a text     : append text to dst.
    
22. -A pattern  : only append text if pattern doesn't exist in file
    
23.     -l link     : dst is a link to 'link'.
    
24.     -s sym-link : dst is a sym-link to 'sym-link'.
    
25. 
    
26.     if "src" is not provided,  basename is run on dst to determine the
    
27.     source in the current directory.
    
28. 
    
29. multiple -e and -o options are ANDed together.  To achieve an OR affect
    
30. use a single -e/-o with 1 or more y/n/"" chars in the condition.
    
31. 
    
32. if src is a directory,  everything in it is copied recursively to dst
    
33. with special files removed (currently CVS dirs).
    
34. !EOF
    
35. exit 1
    
36. }
    
37. 
    
38. #############################################################################
    
39. 
    
40. 用法：
    
41. 见以上
    
42. 
    
43. setperm()
    
44. {
    
45. if [ "$perm" ]
    
46. then
    
47. [ "$v" ] && echo "chmod ${perm} ${ROMFSDIR}${dst}"
    
48. chmod ${perm} ${ROMFSDIR}${dst}
    
49. fi
    
50. }
    
51. 
    
52. #############################################################################
    
53. 
    
54. file_copy()
    
55. {
    
56. if [ -d "${src}" ]
    
57. then
    
58. [ "$v" ] && echo "CopyDir ${src} ${ROMFSDIR}${dst}"
    
59. (
    
60. cd ${src}
    
61. V=
    
62. [ "$v" ] && V=v
    
63. find . -print | grep -E -v '/CVS' | cpio -p${V}dumL ${ROMFSDIR}${dst}
    
64. )
    
65. else
    
66. rm -f ${ROMFSDIR}${dst}
    
67. [ "$v" ] && echo "cp ${src} ${ROMFSDIR}${dst}"
    
68. cp ${src} ${ROMFSDIR}${dst}
    
69. setperm ${ROMFSDIR}${dst}
    
70. fi
    
71. }
    
72. 
    
73. #############################################################################
    
74. 
    
75. file_append()
    
76. {
    
77. touch ${ROMFSDIR}${dst}
    
78. if [ -z "${pattern}" ] && grep -F "${src}" ${ROMFSDIR}${dst} > /dev/null
    
79. then
    
80. [ "$v" ] && echo "File entry already installed."
    
81. elif [ "${pattern}" ] && egrep "${pattern}" ${ROMFSDIR}${dst} > /dev/null
    
82. then
    
83. [ "$v" ] && echo "File pattern already installed."
    
84. else
    
85. [ "$v" ] && echo "Installing entry into ${ROMFSDIR}${dst}."
    
86. echo "${src}" >> ${ROMFSDIR}${dst}
    
87. fi
    
88. setperm ${ROMFSDIR}${dst}
    
89. }
    
90. 
    
91. #############################################################################
    
92. 
    
93. hard_link()
    
94. {
    
95. rm -f ${ROMFSDIR}${dst}
    
96. [ "$v" ] && echo "ln ${src} ${ROMFSDIR}${dst}"
    
97. ln ${src} ${ROMFSDIR}${dst}
    
98. }
    
99. 
    
100. #############################################################################
     
101. 
     
102. sym_link()
     
103. {
     
104. rm -f ${ROMFSDIR}${dst}
     
105. [ "$v" ] && echo "ln -s ${src} ${ROMFSDIR}${dst}"
     
106. ln -sf ${src} ${ROMFSDIR}${dst}
     
107. }
     
108. 
     
109. #############################################################################
     
110. #
     
111. # main program entry point
     
112. #
     
113. 
     
114. if [ -z "$ROMFSDIR" ]
     
115. then
     
116. echo "ROMFSDIR is not set" >&2
     
117. usage
     
118. exit 1
     
119. fi
     
120. # 测试是否设置了ROMFSDIR变量，外部在调用romfs-inst.sh时必须设置了ROMFSDIR变量
     
121. 
     
122. 
     
123. v=
     
124. option=y
     
125. pattern=
     
126. perm=
     
127. func=file_copy
     
128. src=
     
129. dst=
     
130. 
     
131. while getopts 've:o:A:p:a:l:s:' opt "$@"
     
132. do
     
133. case "$opt" in
     
134. v) v="1";                           ;;
     
135. o) option="$OPTARG";                ;;
     
136. e) eval option=\"\$$OPTARG\";       ;;
     
137. p) perm="$OPTARG";                  ;;
     
138. a) src="$OPTARG"; func=file_append; ;;
     
139. A) pattern="$OPTARG";               ;;
     
140. l) src="$OPTARG"; func=hard_link;   ;;
     
141. s) src="$OPTARG"; func=sym_link;    ;;
     
142. 
     
143. *)  break ;;
     
144. esac
     
145. #
     
146. # process option here to get an ANDing effect
     
147. #
     
148. case "$option" in
     
149. *[yY]*) # this gives OR effect, ie., nYn
     
150. ;;
     
151. *)
     
152. [ "$v" ] && echo "Condition not satisfied."
     
153. exit 0
     
154. ;;
     
155. esac
     
156. # 判断此处是否要执行动作。该判断是通过检查$option变量完成的，只要$option含有y或Y字符，那就认为要执行。因为这是在while循环中，如果命令行中含有多个o或e选项，意味着只要遇到一个就执行了，结果下来就是一个or操作。
     
157. done
     
158. 
     
159. shift `expr $OPTIND - 1`
     
160. # 经过shift语句，所有带选项的参数都将被移走，将只剩下最后1个或2个（正常情况下）参数，即$#值将从原来的$OPTIND或$OPTIND + 1变成不是1就是2，而$1和$2变为要被处理的文件
     
161. 
     
162. case $# in
     
163. 1)
     
164. dst="$1"
     
165. if [ -z "$src" ]
     
166. then
     
167. src="`basename $dst`"
     
168. # 命令行中没有src参数，源文件 = 执行romfs-inst.sh时当前目录 + $dst中基本文件名
     
169. fi
     
170. ;;
     
171. 2)
     
172. if [ ! -z "$src" ]
     
173. then
     
174. echo "Source file already provided" >&2
     
175. exit 1
     
176. fi
     
177. src="$1"
     
178. dst="$2"
     
179. ;;
     
180. # 命令行为中有src参数，此时src指出的文件必须不存在
     
181. *)
     
182. usage
     
183. ;;
     
184. esac
     
185. 
     
186. 
     
187. $func
     
188. 
     
189. exit 0
     
190. 
     
191. #############################################################################

复制代码

 

 

 

示例

/Makefile
ROMFSINST= romfs-inst.sh
进入此处时当前目录是/vendors/Qpixel/QL201
ROMFSDIR=/romfs

$(ROMFSINST) -s ../var/tmp/log /dev/log
建立符号链接，执行linux命令，ln -sf /vendors/Qpixel/var/tmp/log /romfs/dev/log。

$(ROMFSINST) -s ./bin /sbin
建立符号链接，执行linux命令，ln -sf /vendors/Qpixel/QL201/bin /romfs/sbin。

$(ROMFSINST) /etc/profile，（/vendors/Qpixel/QL201/etc/profile是目录）
把当前目录下的/etc/profile下除CVS目录的所有文件复制到ROMFS文件系统上。
执行CopyDIr /vendors/Qpixel/QL201/profile /romfs/etc/profile，具体到命令，find . -print | grep -E -v '/CVS' | cpio -pdumL /romfs/etc/profile

$(ROMFSINST) /etc/rc，（/vendors/Qpixel/QL201/etc/rc是文件）
删除ROMFS文件系统上的rc文件，把位于当前目录下的rc复到到文件系统上。
rm /romfs/etc/rc
cp /vendors/Qpixel/QL201/rc /romfs/etc/rc

 

 

原文请见: