Trap Probe Example

Trap Probe Example

The following example shows the handling of traps.




"type" = "custom-snmp-trap"
"package" = "com.dartware"
"probe_name" = "snmp.trapdisplay"
"human_name" = "Trap Viewer"
"version" = "2.2"
"address_type" = "IP,AT"
"port_number" = "161"
"display_name" = "SNMP/Trap Viewer"




\GB\Trap Viewer Probe\P\

This probe listens for trap packets to arrive and displays the contents of the
trap in the Status Window. It does not actively poll the device, nor does it
take any action based on the trap contents.

You can view all the variables that have been parsed from the trap packet in the
device's Status Window. You can also use this as a prototype for making your own
trap probes.

\B\How the Trap Viewer Probe Works\p\

When a trap arrives, the probe parses the trap to get the values from the trap's
header as well as the first ten items in its Varbind List. It assigns all these
values to variables that can be used in the probe and displayed in the Status
Window.

To see how this probe works, you can configure your equipment to send traps to
InterMapper, or use the net-snmp \b\snmptrap\p\ command. Either way, the Status
Window will show the values present in any traps that arrive.

For more information on the \b\snmptrap\p\ command, read the net-snmp
documentation for the
\u2=http://www.net-snmp.org/tutorial/tutorial-4/commands/snmptrap.html\trap
tutorial\p0\ and the
\u2=http://www.net-snmp.org/docs/man/snmpinform.html\snmptrap command\0p\. The
remainder of this note shows how to send a trap with variables from the Dartware
MIB:

\i\SNMPv1 Traps\p\

a) Add a device to a map with the IP address \i\192.168.56.78\p\
b) Set it to use this probe
c) Issue the snmptrap command below from the command line (it should all be on
one line):

snmptrap -v 1 -c commString localhost
1.3.6.1.4.1.6306 192.168.56.78 6 123 4567890
1.3.6.1.4.1.6306.2.1.1.0 s "05/08 23:26:35"
1.3.6.1.4.1.6306.2.1.2.0 s Critical
1.3.6.1.4.1.6306.2.1.3.0 s "Big Router"
1.3.6.1.4.1.6306.2.1.4.0 s "Critical: High Traffic"
1.3.6.1.4.1.6306.2.1.5.0 s "127.0.0.1"
1.3.6.1.4.1.6306.2.1.6.0 s "SNMP Traffic Probe"

\i\SNMPv2c Traps\p\

a) Add a device to the map with an IP address of \i\localhost\p\
b) Set it to use this probe
c) Issue the snmptrap command below from the command line (it should all be on
one line)

snmptrap -v 2c -c commString localhost
4567890 1.3.6.1.4.1.6306
1.3.6.1.4.1.6306 192.168.56.78 6 123 4567890
1.3.6.1.4.1.6306.2.1.1.0 s "05/08 13:26:35"
1.3.6.1.4.1.6306.2.1.2.0 s Critical
1.3.6.1.4.1.6306.2.1.3.0 s "Big Router"
1.3.6.1.4.1.6306.2.1.4.0 s "Critical: High Traffic"
1.3.6.1.4.1.6306.2.1.5.0 s "127.0.0.1"
1.3.6.1.4.1.6306.2.1.6.0 s "SNMP Traffic Probe"




-- The parameters in this probe are unused, but could be used to
-- set thresholds for various alarms.


"MinValue" = "10"
"MaxValue" = "50"




-- TrapVariables are updated when a trap arrives.
-- This set of variables comes from the Dartware MIB
-- and would be sent in a trap from another copy of InterMapper.

trapTimeStamp, 1.3.6.1.4.1.6306.2.1.1.0, TRAPVARIABLE, "Timestamp"
DeviceStatus, 1.3.6.1.4.1.6306.2.1.2.0, TRAPVARIABLE, "Status"
DeviceDNS, 1.3.6.1.4.1.6306.2.1.3.0, TRAPVARIABLE, "DNS Name of Device"
DeviceCondition, 1.3.6.1.4.1.6306.2.1.4.0, TRAPVARIABLE, "Condition String"
TrapSourceAdrs, 1.3.6.1.4.1.6306.2.1.5.0, TRAPVARIABLE, "Source of trap"
ProbeType, 1.3.6.1.4.1.6306.2.1.6.0, TRAPVARIABLE, "Probe that generated
trap"

-- Variables from the trap packet itself

genericTrapVar, $GenericTrap, TRAPVARIABLE, "Generic Trap"
specificTrapVar, $SpecificTrap, TRAPVARIABLE, "Specific Trap"
timeStampVar, $TimeStamp, TRAPVARIABLE, "Timestamp"
enterpriseVar, $Enterprise, TRAPVARIABLE, "Enterprise"
commStringVar, $CommunityString, TRAPVARIABLE, "Community String"
trapOIDVar, $TrapOID, TRAPVARIABLE, "Trap OID"
agentAdrsVar, $AgentAddress, TRAPVARIABLE, "Agent Address"
senderAdrsVar, $SenderAddress, TRAPVARIABLE, "Sender Address"
snmpVersionVar, $SnmpVersion, TRAPVARIABLE, "SNMP Version"
varbindCountVar, $VarbindCount, TRAPVARIABLE, "Varbind Count"

-- Positional names of Varbind List items

vbVal1, $VarbindValue1, TRAPVARIABLE, "Value of Varbind1"
vbType1, $VarbindType1, TRAPVARIABLE, "Type of Varbind1"
vbOID1, $VarbindOID1, TRAPVARIABLE, "OID of Varbind1"
vbVal2, $VarbindValue2, TRAPVARIABLE, "Value of Varbind2"
vbType2, $VarbindType2, TRAPVARIABLE, "Type of Varbind2"
vbOID2, $VarbindOID2, TRAPVARIABLE, "OID of Varbind2"
vbVal3, $VarbindValue3, TRAPVARIABLE, "Value of Varbind3"
vbType3, $VarbindType3, TRAPVARIABLE, "Type of Varbind3"
vbOID3, $VarbindOID3, TRAPVARIABLE, "OID of Varbind3"
vbVal4, $VarbindValue4, TRAPVARIABLE, "Value of Varbind4"
vbType4, $VarbindType4, TRAPVARIABLE, "Type of Varbind4"
vbOID4, $VarbindOID4, TRAPVARIABLE, "OID of Varbind4"
vbVal5, $VarbindValue5, TRAPVARIABLE, "Value of Varbind5"
vbType5, $VarbindType5, TRAPVARIABLE, "Type of Varbind5"
vbOID5, $VarbindOID5, TRAPVARIABLE, "OID of Varbind5"
vbVal6, $VarbindValue6, TRAPVARIABLE, "Value of Varbind6"
vbType6, $VarbindType6, TRAPVARIABLE, "Type of Varbind6"
vbOID6, $VarbindOID6, TRAPVARIABLE, "OID of Varbind6"
vbVal7, $VarbindValue7, TRAPVARIABLE, "Value of Varbind7"
vbType7, $VarbindType7, TRAPVARIABLE, "Type of Varbind7"
vbOID7, $VarbindOID7, TRAPVARIABLE, "OID of Varbind7"
vbVal8, $VarbindValue8, TRAPVARIABLE, "Value of Varbind8"
vbType8, $VarbindType8, TRAPVARIABLE, "Type of Varbind8"
vbOID8, $VarbindOID8, TRAPVARIABLE, "OID of Varbind8"
vbVal9, $VarbindValue9, TRAPVARIABLE, "Value of Varbind9"
vbType9, $VarbindType9, TRAPVARIABLE, "Type of Varbind9"
vbOID9, $VarbindOID9, TRAPVARIABLE, "OID of Varbind9"
vbVal10, $VarbindValue10, TRAPVARIABLE, "Value of Varbind10"
vbType10, $VarbindType10, TRAPVARIABLE, "Type of Varbind10"
vbOID10, $VarbindOID10, TRAPVARIABLE, "OID of Varbind10"





\B5\Information about the Trap\0P\
\4\CommunityString:\0\ $commStringVar
\4\ TimeStamp:\0\ $timeStampVar
\4\ AgentAddress:\0\ $agentAdrsVar
\4\ SenderAddress:\0\ $senderAdrsVar
\4\ GenericTrap:\0\ $genericTrapVar \3IG\(v1 only) \P0M\
\4\ SpecificTrap:\0\ $specificTrapVar \3IG\(v1 only) \P0M\
\4\ Enterprise:\0\ $enterpriseVar \3IG\(v1 only) \P0M\
\4\ TrapOID:\0\ $trapOIDVar \3IG\(v2c only) \P0M\
\4\ SnmpVersion:\0\ $snmpVersionVar \3IG\(0=SNMPv1; 1=SNMPv2c) \P0M\
\4\ VarbindCount:\0\ $varbindCountVar \3IG\(total number of Varbinds) \P0M\

\B5\Varbind List Items parsed by OID\0P\
\4\ TimeStamp:\0\ $trapTimeStamp \3IG\ \P0M\
\4\ Device Status:\0\ $deviceStatus \3IG\ \P0M\
\4\ Device DNS:\0\ $deviceDNS \3IG\ \P0M\
\4\Condition String:\0\ $deviceCondition \3IG\ \P0M\
\4\Trap Source Adrs:\0\ $TrapSourceAdrs \3IG\ \P0M\
\4\ Probe Type:\0\ $ProbeType \3IG\ \P0M\

\B5\Varbind List Items by Position\0P\ \3IG\(Varbind Value / Varbind Type /
Varbind OID) \P0M\
\4\ VarBindList #1:\0\ $vbVal1 / $vbType1 / $vbOID1
\4\ VarBindList #2:\0\ $vbVal2 / $vbType2 / $vbOID2
\4\ VarBindList #3:\0\ $vbVal3 / $vbType3 / $vbOID3
\4\ VarBindList #4:\0\ $vbVal4 / $vbType4 / $vbOID4
\4\ VarBindList #5:\0\ $vbVal5 / $vbType5 / $vbOID5
\4\ VarBindList #6:\0\ $vbVal6 / $vbType6 / $vbOID6
\4\ VarBindList #7:\0\ $vbVal7 / $vbType7 / $vbOID7
\4\ VarBindList #8:\0\ $vbVal8 / $vbType8 / $vbOID8
\4\ VarBindList #9:\0\ $vbVal9 / $vbType9 / $vbOID9
\4\VarBindList #10:\0\ $vbVal10 / $vbType10 / $vbOID10
本文是笔者学习net-snmp开发包时的心得,由于那个官方网站的东西比较乱,所以写一个总结,希望后来者少走些弯路


一,trap的用途

TRAP是提供从代理进程到管理站的异步报告机制。

为了使管理站能够及时而又有效地对被管理设备进行监控,同时又不过分增加网络的通信负载,必须使用陷入(TRAP)制导的轮讯过程。代理进程负责在必要时 向管理站报告异常事件,得到异常事件的报告后,管理站可以查询有关的代理,以便得到更具体的信息,对事件的原因做进一步的分析

二,trap的工作流程

1,agent端:

A, 编写mib文件,确定好trap名称等信息。

B, 命令方式:发送各种trap命令(manager地址后面一定要加端口号162),在manager端看反应结果,在agent端无反应

以下都未实现

C, 自动触发:配置snmpd.conf设置触发trap,系统发生某类错误时会自动触发相应类型的trap,发送给manager

D, 程序方式:一部份trap需要写c语言程序,用相应的api(send_easy_trap 或 send_v2trap)发送

2,manager端:

A, 配置snmptrapd.conf文件,设置访问权限

B, 将mib导入到mibs文件夹中

C, 用perl等脚本语言编写处理trap的程序

D, 配置snmptrapd.conf文件,添加traphandler项,将不同的trap对应到不同的处理程序上

三,trap的环境配置

1, manager端

a, 在/etc/hosts.allow加入允许接受的网段snmptrapd: 192.168.

b, 建立/usr/share/snmp/snmptrapd.conf(我的机器上是这个,不同机器不同,可能有的放在/etc/snmp,/usr/local/share/snmp/下,视不同情况慢慢实验),加入以下一行:

authcommunity execute|log|net public

设置所有用户的访问权限:可执行,记录,传递

四,命令方式的过程

1,处理系统默认的trap

添加以下几行到snmptrapd.conf中

traphandle .1.3.6.1.6.3.1.5.1 page_me up

traphandle .1.3.6.1.4.1.2021.251.1 page_me up

traphandle .1.3.6.1.4.1.2021.251.2 page_me down

traphandle default log_it

用snmptrapd –d –f –Lo启动snmptrapd

然后在agent端输入snmptrap -v 2c -c public 192.168.213.64:162 "" UCD-SNMP-MIB::ucdStart

Manager端反应:

NET-SNMP version 5.3.0.1



Received 73 bytes from UDP: [192.168.213.64]:32807

0000: 30 47 02 01 01 04 06 70 75 62 6C 69 63 A7 3A 02 0G.....public.:.

0016: 04 58 92 A4 F0 02 01 00 02 01 00 30 2C 30 10 06 .X.........0,0..

0032: 08 2B 06 01 02 01 01 03 00 43 04 03 E7 18 95 30 .+.......C.....0

0048: 18 06 0A 2B 06 01 06 03 01 01 04 01 00 06 0A 2B ...+...........+

0064: 06 01 04 01 8F 65 81 7B 01 .....e.{.



192.168.213.64 [UDP: [192.168.213.64]:32807]: Trap , DISMAN-EVENT-MIB::sysUpTimeInstance = Timeticks: (65476757) 7 days, 13:52:47.57, SNMPv2-MIB::snmpTrapOID.0 = OID: UCD-SNMP-MIB::ucdStart

sh: page_me: command not found

说明收到trap ucdstart并且调用对应的脚本程序,这里由于系统没有page_me这个命令,所以返回命令找不到

2, 处理自定义trap(参考http://www.net-snmp.org/wiki/index.php/TUT:snmptrap)

编写两个mib文件,包括snmp1和snmp2两种trap

Snmp1的mib:TRAP-TEST-MIB.txt

TRAP-TEST-MIB DEFINITIONS ::= BEGIN

IMPORTS ucdExperimental FROM UCD-SNMP-MIB;

demotraps OBJECT IDENTIFIER ::= { ucdExperimental 990 }

demo-trap TRAP-TYPE

STATUS current

ENTERPRISE demotraps

VARIABLES { sysLocation }

DESCRIPTION "This is just a demo"

::= 17

END

Snmp2的mib:NOTIFICATION-TEST-MIB.txt

NOTIFICATION-TEST-MIB DEFINITIONS ::= BEGIN

IMPORTS ucdavis FROM UCD-SNMP-MIB;

demonotifs OBJECT IDENTIFIER ::= { ucdavis 991 }

demo-notif NOTIFICATION-TYPE

STATUS current

OBJECTS { sysLocation }

DESCRIPTION "Just a test notification"

::= { demonotifs 17 }

END

然后放入到mibs文件夹中

在manager端敲入命令:

snmptrap -v 2c -c public 192.168.213.64:162 "" NOTIFICATION-TEST-MIB::demo-notif SNMPv2-MIB::sysLocation.0 s "just here"

agent端输出:

Received 96 bytes from UDP: [192.168.213.64]:32808

0000: 30 5E 02 01 01 04 06 70 75 62 6C 69 63 A7 51 02 0^.....public.Q.

0016: 04 17 27 54 32 02 01 00 02 01 00 30 43 30 10 06 ..'T2......0C0..

0032: 08 2B 06 01 02 01 01 03 00 43 04 03 F0 3A 1A 30 .+.......C...:.0

0048: 18 06 0A 2B 06 01 06 03 01 01 04 01 00 06 0A 2B ...+...........+

0064: 06 01 04 01 8F 65 87 5F 11 30 15 06 08 2B 06 01 .....e._.0...+..

0080: 02 01 01 06 00 04 09 6A 75 73 74 20 68 65 72 65 .......just here



192.168.213.64 [UDP: [192.168.213.64]:32808]: Trap , DISMAN-EVENT-MIB::sysUpTimeInstance = Timeticks: (66075162) 7 days, 15:32:31.62, SNMPv2-MIB::snmpTrapOID.0 = OID: UCD-SNMP-MIB::ucdavis.991.17, SNMPv2-MIB::sysLocation.0 = STRING: just here

sh: log_it: command not found

其中just here就是我们想要的结果

3, 自己编写处理trap脚本

建立root/bin/traps文件,输入以下内容

#!/bin/sh

read host

read ip

vars=

while read oid val

do

if [ "$vars" = "" ]

then

vars="$oid = $val"

else

vars="$vars, $oid = $val"

fi

done

echo trap: $1 $host $ip $vars



在manager的snmptrapd.conf加入以下几行

traphandle SNMPv2-MIB::coldStart /root/bin/traps cold

traphandle SNMPv2-MIB::warmStart /root/bin/traps warm

traphandle IF-MIB::linkDown /root/bin/traps down

traphandle IF-MIB::linkUp /root/bin/traps up

traphandle SNMPv2-MIB::authenticationFailure /root/bin/traps auth

# this one is deprecated

traphandle .1.3.6.1.6.3.1.1.5.6 /root/bin/traps egp-neighbor-loss



重启snmptrapd:snmptrapd –d –f –Lo 161这里要它监听161端口

在agent端输入命令:

snmptrap -v 1 -c public 192.168.213.64 TRAP-TEST-MIB::demotraps 192.168.213.64 2 0 ""IF-MIB::ifIndex i 1



manager端的反应:

Received 63 bytes from UDP: [192.168.213.64]:32812

0000: 30 3D 02 01 00 04 06 70 75 62 6C 69 63 A4 30 06 0=.....public.0.

0016: 0A 2B 06 01 04 01 8F 65 0D 87 5E 40 04 C0 A8 D5 .+.....e..^@....

0032: 40 02 01 02 02 01 00 43 04 03 F1 9E 99 30 10 30 @......C.....0.0

0048: 0E 06 09 2B 06 01 02 01 02 02 01 01 02 01 01 ...+...........



2007-08-07 12:54:43 192.168.213.64(via UDP: [192.168.213.64]:32812) TRAP, SNMP v1, community public

UCD-SNMP-MIB::ucdExperimental.990 Link Down Trap (0) Uptime: 7 days, 15:47:44.25

IF-MIB::ifIndex = INTEGER: 1

trap: down 192.168.213.64 UDP: [192.168.213.64]:32812 DISMAN-EVENT-MIB::sysUpTimeInstance = 7:15:47:44.25, SNMPv2-MIB::snmpTrapOID.0 = IF-MIB::linkDown, IF-MIB::ifIndex = 1, SNMP-COMMUNITY-MIB::snmpTrapAddress.0 = 192.168.213.64, SNMP-COMMUNITY-MIB::snmpTrapCommunity.0 = "public", SNMPv2-MIB::snmpTrapEnterprise.0 = UCD-SNMP-MIB::ucdExperimental.990

4, 让agent自动产生trap

配置agent的snmpd.conf,加入以下几行:(未搞出来,可能是配置文件问题,manager端收不到任何trap)

# send v1 traps

trapsink 192.168.213.64:162 public

# also send v2 traps

trap2sink 192.168.213.64:162 secret

# send traps on authentication failures

authtrapenable 1

五,下一步

仔细研究snmpd.conf和snmptrapd.conf,调试出系统自动触发trap

学习mib结构,搞清楚如何写自定义trap的mib

搞清楚例子的意思

研究一下在程序中发送trap的c语言api

学习perl,python等一种脚本语言,学会编写trap处理程序


五,程序方式

思路:让一个程序监控设备,如果设备产生了发送trap的条件,那么就编写一条snmptrap命令,新建一个进程将其发送出去。

本demo模拟这一过程,每2秒钟发送一条trap,用到的是上面最后一条命令:

snmptrap -v 1 -c public localhost:162 TRAP-TEST-MIB::demotraps localhost 2 0 "" IF-MIB::ifIndex i 1

manager端trap处理程序不变,mib不变。

Mytrap.c:



#include

#include



int main()

{

while(1){

int pid ;

int status;

if( (pid = fork()) == 0){

execl("/usr/bin/snmptrap","snmptrap","-v","1","-c","public","localhost:162","TRAP-TEST-MIB::demotraps","localhost","2","0","\"\"","IF-MIB::ifIndex","i","1",NULL);



printf("snmptrap\n");

return 0;

}

else if (pid <0){

perror("fork:");

}

else{

printf("send a trap\n");

sleep(2);

}

}

return 0;

}
S3C4510上嵌入式Web服务器-boa在uclinux下的的移植 uClinux下,主要有三个Web Server:httpd、thttpd和Boa。Httpd是最简单的一个Web Server,它的功能最弱,不支持认证,不支持CGI。Thttpd和Boa都支持认证、CGI等,功能都比较全。为了实现动态Web技术,这里我们选择实现一个支持CGI的、非常适合于嵌入式系统的Boa Web Server。
Boa 是一个单任务的http服务器,源代码开放、性能高。目前,uClinux的代码中已经包含boa的源代码,在uClinux下实现 Boa,需要对Boa做一些配置和修改。这主要通过对boa.conf和mime.types文件进行修改来实现,需要改动的配置有以下几项。
(1)建目录
由于uClinux默认的根文件系统romfs是只读的,不能用mkdir等命令来新建目录,故应在编译内核前先建好要用到的目录,这通过修改 /

uclinux-samsung/vendors/Samsung/4510b/makefile
ROMFS_DIRS=bin dev etc home lib mnt proc usr var的后边增加home/web home/web/cgi-bin

3.7
然后在/uclinux- samsung/Vendors/Samsung/4510b/inittab里修改,
在:inet:unknown:/bin/inetd后加入: boa:unknown:/bin/boac/home。


(2)指定Web服务器的根目录路径(SERVER_ROOT)

/uclinux-samsung/user/boa/src/目录,
通过修改define.h文件中#define ERVER_ROOT“/home”语句来指定SERVER_ROOT。

(3)修改boa.conf文件
3.1
在./uclinux-samsung/user/boa/src/boa.conf里修改:
*将user obody改为User 0
Group ogroup改为Group 0;

3.2
*将DocumentRoot/var/www
改为DocumentRoot/home/web,

3.4
*将MimeTypes/etc/mime.types
改为MimeTypes/home/web/mime.types;

3.5
定义默认首页和CGI程序所在目录,即

DirectoryIndex index.html
ScriptAlias/cgi-bin/ /home/web/cgi-bin/


这样指定后,.index.htm为远程浏览客户访问Web Server所看到的首页默认值,用C编写的CGI程序编译成二进制文件,放到/cgi-bin/目录下,CGI程序能被正确地执行。

3.6
Boa.conf文件和mime.types文件必须放到Web服务器根目录下,所以把修改后的bao.conf和mime.types拷贝到 “./uclinux-samsung/romfs/home/”目录下。


3.8
make menuconfig------>kernel--->user setting---->miscellaneous configuration--->generic cgi& cgihtml

配置过程后,重新编译内核,编译时选中Boa选项。把编译好的内核下载到开发 板,启动uClinux,完成IP配置,启动Boa Web Server,然后就可以通过IE访问你的网页了。如果想启动uClinux时自动启动Boa Web Server,可以修改rc文件,进入uclinux-samsung/vendors/Samsung/4510B目录,在运行脚本rc中增加两行:

ifconfig eth0 192.168.168.101 up
boa-c /home/&


修改后重新编译内核,再下载到开发板运行。运行uClinux后,不需要配置就可以直接通过IE来访问你的网页了。

===============================================================
uclinux中boa web server的配置
-----------------------------------------------------------------------------

uclinux中boa web server的配置
一、环境准备
编译环境:uClinux-dist-20040408.tar.gz
编译工具:arm-elf-*
板子型号:SmartArm2200

二、编译配置
1、选择Kernel/Library/Defaults Selection -> Customize Vendor/User Settings -> Network Applications -> boa并编译
2、配置boa web server:
2.1、修改文件uClinux-dist/user/boa/src/defines.h
将#define SERVER_ROOT "/home/httpd"改成#define SERVER_ROOT "/etc/boa"
意思是设定boa web server的ServerRoot路径为/etc/boa
2.2、编辑配置文件uClinux-dist/user/boa/examples/boa.conf,如下
Port 80
User 0
Group 0
DocumentRoot /var/www
UserDir public_html
DirectoryIndex index.html
KeepAliveMax 1000
KeepAliveTimeout 10
DefaultType text/html
AddType application/x-httpd-cgi cgi
ScriptAlias /cgi-bin/ /var/www/cgi-bin/
AddType image/jpeg jpg
关于配置文件的几点说明:
(1)所以的*Log选项都被注释掉了,否则启动boa的时候提示说不识别这些*Log标记;
(2)没有添加"mime.types"选项,原因详见boa测试图片显示乱码;
(3)配置文件boa.conf需拷贝到ServerRoot,可以手动,也可以通过修改Makefile文件(uClinux-dist/vendors/PHILIPS/lpc2200/Makefile)进行;
如果配置文件boa.conf的位置不正确,则会得到形如“Authentication password file for /cgi-bin/ not found!”之类的错误!

三、调试
1、如果现在运行boa & (或者运行boa -c /var/www &,但我们已指定DocumentRoot /var/www,所以运行外面的命令就行),会得到错误信息“kmod: failed to exec /sbin/modprobe -s -k net-pf-1, errno = 2”,此时boa web server还不可用!
2、增加编译Kernel/Library/Defaults Selection -> Customize Vendor/User Settings -> BusyBox -> modprobe并重新编译,此时运行boa &又会得到如下错误信息:
__alloc_pages: 6-order allocation failed (gfp=0x1f0/0)
Allocation of length 164704 from process 193 failed
Buffer memory: 52kB
Cache memory: 1076kB
Free pages: 876kB ( 0kB HighMem)
Zone:DMA freepages: 0kB
Zone:Normal freepages: 876kB
Zone:HighMem freepages: 0kB
( Active: 94, inactive: 188, free: 219 )
= 0kB)
25*4kB 21*8kB 12*16kB 5*32kB 2*64kB 1*128kB 0*256kB 0*512kB 0*1024kB 0*2048kB = 876kB)
= 0kB)
Unable to mmap process text, errno 12
kmod: failed to exec /sbin/modprobe -s -k net-pf-1, errno = 12
__alloc_pages: 6-order allocation failed (gfp=0x1f0/0)
Allocation of length 164704 from process 195 failed
Buffer memory: 52kB
Cache memory: 1076kB
Free pages: 700kB ( 0kB HighMem)
Zone:DMA freepages: 0kB
Zone:Normal freepages: 700kB
Zone:HighMem freepages: 0kB
( Active: 47, inactive: 235, free: 175 )
= 0kB)
25*4kB 19*8kB 12*16kB 4*32kB 2*64kB 0*128kB 0*256kB 0*512kB 0*1024kB 0*2048kB = 700kB)
= 0kB)
Unable to mmap process text, errno 12
munmap of non-mmaped memory by process 195 (insmod): 817fb000
munmap of non-mmaped memory by process 195 (insmod): 815863a0
Unhandled fault: external abort on linefetch (F4) at 0x00000001
fault-common.c(97): start_code=0x81380040, start_stack=0x815bff74)
pid 182: failed 256
好像是内存分配错误!但此时boa web server已经可以访问!
3、增加编译Kernel/Library/Defaults Selection -> Customize Kernel Settings -> Networking options -> Unix domain sockets并从新编译,则boa web server再启动时除了一个pid外,没任何多余的信息了!(此选项到底有什么作用,我还是不知道!)

四、其它说明
1、我的uclinux的大部分配置都是“默认”的,但这里的“默认”可能是已被硬件厂商修改过的(我用的uClinux-dist-20040408.tar.gz是附带光盘里面的)!
2、web测试时,html文件应放在/var/www目录下,cgi程序应放在/var/www/cgi-bin目录下,这些在配置文件中都写的很明确!
3、也可以通过nfs进行web测试(这样会免去多次烧写的麻烦),nfs的配置详见http://wzc0066.blog.hexun.com/6582493_d.html中的第一点。

五、现存问题
现在cgi、javascript、图片浏览等测试都良好!
但在测mp3的时候,还不行,原因可能是还不支持大文件!
我看网上说uclinux好像默认每次分配的最大内存是128K,所以要是运行大于128K的文件就会出错,不知是不是这样!

我还看到一条信息说选择Kernel hacking中的一项配置后就可支持大文件了,但我现在的2.4.x内核中没找到网上说的那一项!
现在点击一mp3文件(二点几M大小)的链接时终端出现的错误信息为:
Allocation of length 2502723 from process 24 failed
Buffer memory: 56kB
Cache memory: 2744kB
Free pages: 2420kB ( 0kB HighMem)
Zone:DMA freepages: 0kB
Zone:Normal freepages: 2420kB
Zone:HighMem freepages: 0kB
( Active: 98, inactive: 602, free: 605 )
= 0kB)
7*4kB 9*8kB 11*16kB 7*32kB 4*64kB 1*128kB 0*256kB 1*512kB 1*1024kB 0*2048kB = 2420kB)
= 0kB)
munmap of non-mmaped memory by process 24 (boa): ffffffff

现在虽然还不完美,但一般的使用我想还是没什么问题的!这就是我的boa web server配置的一般过程!
uClinux下的Web Server(主要是boa服务器)

uCLinux 环境下,主要有三个Web 服务器:httpd、thttpd和Boa。httpd是最简单的一个Web 服务器,它的功能最弱,不支持认证,不支持CGI。如果Web 服务器仅需提供一些静态页面,例如简单的在线帮助、系统介绍等,完全可以用静态服务器httpd来实现。thttpd和Boa都支持认证、CGI等,功能都比较全。若需提高系统的安全性,或需要与用户进行交互,例如数据查询、实时状态查询等,则必须使用动态Web技术,可以选择这两种服务器之一来实现。
1. uCLinux下静态Web 服务器的实现

httpd 是最简单的一个web 服务器,只有几百行代码,功能较弱。它的一些简单配置需要在Makefile和httpd.c的内部进行,文件位于/bb40/uCLinux- dist/user/httpd/目录下。Makefile中定义了缺省的documentDir为/home/httpd,缺省主页面文件为 index.html。uCLinux20031103版本的httpd.c中的main函数有如下两行程序:

chroot(HTTPD_DOCUMENT_ROOT);

chdir("/");

其中第二行程序将影响到实际运行结果,建议将该行程序直接指向index.html文件所在目录。将页面文件复制到\bb40\uCLinux-dist\romfs\home\httpd下即可。

对uCLinux 进行重新配置,并在用户程序中选中httpd,编译uCLinux内核并下载到开发板,在uclinx启动后通过httpd &命令即可启动服务器,如需自动启动,在\uCLinux-dist\vendors\Samsung\S3C44B0目录下的rc文件中加入同样的命令即可。
2.动态服务器与CGI

目前实现动态Web页面有多种技术可供选择,CGI、ASP、PHP等技术在高端平台上都能很好地实现用户所需的功能。但在uCLinux下实现动态网页,目前只能采用CGI。

CGI,Common Gate Interface,即通用网关接口,是一个连接外部应用程序到服务器的标准。一个简单的静态HTML文档是没有交互后台程序,而CGI程序则可以实时执行并输出动态信息。

使用CGI 需要一个输入界面,一般就是一个包含了表单(FORM)的页面。FORM在CGI中是最常被使用的输入界面,它由一组标签所组成,目前的标准中,FORM 的标签可分为三大类:INPUT、SELECT以及TEXTAREA。在设置了一系列有关的标签后,每个FORM通常需要一个SUBMIT按钮用来发送表单内容。

当用户在客户端按下FORM上的SUBMIT按钮,浏览器(Browser)将客户端输入的参数传回服务器,服务器启动指定的程序并将封装的参数传入,后台程序依照传入的参数完成指定的工作。如果此时有需要传回结果的话,则程序会把结果传回给服务器并发送到浏览器。
3.用boa实现uCLinux下的动态Web 服务器( www.boa.org)

用Boa来实现动态Web 服务器的方法较为复杂,主要通过boa.conf和mime.types进行,具体过程如下:

Boa 的关键配置由boa.conf文件决定,该文件是一个文本文件,内部除了各项设置还包含了详细的注释和说明。Boa.conf文件的注释中首先指出,为了在用户访问Web时服务器能确定根目录的位置,需要指定服务器的根目录路径服务器_ROOT。\uCLinux-dist\user\boa\src\目录下的define.h定义了服务器的根目录路径,通过修改define.h文件中#define ERVER_ROOT /home语句来指定服务器_ROOT。在uCLinux启动后通过命令行也可以指定该路径,且命令行所指定的路径具有更高的优先级,命令参数为-c加上欲指向的根目录路径,例如该文件中提供的例子:boa -c /usr/local/boa。

下面来配置一个简单的boa服务器。在\uCLinux-dist\user\boa\src\boa.conf里进行如下修改:

l 将user root改为User 0;

l 将Group root改为Group 0;

l 将DocumentRoot/etc改为DocumentRoot/home;

l 将MimeTypes/etc/mime.types改为MimeTypes/home/mime.types;

l 将#AddType application/x-httpd-cgi cgi前面的#去掉使系统可以支持cgi方式;

l 定义CGI程序所在目录:ScriptAlias/cgi-bin/ /home/cgi-bin/;

这样配置后的boa服务器将/home目录作为服务器的根目录,cgi程序位于\hone\cgi-bin目录下,默认页面文件为\home\index.html。

Boa.conf文件的注释中指出,boa.conf文件和mime.types文件必须放到Web服务器根目录下,本例中把mime.types和修改后的bao.conf复制到\uCLinux-dist\romfs\home\目录下。

在编译uCLinux 内核前还要通过修改\uCLinux-dist\vendors\Samsung\S3C44B0\目录下的makefile文件来建立cgi二进制文件将要被存放到的目录。在ROMFS_DIRS=bin dev etc home lib mnt proc usr var的后边增加home/cgi-bin,这样修改后编译内核,编译后生成的根文件系统\bb40\uCLinux-dist\romfs中将增加一个 \home\cgi-bin目录。

对uCLinux 进行重新配置,并在用户程序中选中boa项,编译uCLinux内核并下载到开发板,在uclinx启动后,通过boa -c/home/&命令即可启动服务器,如需自动启动,在rc文件中加入同样的命令即可。由于尚未放入cgi程序,此时仅能看到放在home目录下的页面,不会有任何动态响应。通过下面的例子将了解如何实现页面到CGI程序的关联。
4.一个通过动态Web页面访问远程温度传感器的例子

下面通过一个例子来说明如何实现uCLinux下的动态Web页面技术。

首先建立一个简单的表单页面:



输入需要访问的温度传感器号码,并单击“确定”查看。







CGI 规定,GET方式下的表单被发送到服务器后,表单中的数据被保存在QUERY_STRING环境变量中。这种表单的处理相对简单,只要读取环境变量就可以了。在CGI程序中使用库函数getenv来把环境变量的值作为一个字符串来读取,在取得了字符串中的数据后,就可以对数据进行需要的处理。CGI程序完成处理后的输出被重定向到客户浏览器,用户通过浏览器就可以看到相关结果。请注意,在ACTION后面所指向的CGI文件并没有扩展名。

下面就是处理这个表单的CGI程序mycgi.c:

#include

#include

int main(void){

char *data;

long m;

printf("Content-Type:text/html%c%c",10,10);

printf("温度传感器状态 ");

printf("

房间温度

");

data = getenv("QUERY_STRING");

if(sscanf(data,"m=%ld",&m)!=1)

printf("

错误!输入数据非法。表单中必须输入1~10的数字。");

else

printf("

%ld号房间的温度是:%ld度。",m,readtempr(m));

return 0;

}

其中的readtempr()是读取温度传感器输出的函数。在cygwin下使用arm-elf-gcc对该cgi源程序进行编译,获得mycgi.exe,将该程序复制到\uCLinux-dist\romfs\home\cgi-bin\目录下,确保前面的表单页面文件index.html位于\uCLinux-dist\romfs\home\目录里。编译内核并下载,下面两图是运行结果。
uClinux下的Web Server - raindy - 雨吧



运行结果说明:左图是访问IP为192.168.0.128的嵌入式服务器的结果,该服务器默认页面为index.html,浏览器显示为一个简单的表单。右图是在该表单输入传感器号5并按下“确定”按钮后,CGI程序执行后返回的结果。

==========================================

嵌入式Linux webserver: Boa+CGI程序设计技术[转]

-----------------------------------------

摘要:在详细介绍一种嵌入式Web服务器BOA的实现与配置方法的基础上,以一个Web在线远程监控GPIO(通用输入/输出)的程序为实例,介绍嵌入式Linux系统下CPU程序设计技术。

关键词:嵌入式系统Linux BOA CGI GPIO

1 概述

随着互联网应用的普及,越来越多的信息化产品需要接入互联网通过Web页面进行远程访问。嵌入式Web系统提供了一种经济、实用的互联网嵌入式接入方案。这里结合一种嵌入式Web Server BOA来介绍嵌入式Linux系统下的CGI程序设计技术。

2 Web Server BOA的实现与配置

2.1 uClinux下,主要有三个Web Server:HTTPD、THTTPD和BOA。HTTPD是最简单的一个Web Server,它的功能最弱,不支持认证,不支持CGI。THTTPD和BOA都支持认证、CGI等,功能都比较全。BOA是一个单任务的小型HTTP服务器,源代码开放、性能优秀,特别适合应用在嵌入式系统中。目前的uClinux的代码中已经包含BOA的源代码。在uClinux下实现BOA,只需要对BOA做一些配置和修改。以下是配置的过程。

(1)编译BOA到内核

首先,需要把BOA编译到内核,即执行make menuconfig,在应用程序选单中network application项下面选择boa。该操作需要重新编译内核。

(2)编制配置文件boa.conf

在Linux操作系统下,应用程序的配置都是以配置文件的形式提供的,一般都是放在目标板/etc/目录下或者/etc/config目录下。但boa的配置文件boa.conf一般都喜欢放在目标板/home/httpd/目录下。

例如,一个典型的boa.conf文件格式如下:

ServerName Samsung-ARM

DocumentRoot/home/httpd

ScriptAlias/cgi-bin/home/httpd/cgi-bin/

ScriptAlias/index.html/home/httpd/index.html

它指定了HTML页面必须放到/home/httpd目录下,cgi外部扩展程序必须放到/home/httpd/cgi-bin目录下。

(3)编译烧写内核

重新编译内核后,通过烧写工具烧写内核,就可以在PC上通过IE浏览器访问开发板上的 Web Server。例如,输入开发板的IP地址http://192.168.0.101,即可访问到自己做的网页index.html了。并且,通过编写 CGI外部扩展程序,可以实现动态Web技术,下面将详细介绍。

2.2 具有MMU平台的Linux下B0A的实现与配置

对于有MMU(内存管理单元)的平台,如armlinux和ppclinux,可以到网上下载一个主流版本的boa发行包。因为是运行在目标系统,所以要用交叉编译工具编译,即需要修改boa/src/Makefile里面的编译器。例如:

CC=/LinuxPPC/CDK/bin/powerpc-linux-gcc

CPP=/LinuxPPC/CDK/bin/powerpc-linux-g++

然后直接在boa/src目录下执行make,即可生成BOA可执行文件;将其编译入内核,并烧写到存储设备,就可以实现访问BOA服务器。

3 CGI程序设计技术

CGI(Common Gateway Interface)是外部应用扩展应用程序与WWW服务器交互的一个标准接口。按照CGI标准编写的外部扩展应用程序可以处理客户端浏览器输入的数据,从而完成客户端与服务器的交互操作。而CGI规范就定义了Web服务器如何向扩展应用程序发送消息,在收到扩展应用程序的信息后又如何进行处理等内容。通过CGI可以提供许多静态的HTML网页无法实现的功能,比如搜索引擎、基于Web的数据库访问等等。

3.1 工作原理

(1)WWW和CGI的工作原理

HTTP协议是WWW的基础,它基于客户/服务器模型,一个服务器可以为分布在网络中处的客户提供服务;它是建立在 TCP/IP协议之上的“无连接”协议,每次连接只处理一个请求。在服务器上,运行产着一个守护进程对端口进行监听,等待来自客户的请求。当一个请求到来时,将创建一个子进程为用户的连接服务。根据请求的不同,服务器返回HTML文件或者通过CGI调用外部应用程序,返回处理结果。服务器通过CGI与外部程序和脚本之间进行交互,根据客户端在进行请求时所采取的方法,服务器会收集客户所提供的信息,并将该部分信息发送给指定的 CGI扩展程序。CGI扩展程序进行信息处理并将结果返回服务器,然后服务器对信息进行分析,并将结果发送回客户端。

外部CGI程序与WWW服务器进行通信、传递有关参数和处理结果是通过环境变量、命令行参数和标准输入来进行的。服务器提供了客户端(浏览器)与CGI扩展程序之间的信息交换的通道。CGI的标准输入是服务器的标准输出,而CGI的标准输出是服务器的标准输入。客户的请求通过服务器的标准输出传送给CGI的标准输入,CGI对信息进行处理后,将结果发送到它的标准输入,然后由服务器将处理结果发送给客户端。

(2)URL编码

客户端浏览器向服务器发送数据采用编码的形式进行。该编码就是CRL编码。编码的主要工作是表单域的名字和值的转义,具体的做法为:每一对域和值里的空格都会被替换为一个加号(+)字符,不是字母或数字的字符将被替换为它们的十六进制数字形式,格式为%HH。HH是该字符的 ASCII十六进制值。
标签将被替换为“%0D%0A”。

信息是按它们在表单里出现的顺序排列的。数据域的名字和数据域的值通过等号(=)字符连在一起。各对名/值再通过“&”字符连接在一起。经过这些编码处理之后,表单信号就整个成为一个连续的字符流,里面包含着将被送往服务器的全部信息。

因为表单输入信息都是经过编码后传递给脚本程序的,所以CGI扩展程序在使用这些参数之前必须对它们进行解码。

3.2 CGI外部扩展程序编制

服务器程序可以通过三种途径接收信息:环境变量、命令行和标准输入。具体使用哪一种方法要由

标签的METHOD属性来决定。

在“METHOD=GET”时,向CGI程序传递表单编码信息的正常做法是通过命令来进行的。大多数表单编码信息都是通过 QUERY_STRING的环境变量来传递的。如果“METHOD=POST”,表单信息将通过标准输入来读取。还有一种不使用表单就可以向CGI传送信息的方法,那就是把信息直接追回在URL地址后面,信息和URL之间用问号(?)来分隔。

下面结合Web远程监控ARM芯片的GPIO(通用输入/输出)的应用实例详细介绍。

(1)GET方法

GET方法是对数据的一个请求,被用于获得静态文档。当使用GET方法时,CGI程序将会从环境变量 QUERY_STRING获取数据。为了处理客户端的请求,CGI必须对QUERY_STRING中的字符串进行分析。当需要从服务器获取数据并且不改变服务器上的数据时,应该选用GET方法;但是如果请求中包含的字符串超过了一定长度,一般是1024字节,那么就只能选用POST方法。GET 方法通过附加在URL后面的参数发送请求信息。这些参数将被放在环境变量QUERY_STRING中传给CGI程序。GET方法的表单格式和CGI解码程序可以参考POST方法的实现。

(2)POST方法

当浏览器将数据从一个填写的表单传给服务器时一般采用POST方法,而且在发送的数据超过 1024字节时也必须采用POST方法。当使用POST方法时,Web服务器向CGI程序的标准输入STDIN传送数据。发送的数据长度存在环境变量 CONTENT_LENGTH中,并且,POST方法的数据格式为:

variable1=value1&variable2=value2&etc

CGI程序必须检查REQUEST_METHOD环境变量以确定是否采用了POST方法,并决定是否要读取STDIN。POST方法在HTML文档中定义的表单如下:



Operate P0

Operate P1

Operate P2

NAME="cancel"TYPE=reset value="RESET">

它调用的服务器脚本程序是/cgi/bin/cgi_gpio.cgi。CGI扩展程序中form表单的解码可参考如下程序:

/*function getPOSTvars*/

char **getPOSTvars(){

int i;

int content_length;

char **postvars;

char *postinput;

char **pairlist;

int paircount=0;

chr *nvpair;

char *eqpos;

postinput=getenv("CONTENT_LENGTH");//获取传送给程序数据的字节数

if(!postinput)

exit();

if(!content_length=atoi(postinput))) //获取信息长度

exit(1);

if(!(postinput=(char*)malloc(content_length+1)))

exit(1);

if(!fread(postinput,content_length,1,stadin))

exit(1);

postinput[content_length]='0';

for(i=0;postinput[i];i++)

if(postinput[i]=='+')

postinput[i]=''; //对加易进行处理

pairlist=(char **)malloc(256*sizeof(char **));

paircount=0;

nvpair=strtok(postinput,"&");//从出现“&”字符的位置把信息分段,然后对结果依次处理

while (nvpair){

pairlist[paircount++]=strdup(nvpair);

if(!(paircount%256))

pairlist=(char**)realloc(pairlist,(paircount+256)*sizeof(char**));

nvpair=strtok(NULL,"&");

}

pairlist[paircount]=0;

postvars=(char**)malloc((paircount*2+1)*sizeof(char **));

for(i=0;i

if(eqpos=strchr(pairlist[i],'=')){

*eqpos='0';

unescape_url(postvars[i*2+1]=strdup(eqpos+1));//调用unescape_url函数继续解码

}else{

unescape_url(postvars[i*2+1])=strdup(""));

}

postvars[paircount*2]=0;

for(i=0;pairlist[i];i++)

free(pairlist[i]);

free(pairlist);

free(postinput);

return postvars;

}

其中,unescape_url函数再调用x2c函数,把(不是字节或数字的)特殊字符从其%HH表示方式解码为文本字符。

/*unescape_url function*/

static void unescape_url(char *url){

int x,y;

for(x=0,y=0;url[y];++x,++y){

if((url[x]=url[y])=='%'){

url[x]=x2c(&url[y+1]);

y+=2;

}

}

url[x]='0';

}

(3)直接URL加参数传递方法

这是一种不使用表单就可以向CGI传送信息的方法。它把信息直接追加在URL地址后面,信息和URL之间用号号(?)来分隔。例如,对于一个cgi_gpio.cgi的脚本,可以从如下的链接启动:



/*cgi-bin/cgi_gpio.cgi?flag=1 Operate P1



.

.

.

CGI扩展程序中可使用如下代码接收信息:char *get_input;//用于接收环境变量

.

.

.

get_input=getenv(“QUERY_STRING”);

if(get_input){

get_input=strdup(get_input);

printf("QUERY_STRING if %s",get_input);

}

/*判断flag=x信息*/

if(!strcmp(get_input,"flag=0")

...//Operate p0

else if(!strcmp(get_input,"flag=1")

...//Operate P1

else

...//Operate P2

对于上述三种方法,可以根据不同的应用场合和应用要求进行选取。

结语

嵌入式Web Server系统方案可以广泛应用在许多领域,如自动化设备的远程监控、嵌入式GSM短消息 平台以及远程家庭医疗等。并且,随着互联网应用领域的不断深入,嵌入式Internet技术将得到更为广泛的应用和发展。
嵌入式WEB服务器BOA和CGI
嵌入式WEB服务器常见的有
lighttpd
shttpd
thttpd
boa
mathopd
minihttpd
appweb
goahead
========================================================================
嵌入式WEB服务器BOA的移植方法(一)2007-2-26 16:20:00
随着Internet技术的兴起,在嵌入式设备的管理与交互中,基于Web方式的应用成为目前的主流,
这种程序结构也就是大家非常熟悉的B/S结构,即在 嵌入式设备上运行一个支持脚本或CGI功能的Web服务器,
能够生成动态页面,在用户端只需要通过Web浏览器就可以对嵌入式设备进行管理和监控,非常方 便实用。
本节主要介绍这种应用的开发和移植工作。
用户首先需要在嵌入式设备上成功移植支持脚本或CGI功能的Web服务器,然后才能进行应用程序的开发。
1、 嵌入式Web服务器移植 由于嵌入式设备资源一般都比较有限,并且也不需要能同时处理很多用户的请求,
因此不会使用Linux下最常用的如Apache 等服务器,而需要使用一些专门为嵌入式设备设计的Web服务器,
这些Web服务器在存贮空间和运行时所占有的内存空间上都会非常适合于嵌入式应用场合。
典型的嵌入式Web服务器有Boa (www.boa.org)和thttpd (http://www.acme.com/software/thttpd/)等,
它们和Apache等高性能的Web服务器主要的区别在于它们一般是 单进程服务器,只有在完成一个用户请求后才能响应
另一个用户的请求,而无法并发响应,但这在嵌入式设备的应用场合里已经足够了。
我们绍比较常用的Boa服务器的移植。
Boa是一个非常小巧的Web服务器,可执行代码只有约60KB。它是一个单任务Web服务器,只能依次完成用户的请求,
而不会fork出新的进程来处理 并发连接请求。但Boa支持CGI,能够为CGI程序fork出一个进程来执行。Boa的设计目标
是速度和安全,在其站点公布的性能测试中,Boa的性能 要好于Apache服务器。
第一步完成Boa程序的移植。从www.boa.org下载Boa源码,当前最新版本为0.94.13,将其解压并进入源码目录的src
子目录
# tar xzf boa-0.94.13.tar.gz
# cd boa-0.94.13/src
生成Makefile文件
# ./configure
修改Makefile文件,找到CC=gcc,将其改成CC = arm-linux-gcc,再找到CPP = gcc –E,
将其改成CPP = arm-linux-gcc –E,并保存退出。
然后运行make进行编译,得到的可执行程序为boa,将调试信息剥去,得到的最后程序只有约60KB大小。
# make
# arm-linux-strip boa
第二步完成Boa的配置,使其能够支持CGI程序的执行。Boa需要在/etc目录下建立一个boa目录,里面放入Boa的主要
配置文件boa.conf。在Boa源码目录下已有一个示例boa.conf,可以在其基础上进行修改,下面解释一下该文件的含义:
#监听的端口号,缺省都是80,一般无需修改
Port 80
# bind调用的IP地址,一般注释掉,表明绑定到INADDR_ANY,通配于服务器的所有IP地址
#Listen 192.68.0.5
#作为哪个用户运行,即它拥有该用户的权限,一般都是nobody,需要/etc/passwd中有
#nobody用户
User nobody
#作为哪个用户组运行,即它拥有该用户组的权限,一般都是nogroup,需要在/etc/group文
#件中有nogroup组
Group nogroup
#当服务器发生问题时发送报警的email地址,目前未用,注释掉
#ServerAdmin root@localhost
#错误日志文件。如果没有以/开始,则表示从服务器的根路径开始。如果不需要错误日志,
则用#/dev/null。在下面设置时,注意一定要建立/var/log/boa目录
ErrorLog /var/log/boa/error_log
#访问日志文件。如果没有以/开始,则表示从服务器的根路径开始。如果不需要错误日志,
则用#/dev/null或直接注释掉。在下面设置时,注意一定要建立/var/log/boa目录
#AccessLog /var/log/boa/access_log
#是否使用本地时间。如果没有注释掉,则使用本地时间。注释掉则使用UTC时间
#UseLocaltime
#是否记录CGI运行信息,如果没有注释掉,则记录,注释掉则不记录
#VerboseCGILogs
#服务器名字
ServerName www.hyesco.com
#是否启动虚拟主机功能,即设备可以有多个网络接口,每个接口都可以拥有一个虚拟的Web服
#务器。一般注释掉,即不需要启动
#VirtualHost
#非常重要,HTML文档的主目录。如果没有以/开始,则表示从服务器的根路径开始。
DocumentRoot /var/www
#如果收到一个用户请求的话,在用户主目录后再增加的目录名
UserDir public_html
#HTML目录索引的文件名,也是没有用户只指明访问目录时返回的文件名
DirectoryIndex index.html
#当HTML目录没有索引文件时,用户只指明访问目录时,boa会调用该程序生成索引文件然后
#返回给用户,因为该过程比较慢最好不执行,可以注释掉或者给每个HTML目录加上#DirectoryIndex指明的文件
#DirectoryMaker /usr/lib/boa/boa_indexer
#如果DirectoryIndex不存在,并且DirectoryMaker被注释,那么就用Boa自带的索引
#生成程序来生成目录的索引文件并输出到下面目录,该目录必须是Boa能读写
# DirectoryCache /var/spool/boa/dircache
#一个连接所允许的HTTP持续作用请求最大数目,注释或设为0都将关闭HTTP持续作用
KeepAliveMax 1000
#HTTP持续作用中服务器在两次请求之间等待的时间数,以秒为单位,超时将关闭连接
KeepAliveTimeout 10
#指明mime.types文件位置。如果没有以/开始,则表示从服务器的根路径开始。可以注释掉
#避免使用mime.types文件,此时需要用AddType在本文件里指明
MimeTypes /etc/mime.types
#文件扩展名没有或未知的话,使用的缺省MIME类型
DefaultType text/plain
#提供CGI程序的PATH环境变量值
CGIPath /bin:/usr/bin:/usr/local/bin
#将文件扩展名和MIME类型关联起来,和mime.types文件作用一样。如果用mime.types
#文件,则注释掉,如果不使用mime.types文件,则必须使用
#AddType application/x-httpd-cgi cgi
#指明文档重定向路径
#Redirect /bar http://elsewhere/feh/bar
#为路径加上别名
Alias /doc /usr/doc
#非常重要,指明CGI脚本的虚拟路径对应的实际路径。一般所有的CGI脚本都要放在实际路径
#里,用户访问执行时输入站点+虚拟路径+CGI脚本名
ScriptAlias /cgi-bin/ /var/www/cgi-bin/
用户可以根据自己需要,对boa.conf进行修改,但必须要保证其他的辅助文件和设置必须和boa.conf里的配置相符,
不然Boa就不能正常工作。 在上面的例子中,我们还需要创建日志文件所在目录/var/log/boa,
创建HTML文档的主目录/var/www,将mime.types文件拷贝 到/etc目录,
创建CGI脚本所在目录/var/www/cgi-bin/。mime.types文件用来指明不同文件扩展名对应的MIME类型,
一般 可以直接从Linux主机上拷贝一个,大部分也都是在主机的/etc目录下。
===================================================================

===================host test=======================================
1.进入 boa-0.94.13/src
./configure
make
2.在etc/下建立boa目录并将boa.conf拷贝到该目录下.更改boa.conf
Group nogroup ===》Group 0
3.在 /var/log/下建立boa目录,该目录下可以查看boa服务器的日志
4.其它的一些路径
默认是/var/www下的内容可以访问 (DocumentRoot /var/www)
默认cgi :ScriptAlias /cgi-bin/ /usr/lib/cgi-bin/ (cgi可执行程序放在 /usr/lib/cgi-bin/目录下)
例子http://201.201.201.249/cgi-bin/cgi-test.cgi
CGIPath /bin:/usr/bin:/usr/local/bin
只有这些目录下的命令可以被调用,如果要root的权限(如ifconfig配置ip)需要加上/sbin



=====================================================================
cgi例子
=====================================================================
//pass.c
#include
#include
#include

char* getcgidata(FILE* fp, char* requestmethod);
int main()
{
char *input;
char *req_method;
char name[64];
char pass[64];
int i = 0;
int j = 0;

// printf("Content-type: text/plain; charset=iso-8859-1\n\n");
printf("Content-type: text/html\n\n");
printf("The following is query reuslt:

");

req_method = getenv("REQUEST_METHOD");
input = getcgidata(stdin, req_method);

// 我们获取的input字符串可能像如下的形式
// Username="admin"&Password="aaaaa"
// 其中"Username="和"&Password="都是固定的
// 而"admin"和"aaaaa"都是变化的,也是我们要获取的

// 前面9个字符是UserName=
// 在"UserName="和"&"之间的是我们要取出来的用户名
for ( i = 9; i < (int)strlen(input); i++ )
{
if ( input[i] == '&' )
{
name[j] = '\0';
break;
}
name[j++] = input[i];
}

// 前面9个字符 + "&Password="10个字符 + Username的字符数
// 是我们不要的,故省略掉,不拷贝
for ( i = 19 + strlen(name), j = 0; i < (int)strlen(input); i++ )
{
pass[j++] = input[i];
}
pass[j] = '\0';

printf("Your Username is %s
Your Password is %s
\n", name, pass);

return 0;
}

char* getcgidata(FILE* fp, char* requestmethod)
{
char* input;
int len;
int size = 1024;
int i = 0;

if (!strcmp(requestmethod, "GET"))
{
input = getenv("QUERY_STRING");
return input;
}
else if (!strcmp(requestmethod, "POST"))
{
len = atoi(getenv("CONTENT_LENGTH"));
input = (char*)malloc(sizeof(char)*(size + 1));

if (len == 0)
{
input[0] = '\0';
return input;
}

while(1)
{
input[i] = (char)fgetc(fp);
if (i == size)
{
input[i+1] = '\0';
return input;
}

--len;
if (feof(fp) || (!(len)))
{
i++;
input[i] = '\0';
return input;
}
i++;

}
}
return NULL;
}


/*
* gcc -o pass.cgi pass.c
*/
//pass.html

用户登陆验证
















用户名
密  码




随着Internet技术的兴起,在嵌入式 设备的管理与交互中,基于Web方式的应用成为目前的主流,这种程序结构也就是大家非常熟悉的B/S结构,即在嵌入式设备上运行一个支持脚本或CGI功能 的Web服务器,能够生成动态页面,在用户端只需要通过Web浏览器就可以对嵌入式设备进行管理和监控,非常方便实用。本节主要介绍这种应用的开发和移植 工作。
用户首先需要在嵌入式设备上成功移植支持脚本或CGI功能的Web服务器,然后才能进行应用程序的开发。
1、嵌入式Web服务器移植由于嵌入式设备资源一般都比较有限,并且也不需要能同时处理很多用户的请求,因此不会使用Linux下最常用的如Apache 等服务器,而需要使用一些专门为嵌入式设备设计的Web服务器,这些Web服务器在存贮空间和运行时所占有的内存空间上都会非常适合于嵌入式应用场合。
典型的嵌入式Web服务器有Boa (www.boa.org)和thttpd (http://www.acme.com/software/thttpd/)等,它们和Apache等高性能的Web服务器主要的区别在于它们一般是 单进程服务器,只有在完成一个用户请求后才能响应另一个用户的请求,而无法并发响应,但这在嵌入式设备的应用场合里已经足够了。
我们绍比较常用的Boa服务器的移植。
Boa是一个非常小巧的Web服务器,可执行代码只有约60KB。它是一个单任务Web服务器,只能依次完成用户的请求,而不会fork出新的进程来处理 并发连接请求。但Boa支持CGI,能够为CGI程序fork出一个进程来执行。Boa的设计目标是速度和安全,在其站点公布的性能测试中,Boa的性能 要好于Apache服务器。
第一步完成Boa程序的移植。从www.boa.org下载Boa源码,当前最新版本为0.94.13,将其解压并进入源码目录的src子目录
# tar xzf boa-0.94.13.tar.gz
# cd boa-0.94.13/src
生成Makefile文件
# ./configure
修改Makefile文件,找到CC=gcc,将其改成CC = arm-linux-gcc,再找到CPP = gcc –E,将其改成CPP = arm-linux-gcc –E,并保存退出。
然后运行make进行编译,得到的可执行程序为boa,将调试信息剥去,得到的最后程序只有约60KB大小。
# make
# arm-linux-strip boa
第二步完成Boa的配置,使其能够支持CGI程序的执行。Boa需要在/etc目录下建立一个boa目录,里面放入Boa的主要配置文件 boa.conf。在Boa源码目录下已有一个示例boa.conf,可以在其基础上进行修改,下面解释一下该文件的含义:
#监听的端口号,缺省都是80,一般无需修改
Port 80
# bind调用的IP地址,一般注释掉,表明绑定到INADDR_ANY,通配于服务器的所有IP地址
#Listen 192.68.0.5
#作为哪个用户运行,即它拥有该用户的权限,一般都是nobody,需要/etc/passwd中有
nobody用户
User nobody
#作为哪个用户组运行,即它拥有该用户组的权限,一般都是nogroup,需要在/etc/group文
件中有nogroup组
Group nogroup
#当服务器发生问题时发送报警的email地址,目前未用,注释掉
#ServerAdmin root@localhost
#错误日志文件。如果没有以/开始,则表示从服务器的根路径开始。如果不需要错误日志,则用#/dev/null。在下面设置时,注意一定要建立/var/log/boa目录
ErrorLog /var/log/boa/error_log
#访问日志文件。如果没有以/开始,则表示从服务器的根路径开始。如果不需要错误日志,则用#/dev/null或直接注释掉。在下面设置时,注意一定要建立/var/log/boa目录
#AccessLog /var/log/boa/access_log
#是否使用本地时间。如果没有注释掉,则使用本地时间。注释掉则使用UTC时间
#UseLocaltime
#是否记录CGI运行信息,如果没有注释掉,则记录,注释掉则不记录
#VerboseCGILogs
#服务器名字
ServerName www.hyesco.com
#是否启动虚拟主机功能,即设备可以有多个网络接口,每个接口都可以拥有一个虚拟的Web服
#务器。一般注释掉,即不需要启动
#VirtualHost
#非常重要,HTML文档的主目录。如果没有以/开始,则表示从服务器的根路径开始。
DocumentRoot /var/www
#如果收到一个用户请求的话,在用户主目录后再增加的目录名
UserDir public_html
#HTML目录索引的文件名,也是没有用户只指明访问目录时返回的文件名
DirectoryIndex index.html
#当HTML目录没有索引文件时,用户只指明访问目录时,boa会调用该程序生成索引文件然后
返回给用户,因为该过程比较慢最好不执行,可以注释掉或者给每个HTML目录加上#DirectoryIndex指明的文件
#DirectoryMaker /usr/lib/boa/boa_indexer
如果DirectoryIndex不存在,并且DirectoryMaker被注释,那么就用Boa自带的索引
生成程序来生成目录的索引文件并输出到下面目录,该目录必须是Boa能读写
# DirectoryCache /var/spool/boa/dircache
#一个连接所允许的HTTP持续作用请求最大数目,注释或设为0都将关闭HTTP持续作用
KeepAliveMax 1000
#HTTP持续作用中服务器在两次请求之间等待的时间数,以秒为单位,超时将关闭连接
KeepAliveTimeout 10
#指明mime.types文件位置。如果没有以/开始,则表示从服务器的根路径开始。可以注释掉,
避免使用mime.types文件,此时需要用AddType在本文件里指明
MimeTypes /etc/mime.types
#文件扩展名没有或未知的话,使用的缺省MIME类型
DefaultType text/plain
#提供CGI程序的PATH环境变量值
CGIPath /bin:/usr/bin:/usr/local/bin
#将文件扩展名和MIME类型关联起来,和mime.types文件作用一样。如果用mime.types
文件,则注释掉,如果不使用mime.types文件,则必须使用
#AddType application/x-httpd-cgi cgi
#指明文档重定向路径
#Redirect /bar http://elsewhere/feh/bar
#为路径加上别名
Alias /doc /usr/doc
#非常重要,指明CGI脚本的虚拟路径对应的实际路径。一般所有的CGI脚本都要放在实际路径
里,用户访问执行时输入站点+虚拟路径+CGI脚本名
ScriptAlias /cgi-bin/ /var/www/cgi-bin/
用户可以根据自己需要,对boa.conf进行修改,但必须要保证其他的辅助文件和设置必须和boa.conf里的配置相符,不然Boa就不能正常工作。 在上面的例子中,我们还需要创建日志文件所在目录/var/log/boa,创建HTML文档的主目录/var/www,将mime.types文件拷贝 到/etc目录,创建CGI脚本所在目录/var/www/cgi-bin/。mime.types文件用来指明不同文件扩展名对应的MIME类型,一般 可以直接从Linux主机上拷贝一个,大部分也都是在主机的/etc目录下。

第三步就是测试Boa能否正常工作,静态HTML页面能否正常访问,CGI脚本能否正常运行,一般采用NFS方式来进行测试工作,可以将嵌入式目标系统上的/etc目录拷贝到主机的NFS共享目录下,然后将NFS共享目录下的etc目录重新NFS mount为目标系统上的/etc目录。这样就可以在主机上对etc目录下的各种配置文件,如进行修改而立刻在目标系统上生效。
假设主机/nfs目录为共享目录,在其下面建立一个www子目录作为Web站点的主目录,其内容如下:

# ls

cgi-bin images index.html

index.html为测试主页面,images为存放各种图片的子目录,cgi-bin为CGI脚本的存放目录。根据示例boa.conf的配置,目前 HTML文档的主目录为/var/www,CGI脚本目录为/var/www/cgi-bin,则运行以下命令将主机的/nfs/www目录mount成目标板上的/var/www目录。然后就可以运行boa了:
# mount -t nfs 192.168.67.1:/nfs/www /var/www -o nolock
# boa
在工作站上运行浏览器进行测试,在地址栏输入目标系统IP,即http://192.168.67.16 ,可以看到相关页面,表示静态HTML页面测试通过。
接下来进行CGI脚本的测试,我们需要一个测试用的CGI脚本。可以写个最简单的Hello World程序,示例代码如下

#include
void main() {
printf("Content-type: text/html\n\n") ;
printf("\n") ;
printf("CGI Output\n") ;
printf("\n") ;
printf("

Hello, world.

\n") ;
printf("\n") ;
printf("\n") ;
exit(0) ;
}
然后进行交叉编译,将得到的helloworld.cgi拷贝到主机的/nfs/www/cgi-bin目录下。
#arm-linux-gcc -o helloworld.cgi helloworld.c
#cp helloworld.cgi /nfs/www/cgi-bin
在浏览器地址栏输入http://192.168.67.16/cgi-bin/helloworld.cgi,可以看到相关页面,表示CGI脚本测试通过。
现在我们已经可以让Boa在嵌入式目标系统上正常工作了,嵌入式Web服务器移植成功。

在以上的移植过程中,最好设定boa.conf中的错误日志文件ErrorLog,允许Boa记录错误信息;
测试静态HTML页面和CGI脚本时,不管结果如何,最好都查看错误日志文件;
CGI脚本测试很容易发生权限不够的错误,要保证Boa访问的主目录、CGI脚本目录以及临时文件目录(如果没有设置TMP环境变量时,缺省是/tmp目录),都必须能被Boa运行时所代表的用户完全访问,该用户由boa.conf中的User指出。

Blogger Templates by Blog Forum