Commit 4b0e5de4bfb268d2b92fc0c97eb2924d71a97739

Authored by Georg Hopp
1 parent 7348f990

add and virtualitemreceiver sources and modified for autoconf build system

1   - GNU GENERAL PUBLIC LICENSE
2   - Version 3, 29 June 2007
3   -
4   - Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/>
5   - Everyone is permitted to copy and distribute verbatim copies
6   - of this license document, but changing it is not allowed.
7   -
8   - Preamble
9   -
10   - The GNU General Public License is a free, copyleft license for
11   -software and other kinds of works.
12   -
13   - The licenses for most software and other practical works are designed
14   -to take away your freedom to share and change the works. By contrast,
15   -the GNU General Public License is intended to guarantee your freedom to
16   -share and change all versions of a program--to make sure it remains free
17   -software for all its users. We, the Free Software Foundation, use the
18   -GNU General Public License for most of our software; it applies also to
19   -any other work released this way by its authors. You can apply it to
20   -your programs, too.
21   -
22   - When we speak of free software, we are referring to freedom, not
23   -price. Our General Public Licenses are designed to make sure that you
24   -have the freedom to distribute copies of free software (and charge for
25   -them if you wish), that you receive source code or can get it if you
26   -want it, that you can change the software or use pieces of it in new
27   -free programs, and that you know you can do these things.
28   -
29   - To protect your rights, we need to prevent others from denying you
30   -these rights or asking you to surrender the rights. Therefore, you have
31   -certain responsibilities if you distribute copies of the software, or if
32   -you modify it: responsibilities to respect the freedom of others.
33   -
34   - For example, if you distribute copies of such a program, whether
35   -gratis or for a fee, you must pass on to the recipients the same
36   -freedoms that you received. You must make sure that they, too, receive
37   -or can get the source code. And you must show them these terms so they
38   -know their rights.
39   -
40   - Developers that use the GNU GPL protect your rights with two steps:
41   -(1) assert copyright on the software, and (2) offer you this License
42   -giving you legal permission to copy, distribute and/or modify it.
43   -
44   - For the developers' and authors' protection, the GPL clearly explains
45   -that there is no warranty for this free software. For both users' and
46   -authors' sake, the GPL requires that modified versions be marked as
47   -changed, so that their problems will not be attributed erroneously to
48   -authors of previous versions.
49   -
50   - Some devices are designed to deny users access to install or run
51   -modified versions of the software inside them, although the manufacturer
52   -can do so. This is fundamentally incompatible with the aim of
53   -protecting users' freedom to change the software. The systematic
54   -pattern of such abuse occurs in the area of products for individuals to
55   -use, which is precisely where it is most unacceptable. Therefore, we
56   -have designed this version of the GPL to prohibit the practice for those
57   -products. If such problems arise substantially in other domains, we
58   -stand ready to extend this provision to those domains in future versions
59   -of the GPL, as needed to protect the freedom of users.
60   -
61   - Finally, every program is threatened constantly by software patents.
62   -States should not allow patents to restrict development and use of
63   -software on general-purpose computers, but in those that do, we wish to
64   -avoid the special danger that patents applied to a free program could
65   -make it effectively proprietary. To prevent this, the GPL assures that
66   -patents cannot be used to render the program non-free.
67   -
68   - The precise terms and conditions for copying, distribution and
69   -modification follow.
70   -
71   - TERMS AND CONDITIONS
72   -
73   - 0. Definitions.
74   -
75   - "This License" refers to version 3 of the GNU General Public License.
76   -
77   - "Copyright" also means copyright-like laws that apply to other kinds of
78   -works, such as semiconductor masks.
79   -
80   - "The Program" refers to any copyrightable work licensed under this
81   -License. Each licensee is addressed as "you". "Licensees" and
82   -"recipients" may be individuals or organizations.
83   -
84   - To "modify" a work means to copy from or adapt all or part of the work
85   -in a fashion requiring copyright permission, other than the making of an
86   -exact copy. The resulting work is called a "modified version" of the
87   -earlier work or a work "based on" the earlier work.
88   -
89   - A "covered work" means either the unmodified Program or a work based
90   -on the Program.
91   -
92   - To "propagate" a work means to do anything with it that, without
93   -permission, would make you directly or secondarily liable for
94   -infringement under applicable copyright law, except executing it on a
95   -computer or modifying a private copy. Propagation includes copying,
96   -distribution (with or without modification), making available to the
97   -public, and in some countries other activities as well.
98   -
99   - To "convey" a work means any kind of propagation that enables other
100   -parties to make or receive copies. Mere interaction with a user through
101   -a computer network, with no transfer of a copy, is not conveying.
102   -
103   - An interactive user interface displays "Appropriate Legal Notices"
104   -to the extent that it includes a convenient and prominently visible
105   -feature that (1) displays an appropriate copyright notice, and (2)
106   -tells the user that there is no warranty for the work (except to the
107   -extent that warranties are provided), that licensees may convey the
108   -work under this License, and how to view a copy of this License. If
109   -the interface presents a list of user commands or options, such as a
110   -menu, a prominent item in the list meets this criterion.
111   -
112   - 1. Source Code.
113   -
114   - The "source code" for a work means the preferred form of the work
115   -for making modifications to it. "Object code" means any non-source
116   -form of a work.
117   -
118   - A "Standard Interface" means an interface that either is an official
119   -standard defined by a recognized standards body, or, in the case of
120   -interfaces specified for a particular programming language, one that
121   -is widely used among developers working in that language.
122   -
123   - The "System Libraries" of an executable work include anything, other
124   -than the work as a whole, that (a) is included in the normal form of
125   -packaging a Major Component, but which is not part of that Major
126   -Component, and (b) serves only to enable use of the work with that
127   -Major Component, or to implement a Standard Interface for which an
128   -implementation is available to the public in source code form. A
129   -"Major Component", in this context, means a major essential component
130   -(kernel, window system, and so on) of the specific operating system
131   -(if any) on which the executable work runs, or a compiler used to
132   -produce the work, or an object code interpreter used to run it.
133   -
134   - The "Corresponding Source" for a work in object code form means all
135   -the source code needed to generate, install, and (for an executable
136   -work) run the object code and to modify the work, including scripts to
137   -control those activities. However, it does not include the work's
138   -System Libraries, or general-purpose tools or generally available free
139   -programs which are used unmodified in performing those activities but
140   -which are not part of the work. For example, Corresponding Source
141   -includes interface definition files associated with source files for
142   -the work, and the source code for shared libraries and dynamically
143   -linked subprograms that the work is specifically designed to require,
144   -such as by intimate data communication or control flow between those
145   -subprograms and other parts of the work.
146   -
147   - The Corresponding Source need not include anything that users
148   -can regenerate automatically from other parts of the Corresponding
149   -Source.
150   -
151   - The Corresponding Source for a work in source code form is that
152   -same work.
153   -
154   - 2. Basic Permissions.
155   -
156   - All rights granted under this License are granted for the term of
157   -copyright on the Program, and are irrevocable provided the stated
158   -conditions are met. This License explicitly affirms your unlimited
159   -permission to run the unmodified Program. The output from running a
160   -covered work is covered by this License only if the output, given its
161   -content, constitutes a covered work. This License acknowledges your
162   -rights of fair use or other equivalent, as provided by copyright law.
163   -
164   - You may make, run and propagate covered works that you do not
165   -convey, without conditions so long as your license otherwise remains
166   -in force. You may convey covered works to others for the sole purpose
167   -of having them make modifications exclusively for you, or provide you
168   -with facilities for running those works, provided that you comply with
169   -the terms of this License in conveying all material for which you do
170   -not control copyright. Those thus making or running the covered works
171   -for you must do so exclusively on your behalf, under your direction
172   -and control, on terms that prohibit them from making any copies of
173   -your copyrighted material outside their relationship with you.
174   -
175   - Conveying under any other circumstances is permitted solely under
176   -the conditions stated below. Sublicensing is not allowed; section 10
177   -makes it unnecessary.
178   -
179   - 3. Protecting Users' Legal Rights From Anti-Circumvention Law.
180   -
181   - No covered work shall be deemed part of an effective technological
182   -measure under any applicable law fulfilling obligations under article
183   -11 of the WIPO copyright treaty adopted on 20 December 1996, or
184   -similar laws prohibiting or restricting circumvention of such
185   -measures.
186   -
187   - When you convey a covered work, you waive any legal power to forbid
188   -circumvention of technological measures to the extent such circumvention
189   -is effected by exercising rights under this License with respect to
190   -the covered work, and you disclaim any intention to limit operation or
191   -modification of the work as a means of enforcing, against the work's
192   -users, your or third parties' legal rights to forbid circumvention of
193   -technological measures.
194   -
195   - 4. Conveying Verbatim Copies.
196   -
197   - You may convey verbatim copies of the Program's source code as you
198   -receive it, in any medium, provided that you conspicuously and
199   -appropriately publish on each copy an appropriate copyright notice;
200   -keep intact all notices stating that this License and any
201   -non-permissive terms added in accord with section 7 apply to the code;
202   -keep intact all notices of the absence of any warranty; and give all
203   -recipients a copy of this License along with the Program.
204   -
205   - You may charge any price or no price for each copy that you convey,
206   -and you may offer support or warranty protection for a fee.
207   -
208   - 5. Conveying Modified Source Versions.
209   -
210   - You may convey a work based on the Program, or the modifications to
211   -produce it from the Program, in the form of source code under the
212   -terms of section 4, provided that you also meet all of these conditions:
213   -
214   - a) The work must carry prominent notices stating that you modified
215   - it, and giving a relevant date.
216   -
217   - b) The work must carry prominent notices stating that it is
218   - released under this License and any conditions added under section
219   - 7. This requirement modifies the requirement in section 4 to
220   - "keep intact all notices".
221   -
222   - c) You must license the entire work, as a whole, under this
223   - License to anyone who comes into possession of a copy. This
224   - License will therefore apply, along with any applicable section 7
225   - additional terms, to the whole of the work, and all its parts,
226   - regardless of how they are packaged. This License gives no
227   - permission to license the work in any other way, but it does not
228   - invalidate such permission if you have separately received it.
229   -
230   - d) If the work has interactive user interfaces, each must display
231   - Appropriate Legal Notices; however, if the Program has interactive
232   - interfaces that do not display Appropriate Legal Notices, your
233   - work need not make them do so.
234   -
235   - A compilation of a covered work with other separate and independent
236   -works, which are not by their nature extensions of the covered work,
237   -and which are not combined with it such as to form a larger program,
238   -in or on a volume of a storage or distribution medium, is called an
239   -"aggregate" if the compilation and its resulting copyright are not
240   -used to limit the access or legal rights of the compilation's users
241   -beyond what the individual works permit. Inclusion of a covered work
242   -in an aggregate does not cause this License to apply to the other
243   -parts of the aggregate.
244   -
245   - 6. Conveying Non-Source Forms.
246   -
247   - You may convey a covered work in object code form under the terms
248   -of sections 4 and 5, provided that you also convey the
249   -machine-readable Corresponding Source under the terms of this License,
250   -in one of these ways:
251   -
252   - a) Convey the object code in, or embodied in, a physical product
253   - (including a physical distribution medium), accompanied by the
254   - Corresponding Source fixed on a durable physical medium
255   - customarily used for software interchange.
256   -
257   - b) Convey the object code in, or embodied in, a physical product
258   - (including a physical distribution medium), accompanied by a
259   - written offer, valid for at least three years and valid for as
260   - long as you offer spare parts or customer support for that product
261   - model, to give anyone who possesses the object code either (1) a
262   - copy of the Corresponding Source for all the software in the
263   - product that is covered by this License, on a durable physical
264   - medium customarily used for software interchange, for a price no
265   - more than your reasonable cost of physically performing this
266   - conveying of source, or (2) access to copy the
267   - Corresponding Source from a network server at no charge.
268   -
269   - c) Convey individual copies of the object code with a copy of the
270   - written offer to provide the Corresponding Source. This
271   - alternative is allowed only occasionally and noncommercially, and
272   - only if you received the object code with such an offer, in accord
273   - with subsection 6b.
274   -
275   - d) Convey the object code by offering access from a designated
276   - place (gratis or for a charge), and offer equivalent access to the
277   - Corresponding Source in the same way through the same place at no
278   - further charge. You need not require recipients to copy the
279   - Corresponding Source along with the object code. If the place to
280   - copy the object code is a network server, the Corresponding Source
281   - may be on a different server (operated by you or a third party)
282   - that supports equivalent copying facilities, provided you maintain
283   - clear directions next to the object code saying where to find the
284   - Corresponding Source. Regardless of what server hosts the
285   - Corresponding Source, you remain obligated to ensure that it is
286   - available for as long as needed to satisfy these requirements.
287   -
288   - e) Convey the object code using peer-to-peer transmission, provided
289   - you inform other peers where the object code and Corresponding
290   - Source of the work are being offered to the general public at no
291   - charge under subsection 6d.
292   -
293   - A separable portion of the object code, whose source code is excluded
294   -from the Corresponding Source as a System Library, need not be
295   -included in conveying the object code work.
296   -
297   - A "User Product" is either (1) a "consumer product", which means any
298   -tangible personal property which is normally used for personal, family,
299   -or household purposes, or (2) anything designed or sold for incorporation
300   -into a dwelling. In determining whether a product is a consumer product,
301   -doubtful cases shall be resolved in favor of coverage. For a particular
302   -product received by a particular user, "normally used" refers to a
303   -typical or common use of that class of product, regardless of the status
304   -of the particular user or of the way in which the particular user
305   -actually uses, or expects or is expected to use, the product. A product
306   -is a consumer product regardless of whether the product has substantial
307   -commercial, industrial or non-consumer uses, unless such uses represent
308   -the only significant mode of use of the product.
309   -
310   - "Installation Information" for a User Product means any methods,
311   -procedures, authorization keys, or other information required to install
312   -and execute modified versions of a covered work in that User Product from
313   -a modified version of its Corresponding Source. The information must
314   -suffice to ensure that the continued functioning of the modified object
315   -code is in no case prevented or interfered with solely because
316   -modification has been made.
317   -
318   - If you convey an object code work under this section in, or with, or
319   -specifically for use in, a User Product, and the conveying occurs as
320   -part of a transaction in which the right of possession and use of the
321   -User Product is transferred to the recipient in perpetuity or for a
322   -fixed term (regardless of how the transaction is characterized), the
323   -Corresponding Source conveyed under this section must be accompanied
324   -by the Installation Information. But this requirement does not apply
325   -if neither you nor any third party retains the ability to install
326   -modified object code on the User Product (for example, the work has
327   -been installed in ROM).
328   -
329   - The requirement to provide Installation Information does not include a
330   -requirement to continue to provide support service, warranty, or updates
331   -for a work that has been modified or installed by the recipient, or for
332   -the User Product in which it has been modified or installed. Access to a
333   -network may be denied when the modification itself materially and
334   -adversely affects the operation of the network or violates the rules and
335   -protocols for communication across the network.
336   -
337   - Corresponding Source conveyed, and Installation Information provided,
338   -in accord with this section must be in a format that is publicly
339   -documented (and with an implementation available to the public in
340   -source code form), and must require no special password or key for
341   -unpacking, reading or copying.
342   -
343   - 7. Additional Terms.
344   -
345   - "Additional permissions" are terms that supplement the terms of this
346   -License by making exceptions from one or more of its conditions.
347   -Additional permissions that are applicable to the entire Program shall
348   -be treated as though they were included in this License, to the extent
349   -that they are valid under applicable law. If additional permissions
350   -apply only to part of the Program, that part may be used separately
351   -under those permissions, but the entire Program remains governed by
352   -this License without regard to the additional permissions.
353   -
354   - When you convey a copy of a covered work, you may at your option
355   -remove any additional permissions from that copy, or from any part of
356   -it. (Additional permissions may be written to require their own
357   -removal in certain cases when you modify the work.) You may place
358   -additional permissions on material, added by you to a covered work,
359   -for which you have or can give appropriate copyright permission.
360   -
361   - Notwithstanding any other provision of this License, for material you
362   -add to a covered work, you may (if authorized by the copyright holders of
363   -that material) supplement the terms of this License with terms:
364   -
365   - a) Disclaiming warranty or limiting liability differently from the
366   - terms of sections 15 and 16 of this License; or
367   -
368   - b) Requiring preservation of specified reasonable legal notices or
369   - author attributions in that material or in the Appropriate Legal
370   - Notices displayed by works containing it; or
371   -
372   - c) Prohibiting misrepresentation of the origin of that material, or
373   - requiring that modified versions of such material be marked in
374   - reasonable ways as different from the original version; or
375   -
376   - d) Limiting the use for publicity purposes of names of licensors or
377   - authors of the material; or
378   -
379   - e) Declining to grant rights under trademark law for use of some
380   - trade names, trademarks, or service marks; or
381   -
382   - f) Requiring indemnification of licensors and authors of that
383   - material by anyone who conveys the material (or modified versions of
384   - it) with contractual assumptions of liability to the recipient, for
385   - any liability that these contractual assumptions directly impose on
386   - those licensors and authors.
387   -
388   - All other non-permissive additional terms are considered "further
389   -restrictions" within the meaning of section 10. If the Program as you
390   -received it, or any part of it, contains a notice stating that it is
391   -governed by this License along with a term that is a further
392   -restriction, you may remove that term. If a license document contains
393   -a further restriction but permits relicensing or conveying under this
394   -License, you may add to a covered work material governed by the terms
395   -of that license document, provided that the further restriction does
396   -not survive such relicensing or conveying.
397   -
398   - If you add terms to a covered work in accord with this section, you
399   -must place, in the relevant source files, a statement of the
400   -additional terms that apply to those files, or a notice indicating
401   -where to find the applicable terms.
402   -
403   - Additional terms, permissive or non-permissive, may be stated in the
404   -form of a separately written license, or stated as exceptions;
405   -the above requirements apply either way.
406   -
407   - 8. Termination.
408   -
409   - You may not propagate or modify a covered work except as expressly
410   -provided under this License. Any attempt otherwise to propagate or
411   -modify it is void, and will automatically terminate your rights under
412   -this License (including any patent licenses granted under the third
413   -paragraph of section 11).
414   -
415   - However, if you cease all violation of this License, then your
416   -license from a particular copyright holder is reinstated (a)
417   -provisionally, unless and until the copyright holder explicitly and
418   -finally terminates your license, and (b) permanently, if the copyright
419   -holder fails to notify you of the violation by some reasonable means
420   -prior to 60 days after the cessation.
421   -
422   - Moreover, your license from a particular copyright holder is
423   -reinstated permanently if the copyright holder notifies you of the
424   -violation by some reasonable means, this is the first time you have
425   -received notice of violation of this License (for any work) from that
426   -copyright holder, and you cure the violation prior to 30 days after
427   -your receipt of the notice.
428   -
429   - Termination of your rights under this section does not terminate the
430   -licenses of parties who have received copies or rights from you under
431   -this License. If your rights have been terminated and not permanently
432   -reinstated, you do not qualify to receive new licenses for the same
433   -material under section 10.
434   -
435   - 9. Acceptance Not Required for Having Copies.
436   -
437   - You are not required to accept this License in order to receive or
438   -run a copy of the Program. Ancillary propagation of a covered work
439   -occurring solely as a consequence of using peer-to-peer transmission
440   -to receive a copy likewise does not require acceptance. However,
441   -nothing other than this License grants you permission to propagate or
442   -modify any covered work. These actions infringe copyright if you do
443   -not accept this License. Therefore, by modifying or propagating a
444   -covered work, you indicate your acceptance of this License to do so.
445   -
446   - 10. Automatic Licensing of Downstream Recipients.
447   -
448   - Each time you convey a covered work, the recipient automatically
449   -receives a license from the original licensors, to run, modify and
450   -propagate that work, subject to this License. You are not responsible
451   -for enforcing compliance by third parties with this License.
452   -
453   - An "entity transaction" is a transaction transferring control of an
454   -organization, or substantially all assets of one, or subdividing an
455   -organization, or merging organizations. If propagation of a covered
456   -work results from an entity transaction, each party to that
457   -transaction who receives a copy of the work also receives whatever
458   -licenses to the work the party's predecessor in interest had or could
459   -give under the previous paragraph, plus a right to possession of the
460   -Corresponding Source of the work from the predecessor in interest, if
461   -the predecessor has it or can get it with reasonable efforts.
462   -
463   - You may not impose any further restrictions on the exercise of the
464   -rights granted or affirmed under this License. For example, you may
465   -not impose a license fee, royalty, or other charge for exercise of
466   -rights granted under this License, and you may not initiate litigation
467   -(including a cross-claim or counterclaim in a lawsuit) alleging that
468   -any patent claim is infringed by making, using, selling, offering for
469   -sale, or importing the Program or any portion of it.
470   -
471   - 11. Patents.
472   -
473   - A "contributor" is a copyright holder who authorizes use under this
474   -License of the Program or a work on which the Program is based. The
475   -work thus licensed is called the contributor's "contributor version".
476   -
477   - A contributor's "essential patent claims" are all patent claims
478   -owned or controlled by the contributor, whether already acquired or
479   -hereafter acquired, that would be infringed by some manner, permitted
480   -by this License, of making, using, or selling its contributor version,
481   -but do not include claims that would be infringed only as a
482   -consequence of further modification of the contributor version. For
483   -purposes of this definition, "control" includes the right to grant
484   -patent sublicenses in a manner consistent with the requirements of
485   -this License.
486   -
487   - Each contributor grants you a non-exclusive, worldwide, royalty-free
488   -patent license under the contributor's essential patent claims, to
489   -make, use, sell, offer for sale, import and otherwise run, modify and
490   -propagate the contents of its contributor version.
491   -
492   - In the following three paragraphs, a "patent license" is any express
493   -agreement or commitment, however denominated, not to enforce a patent
494   -(such as an express permission to practice a patent or covenant not to
495   -sue for patent infringement). To "grant" such a patent license to a
496   -party means to make such an agreement or commitment not to enforce a
497   -patent against the party.
498   -
499   - If you convey a covered work, knowingly relying on a patent license,
500   -and the Corresponding Source of the work is not available for anyone
501   -to copy, free of charge and under the terms of this License, through a
502   -publicly available network server or other readily accessible means,
503   -then you must either (1) cause the Corresponding Source to be so
504   -available, or (2) arrange to deprive yourself of the benefit of the
505   -patent license for this particular work, or (3) arrange, in a manner
506   -consistent with the requirements of this License, to extend the patent
507   -license to downstream recipients. "Knowingly relying" means you have
508   -actual knowledge that, but for the patent license, your conveying the
509   -covered work in a country, or your recipient's use of the covered work
510   -in a country, would infringe one or more identifiable patents in that
511   -country that you have reason to believe are valid.
512   -
513   - If, pursuant to or in connection with a single transaction or
514   -arrangement, you convey, or propagate by procuring conveyance of, a
515   -covered work, and grant a patent license to some of the parties
516   -receiving the covered work authorizing them to use, propagate, modify
517   -or convey a specific copy of the covered work, then the patent license
518   -you grant is automatically extended to all recipients of the covered
519   -work and works based on it.
520   -
521   - A patent license is "discriminatory" if it does not include within
522   -the scope of its coverage, prohibits the exercise of, or is
523   -conditioned on the non-exercise of one or more of the rights that are
524   -specifically granted under this License. You may not convey a covered
525   -work if you are a party to an arrangement with a third party that is
526   -in the business of distributing software, under which you make payment
527   -to the third party based on the extent of your activity of conveying
528   -the work, and under which the third party grants, to any of the
529   -parties who would receive the covered work from you, a discriminatory
530   -patent license (a) in connection with copies of the covered work
531   -conveyed by you (or copies made from those copies), or (b) primarily
532   -for and in connection with specific products or compilations that
533   -contain the covered work, unless you entered into that arrangement,
534   -or that patent license was granted, prior to 28 March 2007.
535   -
536   - Nothing in this License shall be construed as excluding or limiting
537   -any implied license or other defenses to infringement that may
538   -otherwise be available to you under applicable patent law.
539   -
540   - 12. No Surrender of Others' Freedom.
541   -
542   - If conditions are imposed on you (whether by court order, agreement or
543   -otherwise) that contradict the conditions of this License, they do not
544   -excuse you from the conditions of this License. If you cannot convey a
545   -covered work so as to satisfy simultaneously your obligations under this
546   -License and any other pertinent obligations, then as a consequence you may
547   -not convey it at all. For example, if you agree to terms that obligate you
548   -to collect a royalty for further conveying from those to whom you convey
549   -the Program, the only way you could satisfy both those terms and this
550   -License would be to refrain entirely from conveying the Program.
551   -
552   - 13. Use with the GNU Affero General Public License.
553   -
554   - Notwithstanding any other provision of this License, you have
555   -permission to link or combine any covered work with a work licensed
556   -under version 3 of the GNU Affero General Public License into a single
557   -combined work, and to convey the resulting work. The terms of this
558   -License will continue to apply to the part which is the covered work,
559   -but the special requirements of the GNU Affero General Public License,
560   -section 13, concerning interaction through a network will apply to the
561   -combination as such.
562   -
563   - 14. Revised Versions of this License.
564   -
565   - The Free Software Foundation may publish revised and/or new versions of
566   -the GNU General Public License from time to time. Such new versions will
567   -be similar in spirit to the present version, but may differ in detail to
568   -address new problems or concerns.
569   -
570   - Each version is given a distinguishing version number. If the
571   -Program specifies that a certain numbered version of the GNU General
572   -Public License "or any later version" applies to it, you have the
573   -option of following the terms and conditions either of that numbered
574   -version or of any later version published by the Free Software
575   -Foundation. If the Program does not specify a version number of the
576   -GNU General Public License, you may choose any version ever published
577   -by the Free Software Foundation.
578   -
579   - If the Program specifies that a proxy can decide which future
580   -versions of the GNU General Public License can be used, that proxy's
581   -public statement of acceptance of a version permanently authorizes you
582   -to choose that version for the Program.
583   -
584   - Later license versions may give you additional or different
585   -permissions. However, no additional obligations are imposed on any
586   -author or copyright holder as a result of your choosing to follow a
587   -later version.
588   -
589   - 15. Disclaimer of Warranty.
590   -
591   - THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
592   -APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
593   -HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY
594   -OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
595   -THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
596   -PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM
597   -IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF
598   -ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
599   -
600   - 16. Limitation of Liability.
601   -
602   - IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
603   -WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS
604   -THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
605   -GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
606   -USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF
607   -DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
608   -PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS),
609   -EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF
610   -SUCH DAMAGES.
611   -
612   - 17. Interpretation of Sections 15 and 16.
613   -
614   - If the disclaimer of warranty and limitation of liability provided
615   -above cannot be given local legal effect according to their terms,
616   -reviewing courts shall apply local law that most closely approximates
617   -an absolute waiver of all civil liability in connection with the
618   -Program, unless a warranty or assumption of liability accompanies a
619   -copy of the Program in return for a fee.
620   -
621   - END OF TERMS AND CONDITIONS
622   -
623   - How to Apply These Terms to Your New Programs
624   -
625   - If you develop a new program, and you want it to be of the greatest
626   -possible use to the public, the best way to achieve this is to make it
627   -free software which everyone can redistribute and change under these terms.
628   -
629   - To do so, attach the following notices to the program. It is safest
630   -to attach them to the start of each source file to most effectively
631   -state the exclusion of warranty; and each file should have at least
632   -the "copyright" line and a pointer to where the full notice is found.
633   -
634   - <one line to give the program's name and a brief idea of what it does.>
635   - Copyright (C) <year> <name of author>
636   -
637   - This program is free software: you can redistribute it and/or modify
638   - it under the terms of the GNU General Public License as published by
639   - the Free Software Foundation, either version 3 of the License, or
640   - (at your option) any later version.
641   -
642   - This program is distributed in the hope that it will be useful,
643   - but WITHOUT ANY WARRANTY; without even the implied warranty of
644   - MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
645   - GNU General Public License for more details.
646   -
647   - You should have received a copy of the GNU General Public License
648   - along with this program. If not, see <http://www.gnu.org/licenses/>.
649   -
650   -Also add information on how to contact you by electronic and paper mail.
651   -
652   - If the program does terminal interaction, make it output a short
653   -notice like this when it starts in an interactive mode:
654   -
655   - <program> Copyright (C) <year> <name of author>
656   - This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
657   - This is free software, and you are welcome to redistribute it
658   - under certain conditions; type `show c' for details.
659   -
660   -The hypothetical commands `show w' and `show c' should show the appropriate
661   -parts of the General Public License. Of course, your program's commands
662   -might be different; for a GUI interface, you would use an "about box".
663   -
664   - You should also get your employer (if you work as a programmer) or school,
665   -if any, to sign a "copyright disclaimer" for the program, if necessary.
666   -For more information on this, and how to apply and follow the GNU GPL, see
667   -<http://www.gnu.org/licenses/>.
668   -
669   - The GNU General Public License does not permit incorporating your program
670   -into proprietary programs. If your program is a subroutine library, you
671   -may consider it more useful to permit linking proprietary applications with
672   -the library. If this is what you want to do, use the GNU Lesser General
673   -Public License instead of this License. But first, please read
674   -<http://www.gnu.org/philosophy/why-not-lgpl.html>.
... ... @@ -3,11 +3,14 @@ LIBS = $(INTLLIBS)
3 3
4 4 PROGS = gameserver
5 5
6   -INCLUDES = -I../include
  6 +# INCLUDES = -I./include
7 7
8 8 bin_PROGRAMS = $(PROGS)
9 9
10   -gameserver_SOURCES = gameserver.c
  10 +gameserver_SOURCES = gameserver.c clientClose.c clientRead.c \
  11 + daemonize.c handleCmdLine.c logRotate.c monitor.c \
  12 + serverInit.c serverRun.c serverShutdown.c signalHandling.c \
  13 + socket.c writeBuffer.c
11 14
12 15 # install: install-am
13 16 # strip -x $(DESTDIR)$(libdir)/libscot.so.0.0.2
... ...
  1 +#include <stdlib.h> /* for free() */
  2 +#include <unistd.h> /* for close() */
  3 +#include <sys/socket.h> /* for shutdown() */
  4 +#include <string.h> /* for memset and stuff */
  5 +
  6 +#include "include/appConfig.h"
  7 +#include "include/client.h"
  8 +#include "include/monitor.h"
  9 +
  10 +void clientClose(tClient * client)
  11 +{
  12 + if (0 != verbose) {
  13 + syslog(LOG_INFO, "closing socket for %s", client->remoteAddr);
  14 + }
  15 +
  16 + /* close socket an remove from fd_set */
  17 + shutdown(client->socket, SHUT_RDWR);
  18 + close(client->socket);
  19 +
  20 + /* free buffer */
  21 + free(client->buffer);
  22 + client->buffer = NULL;
  23 + client->socket = 0;
  24 + client->readPos = 0;
  25 + client->bufMult = 0;
  26 + memset(client->remoteAddr, 0, 16);
  27 +}
... ...
  1 +#include <unistd.h> /* for getopt */
  2 +#include <stdlib.h> /* for exit */
  3 +#include <string.h> /* for memset and stuff */
  4 +#include <errno.h> /* for errno */
  5 +
  6 +#include "include/client.h"
  7 +#include "include/monitor.h"
  8 +
  9 +#define GET_MULTIPLIER(size) (((size) - 1) / READBUFSIZE + 1)
  10 +int
  11 +_clientReallocBuffer(tClient * client, unsigned int newSize)
  12 +{
  13 + unsigned int newMult = GET_MULTIPLIER(newSize);
  14 +
  15 + if (CLIENTMULTMAX < newMult) {
  16 + /* line exceeds maximum line length */
  17 +
  18 + return 0;
  19 + }
  20 +
  21 + if (client->bufMult < newMult) {
  22 +
  23 + char * newBuffer = calloc(newMult * READBUFSIZE, sizeof(char));
  24 +
  25 + if (NULL == newBuffer) {
  26 +
  27 + syslogMonitor(LOG_ERR, MON_CRITICAL, "calloc",
  28 + "calloc for readbuffer[%s] failed",
  29 + client->remoteAddr);
  30 +
  31 + syslogMonitor(LOG_ERR, MON_FAILURE, "calloc",
  32 + "calloc for readbuffer[%s] failed - service terminated",
  33 + client->remoteAddr);
  34 +
  35 + exit(EXIT_FAILURE);
  36 + }
  37 +
  38 + if (NULL != client->buffer) {
  39 + memcpy(newBuffer, client->buffer, client->readPos);
  40 + free(client->buffer);
  41 + }
  42 +
  43 + client->buffer = newBuffer;
  44 + client->bufMult = newMult;
  45 + }
  46 +
  47 + return newMult;
  48 +}
  49 +
  50 +int clientRead(tClient * client)
  51 +{
  52 + int readSize;
  53 + char readBuf[READBUFSIZE];
  54 +
  55 + /*
  56 + * initialize values // read data from socket
  57 + */
  58 + memset(readBuf, 0, READBUFSIZE);
  59 + readSize = read(client->socket, readBuf, READBUFSIZE);
  60 +
  61 + switch (readSize) {
  62 + case -1:
  63 + syslogMonitor(LOG_WARNING, MON_WARNING, "socket.read",
  64 + "read returns -1 for client[%s]: %s - connection closed",
  65 + client->remoteAddr, strerror(errno));
  66 + break;
  67 +
  68 + case 0:
  69 + break;
  70 +
  71 + default:
  72 + if (!_clientReallocBuffer(client, client->readPos + readSize)) {
  73 +
  74 + syslogMonitor(LOG_WARNING, MON_WARNING, "data.longline",
  75 + "got to long line from client[%s] - connection closed",
  76 + client->remoteAddr);
  77 +
  78 + return READ_ERR_LONGLINE;
  79 + }
  80 +
  81 + memcpy(client->buffer+client->readPos, readBuf, readSize);
  82 + client->readPos += readSize;
  83 + break;
  84 + }
  85 +
  86 + return readSize;
  87 +}
... ...
  1 +#include <stdio.h> /* for printf() and fprintf() */
  2 +#include <unistd.h> /* for getopt */
  3 +#include <stdlib.h>
  4 +
  5 +
  6 +void daemonize(void) {
  7 + pid_t pid;
  8 +
  9 + if (0 > ((pid = fork()))) {
  10 + perror("deamoinze[fork]");
  11 + exit(EXIT_FAILURE);
  12 + } else if (0 != pid) {
  13 + exit(EXIT_SUCCESS);
  14 + }
  15 +
  16 + /* make new child session leader */
  17 + setsid();
  18 +
  19 + /* connect all standard streams to /dev/null */
  20 + freopen("/dev/null", "w", stderr);
  21 + freopen("/dev/null", "r", stdin);
  22 + freopen("/dev/null", "w", stdout);
  23 +}
... ...
1   -/***************************************************************************
2   - *
3   - * gameserver.c: This is a gameserver....more to come
4   - *
5   - * Copyright (C) 2009 Georg Steffers <georg@steffers.org>
6   - * This file is part of gameserver
7   - *
8   - * gameserver is free software: you can redistribute it and/or modify
9   - * it under the terms of the GNU General Public License as published by
10   - * the Free Software Foundation, either version 3 of the License, or
11   - * (at your option) any later version.
12   - *
13   - * This program is distributed in the hope that it will be useful,
14   - * but WITHOUT ANY WARRANTY; without even the implied warranty of
15   - * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16   - * GNU General Public License for more details.
17   - *
18   - * You should have received a copy of the GNU General Public License
19   - * along with this program. If not, see <http://www.gnu.org/licenses/>.
20   - *
21   - * Author: Georg Steffers (gst), georg@steffers.org
22   - *
23   - * Version: 0.0
24   - * Created: 16.08.2009 18:52:57
25   - * Revision: none
26   - *
27   - ***************************************************************************/
28   -
29   -
30   -/* #### HEADER FILE INCLUDES ######################################### */
31   -#include <stdio.h>
32   -#include <stdlib.h>
33   -
34   -/* #### MACROS - LOCAL TO THIS SOURCE FILE ######################### */
35   -
36   -/* #### TYPE DEFINITIONS - LOCAL TO THIS SOURCE FILE ############### */
37   -
38   -/* #### DATA TYPES - LOCAL TO THIS SOURCE FILE ##################### */
39   -
40   -/* #### VARIABLES - LOCAL TO THIS SOURCE FILE ###################### */
41   -
42   -/* #### PROTOTYPES - LOCAL TO THIS SOURCE FILE ##################### */
43   -
44   -/* #### FUNCTION DEFINITIONS - EXPORTED FUNCTIONS ################## */
45   -
46   -/* #### FUNCTION DEFINITIONS - LOCAL TO THIS SOURCE FILE ########### */
  1 +#include <string.h> /* for memset and stuff */
  2 +#include <syslog.h> /* for logging */
  3 +
  4 +#include "include/server.h"
  5 +#include "include/monitor.h"
  6 +#include "include/signalHandling.h"
  7 +#include "include/appConfig.h"
  8 +#include "include/daemonize.h"
  9 +
  10 +/* some global configurations */
  11 +/* TODO: make this whole stuff work without these globals */
  12 +unsigned char verbose;
  13 +unsigned char doGzip;
  14 +
47 15
48 16 int
49   -main ( int argc, char *argv[] )
  17 +main(int argc, char *argv[])
50 18 {
51   - printf ( "Hello World\n" );
52   -
53   - return EXIT_SUCCESS;
54   -} /* ---------- end of function main ---------- */
  19 + tVirtualItemServer server;
  20 +
  21 + tAppConfig appConfig = {
  22 + 0, // no verbose
  23 + 0, // no daemon
  24 + 0, // no gzip
  25 + MAXPENDING,
  26 + DEFAULTPORT,
  27 + DEFAULTPATH,
  28 + LOGNAMEPATTERN
  29 + };
  30 +
  31 + memset(&server, 0, sizeof(server));
  32 +
  33 + handleCmdLine(&appConfig, argc, argv);
  34 + verbose = appConfig.verbose;
  35 + doGzip = appConfig.doGzip;
  36 +
  37 + /* decouple procss from controlling shell and make it session leader */
  38 + if (appConfig.doDaemon) {
  39 + daemonize();
  40 + }
  41 + init_signals();
  42 + openlog(argv[0], LOG_PID, LOG_USER);
  43 +
  44 + syslogMonitor(LOG_INFO, MON_INFO, "startup", "service started");
  45 +
  46 + serverInit(
  47 + &server,
  48 + appConfig.port,
  49 + appConfig.maxPending,
  50 + appConfig.logPath,
  51 + appConfig.namePat);
  52 + serverRun(&server);
  53 + serverShutdown(&server);
  54 +
  55 + return 0;
  56 +}
... ...
  1 +#include <unistd.h> /* for getopt */
  2 +#include <stdlib.h>
  3 +#include <string.h>
  4 +#include <stdio.h>
  5 +
  6 +#include "include/appConfig.h"
  7 +
  8 +int
  9 +handleCmdLine(tAppConfig * config, int argc, char *argv[])
  10 +{
  11 + int opt;
  12 +
  13 + while ((opt = getopt(argc, argv, "Dvgp:l:n:b:")) != -1) {
  14 + switch (opt) {
  15 + case 'p':
  16 + /* port */
  17 + config->port = atoi(optarg);
  18 + break;
  19 +
  20 + case 'l':
  21 + /* logPath */
  22 + strncpy(config->logPath, optarg, sizeof(config->logPath)-1);
  23 + break;
  24 +
  25 + case 'n':
  26 + /* logNamePattern */
  27 + strncpy(config->namePat, optarg, sizeof(config->namePat)-1);
  28 + break;
  29 +
  30 + case 'b':
  31 + /* maxPending (connection backlog) */
  32 + config->maxPending = atoi(optarg);
  33 + break;
  34 +
  35 + case 'v':
  36 + /* verbose */
  37 + config->verbose = 1;
  38 + break;
  39 +
  40 + case 'g':
  41 + /* do gzip of data */
  42 + config->doGzip = 1;
  43 + break;
  44 +
  45 + case 'D':
  46 + /* verbose */
  47 + config->doDaemon = 1;
  48 + break;
  49 +
  50 + default:
  51 + /* '?' */
  52 + fprintf(
  53 + stderr,
  54 + "Usage: %s [-p port] [-l logPath] [-n logNamePattern] [-c maxClient] [-b backlog] [-v] [-D]\n"
  55 + "Defaults:\n"
  56 + "\t%-20s: port this service will use [%d]\n"
  57 + "\t%-20s: path where the logfiles will be stored [%s/]\n"
  58 + "\t%-20s: patten used by strftime to create the log filename [%s]\n"
  59 + "\t%-20s: maximum connection backlog [%d]\n"
  60 + "\t%-20s: be more verbose in syslog [off]\n"
  61 + "\t%-20s: deamonize me\n",
  62 + argv[0],
  63 + "-p port", DEFAULTPORT,
  64 + "-l logPath", DEFAULTPATH,
  65 + "-n logNamePattern", LOGNAMEPATTERN,
  66 + "-b backlog", MAXPENDING,
  67 + "-v",
  68 + "-D");
  69 + exit(EXIT_FAILURE);
  70 + }
  71 + }
  72 +
  73 + return 0;
  74 +}
... ...
  1 +#ifndef __APP_CONFIG_H__
  2 +#define __APP_CONFIG_H__
  3 +
  4 +#define MAXPENDING 10 /* Maximum outstanding connection requests */
  5 +#define MAXCLIENTS 1000 /* Maximum connection handled in paralell */
  6 +#define READBUFSIZE 2048 /* Size of receive buffer */
  7 +#define DEFAULTPORT 8801 /* default port for service */
  8 +#define DEFAULTPATH "logfiles"
  9 +#define LOGNAMEPATTERN "log-%Y-%m-%d_%Hh"
  10 +
  11 +typedef struct {
  12 + unsigned char verbose;
  13 + unsigned char doDaemon;
  14 + unsigned char doGzip;
  15 + unsigned int maxPending;
  16 + unsigned int port;
  17 + char logPath[513];
  18 + char namePat[513];
  19 +} tAppConfig;
  20 +
  21 +extern unsigned char verbose;
  22 +extern unsigned char doGzip;
  23 +
  24 +int
  25 +handleCmdLine(tAppConfig * config, int argc, char *argv[]);
  26 +
  27 +#endif // __APP_CONFIG_H__
... ...
  1 +#ifndef __CLIENT_H__
  2 +#define __CLIENT_H__
  3 +
  4 +#include <stdio.h> /* for FILE */
  5 +
  6 +#define READBUFSIZE 2048 /* Size of receive buffer */
  7 +#define CLIENTMULTMAX 512U /* 1MB maximum size the readbuffer may grow */
  8 +
  9 +#define WRITE_ERR_IO -1
  10 +#define WRITE_ERR_NOPRINT -2
  11 +
  12 +#define READ_ERR_LONGLINE -2
  13 +
  14 +typedef struct {
  15 + int socket;
  16 + char * buffer;
  17 + unsigned int readPos;
  18 + unsigned int bufMult;
  19 + char remoteAddr[16];
  20 +} tClient;
  21 +
  22 +
  23 +void clientClose(tClient *);
  24 +int clientRead(tClient *);
  25 +int writeRemaining(tClient *, FILE *);
  26 +int writeBuffer(tClient *, FILE *);
  27 +
  28 +#endif // __CLIENT_H__
... ...
  1 +#ifndef __DAEMONIZE_H__
  2 +#define __DAEMONIZE_H__
  3 +
  4 +void daemonize(void);
  5 +
  6 +#endif // __DAEMONIZE_H__
... ...
  1 +#ifndef __MONITOR_H__
  2 +#define __MONITOR_H__
  3 +
  4 +#include <syslog.h> /* for logging */
  5 +
  6 +#define MON_INFO 0
  7 +#define MON_WARNING 1
  8 +#define MON_CRITICAL 2
  9 +#define MON_FAILURE 3
  10 +
  11 +int monitor(unsigned int sev, const char * pattern, const char * message);
  12 +int syslogMonitor (unsigned int logLvl, unsigned int sev, const char *pattern, const char * message, ...) __attribute__ ((format (printf, 4, 5)));
  13 +
  14 +#endif /* __MONITOR_H__ */
... ...
  1 +#ifndef __SERVER_H__
  2 +#define __SERVER_H__
  3 +
  4 +#include <stdio.h> /* for printf() and fprintf() */
  5 +#include <sys/select.h> /* for select system call and related */
  6 +
  7 +#include "client.h"
  8 +
  9 +typedef struct {
  10 + int servSock;
  11 + tClient clients[FD_SETSIZE];
  12 + unsigned int maxFd;
  13 + fd_set socks;
  14 + char logPath[512];
  15 + char namePat[512];
  16 + FILE * wHandle;
  17 +} tVirtualItemServer;
  18 +
  19 +
  20 +void serverClose(tVirtualItemServer *);
  21 +void serverShutdown(tVirtualItemServer *);
  22 +void serverInit(
  23 + tVirtualItemServer *,
  24 + unsigned int,
  25 + unsigned int,
  26 + const char *,
  27 + const char *);
  28 +void serverRun(tVirtualItemServer *);
  29 +void logRotate(tVirtualItemServer *);
  30 +
  31 +#endif // __SERVER_H__
... ...
  1 +#ifndef __SIGNAL_HANDLING_H__
  2 +#define __SIGNAL_HANDLING_H__
  3 +
  4 +extern volatile int doShutdown;
  5 +
  6 +void terminate(int signum);
  7 +void init_signals(void);
  8 +
  9 +#endif // __SIGNAL_HANDLING_H__
  10 +
... ...
  1 +#ifndef __SOCKET_H__
  2 +#define __SOCKET_H__
  3 +
  4 +#include <arpa/inet.h> /* for in_port_t */
  5 +
  6 +int initServerSocket(in_port_t port, int backlog);
  7 +int acceptConnection(int servSock, char remoteAddr[16]);
  8 +
  9 +#endif /* __SOCKET_H__ */
... ...
  1 +#include <sys/select.h> /* for select system call and related */
  2 +#include <time.h>
  3 +#include <unistd.h> /* for fork and exec */
  4 +#include <sys/types.h>
  5 +#include <sys/wait.h> /* for wait */
  6 +#include <stdio.h> /* fopen and stuff */
  7 +#include <stdlib.h> /* exit */
  8 +#include <string.h> /* strncpy, memcpy, etc. */
  9 +#include <syslog.h>
  10 +#include <errno.h>
  11 +
  12 +#include "include/appConfig.h"
  13 +#include "include/monitor.h"
  14 +#include "include/server.h"
  15 +
  16 +
  17 +void
  18 +_gzip(tVirtualItemServer * server, const char * logName)
  19 +{
  20 + pid_t gzipPid = fork();
  21 +
  22 + switch(gzipPid) {
  23 + pid_t tmpPid;
  24 +
  25 + case 0:
  26 + /* first close everything in child */
  27 + serverClose(server);
  28 +
  29 + // We don't care about finishing of child, so decouple it
  30 + // by using a second child that stop immediatly
  31 + tmpPid = fork();
  32 + if (0 == tmpPid) {
  33 + syslog(LOG_INFO, "gzip: %s", logName);
  34 + // if (-1 == execl("/bin/gzip", "/bin/gzip", "-9", logName, (char *) 0)) {
  35 + if (-1 == execl("/bin/gzip", "/bin/gzip", logName, (char *) 0)) {
  36 + syslogMonitor(LOG_ERR, MON_WARNING, "logrotate.gzip",
  37 + "execl failed for gzip %s: %s", logName, strerror(errno));
  38 + }
  39 + }
  40 + exit(EXIT_SUCCESS);
  41 +
  42 + case -1:
  43 + syslogMonitor(LOG_ERR, MON_WARNING, "logrotate.fork",
  44 + "fork failed for gzip %s: %s", logName, strerror(errno));
  45 + break;
  46 +
  47 + default:
  48 + wait(NULL);
  49 + break;
  50 + }
  51 +}
  52 +
  53 +
  54 +void
  55 +logRotate(tVirtualItemServer * server)
  56 +{
  57 + static char logName[1024] = "";
  58 +
  59 + char strftimeName[128] = "";
  60 + char newLogName[1024] = "";
  61 +
  62 + time_t t;
  63 + struct tm *tmp;
  64 +
  65 + t = time(NULL);
  66 + tmp = localtime(&t);
  67 + if (tmp == NULL) {
  68 + syslogMonitor(LOG_ERR, MON_WARNING, "logrotate.localtime",
  69 + "can't get localtime for new logname. continue with old one");
  70 + return;
  71 + }
  72 +
  73 + if (strftime(
  74 + strftimeName,
  75 + sizeof(strftimeName)-1,
  76 + server->namePat,
  77 + tmp) == 0)
  78 + {
  79 + syslogMonitor(LOG_ERR, MON_WARNING, "logrotate.strftime",
  80 + "strftime returned 0 for new logname. continue with old one");
  81 + return;
  82 + }
  83 +
  84 + snprintf(
  85 + newLogName,
  86 + sizeof(newLogName)-1,
  87 + "%s/%s",
  88 + server->logPath,
  89 + strftimeName);
  90 +
  91 + if (0 != strncmp(logName, newLogName, sizeof(logName)-1)) {
  92 + if (0 != verbose) {
  93 + syslog(LOG_INFO, "actual logfile name: %s", logName);
  94 + syslog(LOG_INFO, "new logfile name: %s", newLogName);
  95 + }
  96 +
  97 + if (NULL != server->wHandle) {
  98 + fclose(server->wHandle);
  99 + server->wHandle = NULL;
  100 +
  101 + if (doGzip) {
  102 + _gzip(server, logName);
  103 + }
  104 + }
  105 +
  106 + strncpy(logName, newLogName, sizeof(logName)-1);
  107 + server->wHandle = fopen(logName, "w");
  108 + }
  109 +}
... ...
  1 +#include <stdlib.h> /* for system() */
  2 +#include <sys/wait.h>
  3 +#include <stdio.h>
  4 +#include <string.h>
  5 +#include <errno.h>
  6 +#include <signal.h>
  7 +#include <stdarg.h> /* for ellipse handling */
  8 +
  9 +#include "include/signalHandling.h"
  10 +#include "include/monitor.h"
  11 +
  12 +
  13 +#define MONITORCMD "/usr/bin/monitor"
  14 +#define MONITORTYPE "app"
  15 +#define MONITORNAME "virtualitem.logreceiver"
  16 +
  17 +const char severity[][10] = {
  18 + "info",
  19 + "warning",
  20 + "critical",
  21 + "failure"
  22 +};
  23 +
  24 +
  25 +int
  26 +monitor(
  27 + unsigned int sev,
  28 + const char * pattern,
  29 + const char * message
  30 +) {
  31 + char monCall[1024];
  32 + int ret;
  33 +
  34 + snprintf(monCall, 1023,
  35 + "%s %s %s.%s.%s \"%s\"",
  36 + MONITORCMD,
  37 + severity[sev],
  38 + MONITORTYPE,
  39 + MONITORNAME,
  40 + pattern,
  41 + message);
  42 +
  43 + ret = system(monCall);
  44 +
  45 + if (WIFSIGNALED(ret)) {
  46 + switch (WTERMSIG(ret)) {
  47 + case SIGINT:
  48 + case SIGQUIT:
  49 + syslog(LOG_INFO, "interrupted in monitor call");
  50 + doShutdown=1;
  51 + }
  52 + }
  53 +
  54 + if (-1 == ret || 0 != WEXITSTATUS(ret)) {
  55 + syslog(LOG_ERR, "call monitoring failed: %s", strerror(errno));
  56 + }
  57 +
  58 + return ret;
  59 +}
  60 +
  61 +/* this handles simple %d and %s replacements,
  62 + * complexer stuff must be prepared via snprintf
  63 + * the complete message should not extend 1024
  64 + * Bytes, else it will be truncated silently */
  65 +int
  66 +syslogMonitor(
  67 + unsigned int logLvl,
  68 + unsigned int sev,
  69 + const char * pattern,
  70 + const char * message,
  71 + ...
  72 +) {
  73 + va_list args;
  74 + char buffer[1025];
  75 + int maxBuf = sizeof(buffer)/sizeof(buffer[0]);
  76 +
  77 + memset(buffer, 0, maxBuf);
  78 +
  79 + va_start(args, message);
  80 + vsnprintf(buffer, 1024, message, args);
  81 + va_end(args);
  82 +
  83 + syslog(logLvl, "%s", buffer);
  84 + monitor(sev, pattern, buffer);
  85 +
  86 + return 0;
  87 +}
... ...
  1 +# Sed script that remove the POT-Creation-Date line in the header entry
  2 +# from a POT file.
  3 +#
  4 +# The distinction between the first and the following occurrences of the
  5 +# pattern is achieved by looking at the hold space.
  6 +/^"POT-Creation-Date: .*"$/{
  7 +x
  8 +# Test if the hold space is empty.
  9 +s/P/P/
  10 +ta
  11 +# Yes it was empty. First occurrence. Remove the line.
  12 +g
  13 +d
  14 +bb
  15 +:a
  16 +# The hold space was nonempty. Following occurrences. Do nothing.
  17 +x
  18 +:b
  19 +}
... ...
  1 +#include <sys/select.h> /* for select system call and related */
  2 +#include <string.h> /* for memset and stuff */
  3 +#include <stdlib.h> /* for getopt */
  4 +
  5 +#include "include/server.h"
  6 +#include "include/socket.h"
  7 +#include "include/monitor.h"
  8 +
  9 +void
  10 +serverInit(
  11 + tVirtualItemServer * server,
  12 + unsigned int port,
  13 + unsigned int pending,
  14 + const char * logPath,
  15 + const char * namePat)
  16 +{
  17 + FD_ZERO(&(server->socks));
  18 +
  19 + server->servSock = initServerSocket(port, pending);
  20 + server->maxFd = server->servSock;
  21 + FD_SET(server->servSock, &(server->socks));
  22 +
  23 + strncpy(server->logPath, logPath, sizeof(server->logPath)-1);
  24 + strncpy(server->namePat, namePat, sizeof(server->namePat)-1);
  25 +
  26 + memset(server->clients, 0, sizeof(server->clients));
  27 +
  28 + /*
  29 + * try to open file (firstrun)
  30 + */
  31 + if (NULL == server->wHandle) {
  32 + logRotate(server);
  33 + if (NULL == server->wHandle) {
  34 + syslogMonitor(LOG_ERR, MON_CRITICAL, "logfile.rotate",
  35 + "no valid handle for logfile");
  36 +
  37 + syslogMonitor(LOG_ERR, MON_FAILURE, "logfile.rotate",
  38 + "no valid handle for logfile - service terminated");
  39 +
  40 + exit(EXIT_FAILURE);
  41 + }
  42 + }
  43 +}
... ...
  1 +#include <sys/select.h> /* for select system call and related */
  2 +#include <string.h> /* for memset and stuff */
  3 +#include <stdlib.h> /* for exit */
  4 +#include <errno.h> /* for errno */
  5 +
  6 +#include "include/server.h"
  7 +#include "include/socket.h"
  8 +#include "include/monitor.h"
  9 +#include "include/signalHandling.h"
  10 +
  11 +#undef MAX
  12 +#define MAX(x,y) ((x) > (y) ? (x) : (y))
  13 +
  14 +void
  15 +serverRun(tVirtualItemServer * server)
  16 +{
  17 + syslogMonitor(LOG_INFO, MON_INFO, "startup", "service started");
  18 +
  19 + while (!doShutdown) /* until error or signal */
  20 + {
  21 + fd_set rfds;
  22 + int i;
  23 +
  24 + memcpy(&rfds, &(server->socks), sizeof(fd_set));
  25 +
  26 + /*
  27 + * wait for handles to become ready
  28 + */
  29 + if (-1 == select((server->maxFd)+1, &rfds, NULL, NULL, NULL))
  30 + {
  31 + switch (errno) {
  32 + default:
  33 + case EBADF:
  34 + case EINVAL:
  35 + case ENOMEM:
  36 + doShutdown = 1;
  37 + /* Fallthrough */
  38 +
  39 + case EINTR:
  40 + syslogMonitor(LOG_ERR, MON_CRITICAL, "select",
  41 + "select systemcall failed: [%s]",
  42 + strerror(errno));
  43 + syslogMonitor(LOG_ERR, MON_FAILURE, "select",
  44 + "select systemcall failed: [%s] - service terminated",
  45 + strerror(errno));
  46 + continue; /* in while loop above */
  47 + }
  48 + }
  49 +
  50 + /*
  51 + * update file to actual time
  52 + */
  53 + logRotate(server);
  54 + if (NULL == server->wHandle) {
  55 + syslogMonitor(LOG_ERR, MON_CRITICAL, "logfile.rotate",
  56 + "no valid handle for logfile - service terminated");
  57 + exit(EXIT_FAILURE);
  58 + }
  59 +
  60 + /*
  61 + * handle accept
  62 + */
  63 + if (FD_ISSET(server->servSock, &rfds)) {
  64 + int fd;
  65 + char remoteAddr[16] = "";
  66 +
  67 + if (-1 != (fd = acceptConnection(server->servSock, remoteAddr))) {
  68 + (server->clients)[fd].socket = fd; // save the socket handle
  69 + // within the client struct
  70 + //
  71 + strncpy(
  72 + (server->clients)[fd].remoteAddr,
  73 + remoteAddr,
  74 + sizeof((server->clients)[fd].remoteAddr)-1);
  75 + FD_SET(fd, &(server->socks));
  76 + server->maxFd = MAX(fd, server->maxFd);
  77 + }
  78 +
  79 + FD_CLR(server->servSock, &rfds);
  80 + }
  81 +
  82 + /* handle reads */
  83 + for (i=3; i<=server->maxFd; i++) {
  84 + if (FD_ISSET(i, &rfds)) {
  85 + switch (clientRead(&((server->clients)[i]))) {
  86 + case 0:
  87 + /*
  88 + * normal close: write remaining data
  89 + */
  90 + writeRemaining(
  91 + &((server->clients)[i]),
  92 + server->wHandle);
  93 + /* FALLTHROUGH */
  94 +
  95 + case -1:
  96 + /*
  97 + * read failure / close connection
  98 + * FALLTHROUGH
  99 + */
  100 +
  101 + case READ_ERR_LONGLINE:
  102 + /*
  103 + * detected very long line read from client
  104 + * message is already given now terminate connection
  105 + * FALLTHROUG
  106 + */
  107 + clientClose(&((server->clients)[i]));
  108 + FD_CLR(i, &(server->socks));
  109 + break;
  110 +
  111 + default:
  112 + if (0 > writeBuffer(
  113 + &((server->clients)[i]),
  114 + server->wHandle))
  115 + {
  116 + /*
  117 + * got IO Error or binary data
  118 + * the message is already monitored in client code
  119 + */
  120 + clientClose(&((server->clients)[i]));
  121 + FD_CLR(i, &(server->socks));
  122 + }
  123 + break;
  124 + }
  125 + }
  126 + }
  127 + }
  128 +}
... ...
  1 +#include <stdio.h> /* for printf() and fprintf() */
  2 +#include <sys/select.h> /* for select system call and related */
  3 +#include <sys/socket.h> /* for select system call and related */
  4 +#include <stdlib.h> /* for exit */
  5 +#include <string.h> /* for memset and stuff */
  6 +#include <unistd.h> /* for getopt */
  7 +#include <errno.h> /* for errno */
  8 +
  9 +#include "include/appConfig.h"
  10 +#include "include/server.h"
  11 +#include "include/monitor.h"
  12 +
  13 +
  14 +void
  15 +serverClose(tVirtualItemServer * server)
  16 +{
  17 + int i;
  18 +
  19 + for (i=3; i<=server->maxFd; i++) {
  20 + if (FD_ISSET(i, &(server->socks))) {
  21 + if (i == server->servSock) {
  22 + close(server->servSock);
  23 + } else {
  24 + close(((server->clients)[i]).socket);
  25 + free(((server->clients)[i]).buffer);
  26 + FD_CLR(i, &(server->socks));
  27 + }
  28 + }
  29 + }
  30 +
  31 + if (NULL != server->wHandle) {
  32 + fclose(server->wHandle);
  33 + }
  34 +}
  35 +
  36 +void
  37 +serverShutdown(tVirtualItemServer * server)
  38 +{
  39 + int i;
  40 +
  41 + for (i=3; i<=server->maxFd; i++) {
  42 + if (FD_ISSET(i, &(server->socks))) {
  43 + if (i == server->servSock) {
  44 + shutdown(server->servSock, SHUT_RDWR);
  45 + close(server->servSock);
  46 + } else {
  47 + writeBuffer(&(server->clients[i]), server->wHandle);
  48 + clientClose(&((server->clients)[i]));
  49 + FD_CLR(i, &(server->socks));
  50 + }
  51 + }
  52 + }
  53 +
  54 + if (NULL != server->wHandle) {
  55 + fclose(server->wHandle);
  56 + }
  57 +}
... ...
  1 +#include <signal.h> /* for signal() and signal names */
  2 +
  3 +#include "include/monitor.h"
  4 +
  5 +volatile int doShutdown;
  6 +
  7 +void terminate(int signum)
  8 +{
  9 + signal(signum, SIG_IGN);
  10 + syslogMonitor(LOG_INFO, MON_CRITICAL, "signals",
  11 + "caugth deadly signal %d", signum);
  12 + syslogMonitor(LOG_INFO, MON_FAILURE, "signals",
  13 + "caugth deadly signal %d - service terminated", signum);
  14 + doShutdown = 1;
  15 +}
  16 +
  17 +void init_signals(void)
  18 +{
  19 + signal(SIGTERM, terminate);
  20 + signal(SIGHUP, SIG_IGN);
  21 + signal(SIGINT, terminate);
  22 + signal(SIGQUIT, terminate);
  23 + signal(SIGABRT, terminate);
  24 + signal(SIGALRM, SIG_IGN);
  25 + signal(SIGURG, SIG_IGN);
  26 +
  27 + signal(SIGPIPE, SIG_IGN);
  28 +}
... ...
  1 +#include <stdio.h> /* for printf() and fprintf() */
  2 +#include <sys/types.h> /* SO_REUSEADDR */
  3 +#include <sys/socket.h> /* for socket(), bind(), and connect() */
  4 +#include <arpa/inet.h> /* for sockaddr_in and inet_ntoa() */
  5 +#include <stdlib.h> /* for atoi() and exit() */
  6 +#include <string.h> /* for memset() */
  7 +#include <unistd.h> /* for close() */
  8 +#include <errno.h> /* for errno */
  9 +#include <syslog.h>
  10 +
  11 +#include "include/appConfig.h"
  12 +#include "include/monitor.h"
  13 +
  14 +
  15 +int
  16 +initServerSocket(in_port_t port, int backlog)
  17 +{
  18 + int sock; /* socket descriptor for server */
  19 + struct sockaddr_in addr; /* Local address */
  20 +
  21 + int reUse = 1; /* TODO: make this configurable */
  22 +
  23 + /* Create socket for incoming connections */
  24 + if (-1 == (sock = socket(PF_INET, SOCK_STREAM, IPPROTO_TCP))) {
  25 + syslogMonitor(LOG_ERR, MON_CRITICAL, "server.socket",
  26 + "error opening socket: %s",
  27 + strerror(errno));
  28 + syslogMonitor(LOG_ERR, MON_FAILURE, "server.socket",
  29 + "error opening socket: %s - service terminated",
  30 + strerror(errno));
  31 + exit(EXIT_FAILURE);
  32 + }
  33 +
  34 + /* Make the socket REUSE a TIME_WAT socket */
  35 + setsockopt(sock, SOL_SOCKET, SO_REUSEADDR, &reUse, sizeof (reUse));
  36 +
  37 + /* Construct local address structure */
  38 + memset(&addr, 0, sizeof(addr)); /* Zero out structure */
  39 +
  40 + addr.sin_family = AF_INET; /* Internet address family */
  41 + addr.sin_addr.s_addr = htonl(INADDR_ANY); /* Any incoming interface */
  42 + addr.sin_port = htons(port); /* Local port */
  43 +
  44 + /* Bind to the local address */
  45 + if (-1 == bind(sock, (struct sockaddr *) &addr, sizeof(addr))) {
  46 + syslogMonitor(LOG_ERR, MON_CRITICAL, "server.bind",
  47 + "error binding socket: %s",
  48 + strerror(errno));
  49 + syslogMonitor(LOG_ERR, MON_FAILURE, "server.bind",
  50 + "error binding socket: %s - service terminated",
  51 + strerror(errno));
  52 + exit(EXIT_FAILURE);
  53 + }
  54 +
  55 + /* Mark the socket so it will listen for incoming connections */
  56 + if (-1 == listen(sock, backlog)) {
  57 + syslogMonitor(LOG_ERR, MON_CRITICAL, "server.listen",
  58 + "error binding socket: %s - service terminated",
  59 + strerror(errno));
  60 + syslogMonitor(LOG_ERR, MON_FAILURE, "server.listen",
  61 + "error binding socket: %s - service terminated",
  62 + strerror(errno));
  63 + exit(EXIT_FAILURE);
  64 + }
  65 +
  66 + return sock;
  67 +}
  68 +
  69 +int
  70 +acceptConnection(int servSock, char remoteAddr[16])
  71 +{
  72 + int sock; /* Socket descriptor for client */
  73 + struct sockaddr_in addr; /* Client address */
  74 + unsigned int len; /* Length of client address data structure */
  75 +
  76 + /* Set the size of the in-out parameter */
  77 + len = sizeof(addr);
  78 +
  79 + /* Wait for a client to connect */
  80 + if (-1 == (sock = accept(servSock, (struct sockaddr *) &addr, &len))) {
  81 + syslogMonitor(LOG_ERR, MON_WARNING, "server.accept",
  82 + "error acception connection: %s", strerror(errno));
  83 + } else {
  84 + strncpy (remoteAddr, inet_ntoa(addr.sin_addr), sizeof(remoteAddr)-1);
  85 + }
  86 +
  87 + /* clntSock is connected to a client! */
  88 + if (0 != verbose) {
  89 + syslog(LOG_INFO, "handling client %s\n", inet_ntoa(addr.sin_addr));
  90 + }
  91 +
  92 + return sock;
  93 +}
... ...
  1 +#include <stdio.h> /* for ferror() */
  2 +#include <string.h> /* for memset and stuff */
  3 +#include <errno.h> /* for errno */
  4 +#include <ctype.h> /* for isprint */
  5 +
  6 +#include "include/client.h"
  7 +#include "include/monitor.h"
  8 +
  9 +int
  10 +_handleIoError(FILE * wHandle)
  11 +{
  12 + if (ferror(wHandle)) {
  13 + switch (errno) {
  14 + case EIO:
  15 + /* FALLTHROUGHT */
  16 +
  17 + case ENOSPC:
  18 + syslogMonitor(LOG_ERR, MON_CRITICAL, "io.fatal",
  19 + "fatal IO error [%s]",
  20 + strerror(errno));
  21 +
  22 + syslogMonitor(LOG_ERR, MON_FAILURE, "io.fatal",
  23 + "fatal IO error [%s] - service terminated",
  24 + strerror(errno));
  25 +
  26 + break;
  27 + }
  28 +
  29 + return 1;
  30 + }
  31 +
  32 + return 0;
  33 +}
  34 +
  35 +int
  36 +_isPrintableBuffer(const char * buffer, size_t size, char * found)
  37 +{
  38 + while (isprint(*(buffer++)) && 1 < size--);
  39 +
  40 + if (0 == size) {
  41 + return 1;
  42 + } else {
  43 + *found = *(buffer-1);
  44 + return 0;
  45 + }
  46 +}
  47 +
  48 +int
  49 +_doWrite(tClient * client, size_t size, FILE * wHandle)
  50 +{
  51 + char found = '\0';
  52 +
  53 + if (NULL != client->buffer) {
  54 +
  55 + if (!_isPrintableBuffer(client->buffer, size, &found)) {
  56 + syslogMonitor(LOG_ERR, MON_WARNING, "data.binary",
  57 + "got non printable character[0x%02x] from client[%s] - connection closed",
  58 + found,
  59 + client->remoteAddr);
  60 +
  61 + return WRITE_ERR_NOPRINT;
  62 + }
  63 +
  64 + /* write remaining stuff to file */
  65 + fwrite(client->buffer, size, 1, wHandle);
  66 + if (_handleIoError(wHandle)) {
  67 + return WRITE_ERR_IO;
  68 + }
  69 +
  70 + fputc('\n', wHandle);
  71 + if (_handleIoError(wHandle)) {
  72 + return WRITE_ERR_IO;
  73 + }
  74 +
  75 + fflush(wHandle);
  76 + if (_handleIoError(wHandle)) {
  77 + return WRITE_ERR_IO;
  78 + }
  79 +
  80 + return size + 1;
  81 +
  82 + } else {
  83 +
  84 + return 0;
  85 +
  86 + }
  87 +}
  88 +
  89 +/*
  90 + * write all data that remains in buffer, even if its not terminated by
  91 + * a newline. Anyway ignore trailing newlines.
  92 + */
  93 +int
  94 +writeRemaining(tClient * client, FILE * wHandle)
  95 +{
  96 + int written = writeBuffer(client, wHandle);
  97 +
  98 + if (0 < client->readPos) {
  99 + unsigned int wLen = client->readPos;
  100 +
  101 + /* ignore trailing newlines */
  102 + while (0 < client->readPos && '\n' == client->buffer[wLen]) {
  103 + wLen--;
  104 + }
  105 +
  106 + written += _doWrite(client, wLen, wHandle);
  107 + }
  108 +
  109 + memset(client->buffer, 0, client->readPos);
  110 + client->readPos = 0;
  111 +
  112 + return written;
  113 +}
  114 +
  115 +/*
  116 + * write buffer till last newline is reached.
  117 + * If no newline is in buffer, nothing is written.
  118 + */
  119 +int
  120 +writeBuffer(tClient * client, FILE * wHandle)
  121 +{
  122 + char * nlpos = memchr(client->buffer, '\n', client->readPos);
  123 + int written = 0;
  124 +
  125 + while (NULL != nlpos) {
  126 + unsigned int moveSize, clearSize;
  127 + char * actAddr;
  128 +
  129 + if (nlpos > client->buffer) {
  130 + unsigned int wLen = nlpos - client->buffer;
  131 + int wTemp = _doWrite(client, wLen, wHandle);
  132 +
  133 + if (0 > wTemp) {
  134 + return wTemp;
  135 + }
  136 +
  137 + written += wTemp;
  138 + }
  139 +
  140 + actAddr = client->buffer + client->readPos;
  141 + moveSize = actAddr - nlpos - 1;
  142 + clearSize = actAddr - client->buffer - moveSize;
  143 +
  144 + memmove(client->buffer, nlpos+1, moveSize);
  145 + memset(client->buffer + moveSize, 0, clearSize);
  146 +
  147 + client->readPos = moveSize;
  148 +
  149 + nlpos = memchr(client->buffer, '\n', client->readPos);
  150 + }
  151 +
  152 + return written;
  153 +}
... ...
Please register or login to post a comment