diff --git a/LICENSES/GPL-2.0-only.txt b/LICENSES/GPL-2.0-only.txt new file mode 100644 --- /dev/null +++ b/LICENSES/GPL-2.0-only.txt @@ -0,0 +1,319 @@ +GNU GENERAL PUBLIC LICENSE + +Version 2, June 1991 + +Copyright (C) 1989, 1991 Free Software Foundation, Inc. + +51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA + +Everyone is permitted to copy and distribute verbatim copies of this license +document, but changing it is not allowed. + +Preamble + +The licenses for most software are designed to take away your freedom to share +and change it. By contrast, the GNU General Public License is intended to +guarantee your freedom to share and change free software--to make sure the +software is free for all its users. This General Public License applies to +most of the Free Software Foundation's software and to any other program whose +authors commit to using it. (Some other Free Software Foundation software +is covered by the GNU Lesser General Public License instead.) You can apply +it to your programs, too. + +When we speak of free software, we are referring to freedom, not price. Our +General Public Licenses are designed to make sure that you have the freedom +to distribute copies of free software (and charge for this service if you +wish), that you receive source code or can get it if you want it, that you +can change the software or use pieces of it in new free programs; and that +you know you can do these things. + +To protect your rights, we need to make restrictions that forbid anyone to +deny you these rights or to ask you to surrender the rights. These restrictions +translate to certain responsibilities for you if you distribute copies of +the software, or if you modify it. + +For example, if you distribute copies of such a program, whether gratis or +for a fee, you must give the recipients all the rights that you have. You +must make sure that they, too, receive or can get the source code. And you +must show them these terms so they know their rights. + +We protect your rights with two steps: (1) copyright the software, and (2) +offer you this license which gives you legal permission to copy, distribute +and/or modify the software. + +Also, for each author's protection and ours, we want to make certain that +everyone understands that there is no warranty for this free software. If +the software is modified by someone else and passed on, we want its recipients +to know that what they have is not the original, so that any problems introduced +by others will not reflect on the original authors' reputations. + +Finally, any free program is threatened constantly by software patents. We +wish to avoid the danger that redistributors of a free program will individually +obtain patent licenses, in effect making the program proprietary. To prevent +this, we have made it clear that any patent must be licensed for everyone's +free use or not licensed at all. + +The precise terms and conditions for copying, distribution and modification +follow. + +TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION + +0. This License applies to any program or other work which contains a notice +placed by the copyright holder saying it may be distributed under the terms +of this General Public License. The "Program", below, refers to any such program +or work, and a "work based on the Program" means either the Program or any +derivative work under copyright law: that is to say, a work containing the +Program or a portion of it, either verbatim or with modifications and/or translated +into another language. (Hereinafter, translation is included without limitation +in the term "modification".) Each licensee is addressed as "you". + +Activities other than copying, distribution and modification are not covered +by this License; they are outside its scope. The act of running the Program +is not restricted, and the output from the Program is covered only if its +contents constitute a work based on the Program (independent of having been +made by running the Program). Whether that is true depends on what the Program +does. + +1. You may copy and distribute verbatim copies of the Program's source code +as you receive it, in any medium, provided that you conspicuously and appropriately +publish on each copy an appropriate copyright notice and disclaimer of warranty; +keep intact all the notices that refer to this License and to the absence +of any warranty; and give any other recipients of the Program a copy of this +License along with the Program. + +You may charge a fee for the physical act of transferring a copy, and you +may at your option offer warranty protection in exchange for a fee. + +2. You may modify your copy or copies of the Program or any portion of it, +thus forming a work based on the Program, and copy and distribute such modifications +or work under the terms of Section 1 above, provided that you also meet all +of these conditions: + +a) You must cause the modified files to carry prominent notices stating that +you changed the files and the date of any change. + +b) You must cause any work that you distribute or publish, that in whole or +in part contains or is derived from the Program or any part thereof, to be +licensed as a whole at no charge to all third parties under the terms of this +License. + +c) If the modified program normally reads commands interactively when run, +you must cause it, when started running for such interactive use in the most +ordinary way, to print or display an announcement including an appropriate +copyright notice and a notice that there is no warranty (or else, saying that +you provide a warranty) and that users may redistribute the program under +these conditions, and telling the user how to view a copy of this License. +(Exception: if the Program itself is interactive but does not normally print +such an announcement, your work based on the Program is not required to print +an announcement.) + +These requirements apply to the modified work as a whole. If identifiable +sections of that work are not derived from the Program, and can be reasonably +considered independent and separate works in themselves, then this License, +and its terms, do not apply to those sections when you distribute them as +separate works. But when you distribute the same sections as part of a whole +which is a work based on the Program, the distribution of the whole must be +on the terms of this License, whose permissions for other licensees extend +to the entire whole, and thus to each and every part regardless of who wrote +it. + +Thus, it is not the intent of this section to claim rights or contest your +rights to work written entirely by you; rather, the intent is to exercise +the right to control the distribution of derivative or collective works based +on the Program. + +In addition, mere aggregation of another work not based on the Program with +the Program (or with a work based on the Program) on a volume of a storage +or distribution medium does not bring the other work under the scope of this +License. + +3. You may copy and distribute the Program (or a work based on it, under Section +2) in object code or executable form under the terms of Sections 1 and 2 above +provided that you also do one of the following: + +a) Accompany it with the complete corresponding machine-readable source code, +which must be distributed under the terms of Sections 1 and 2 above on a medium +customarily used for software interchange; or, + +b) Accompany it with a written offer, valid for at least three years, to give +any third party, for a charge no more than your cost of physically performing +source distribution, a complete machine-readable copy of the corresponding +source code, to be distributed under the terms of Sections 1 and 2 above on +a medium customarily used for software interchange; or, + +c) Accompany it with the information you received as to the offer to distribute +corresponding source code. (This alternative is allowed only for noncommercial +distribution and only if you received the program in object code or executable +form with such an offer, in accord with Subsection b above.) + +The source code for a work means the preferred form of the work for making +modifications to it. For an executable work, complete source code means all +the source code for all modules it contains, plus any associated interface +definition files, plus the scripts used to control compilation and installation +of the executable. However, as a special exception, the source code distributed +need not include anything that is normally distributed (in either source or +binary form) with the major components (compiler, kernel, and so on) of the +operating system on which the executable runs, unless that component itself +accompanies the executable. + +If distribution of executable or object code is made by offering access to +copy from a designated place, then offering equivalent access to copy the +source code from the same place counts as distribution of the source code, +even though third parties are not compelled to copy the source along with +the object code. + +4. You may not copy, modify, sublicense, or distribute the Program except +as expressly provided under this License. Any attempt otherwise to copy, modify, +sublicense or distribute the Program is void, and will automatically terminate +your rights under this License. However, parties who have received copies, +or rights, from you under this License will not have their licenses terminated +so long as such parties remain in full compliance. + +5. You are not required to accept this License, since you have not signed +it. However, nothing else grants you permission to modify or distribute the +Program or its derivative works. These actions are prohibited by law if you +do not accept this License. Therefore, by modifying or distributing the Program +(or any work based on the Program), you indicate your acceptance of this License +to do so, and all its terms and conditions for copying, distributing or modifying +the Program or works based on it. + +6. Each time you redistribute the Program (or any work based on the Program), +the recipient automatically receives a license from the original licensor +to copy, distribute or modify the Program subject to these terms and conditions. +You may not impose any further restrictions on the recipients' exercise of +the rights granted herein. You are not responsible for enforcing compliance +by third parties to this License. + +7. If, as a consequence of a court judgment or allegation of patent infringement +or for any other reason (not limited to patent issues), conditions are imposed +on you (whether by court order, agreement or otherwise) that contradict the +conditions of this License, they do not excuse you from the conditions of +this License. If you cannot distribute so as to satisfy simultaneously your +obligations under this License and any other pertinent obligations, then as +a consequence you may not distribute the Program at all. For example, if a +patent license would not permit royalty-free redistribution of the Program +by all those who receive copies directly or indirectly through you, then the +only way you could satisfy both it and this License would be to refrain entirely +from distribution of the Program. + +If any portion of this section is held invalid or unenforceable under any +particular circumstance, the balance of the section is intended to apply and +the section as a whole is intended to apply in other circumstances. + +It is not the purpose of this section to induce you to infringe any patents +or other property right claims or to contest validity of any such claims; +this section has the sole purpose of protecting the integrity of the free +software distribution system, which is implemented by public license practices. +Many people have made generous contributions to the wide range of software +distributed through that system in reliance on consistent application of that +system; it is up to the author/donor to decide if he or she is willing to +distribute software through any other system and a licensee cannot impose +that choice. + +This section is intended to make thoroughly clear what is believed to be a +consequence of the rest of this License. + +8. If the distribution and/or use of the Program is restricted in certain +countries either by patents or by copyrighted interfaces, the original copyright +holder who places the Program under this License may add an explicit geographical +distribution limitation excluding those countries, so that distribution is +permitted only in or among countries not thus excluded. In such case, this +License incorporates the limitation as if written in the body of this License. + +9. The Free Software Foundation may publish revised and/or new versions of +the General Public License from time to time. Such new versions will be similar +in spirit to the present version, but may differ in detail to address new +problems or concerns. + +Each version is given a distinguishing version number. If the Program specifies +a version number of this License which applies to it and "any later version", +you have the option of following the terms and conditions either of that version +or of any later version published by the Free Software Foundation. If the +Program does not specify a version number of this License, you may choose +any version ever published by the Free Software Foundation. + +10. If you wish to incorporate parts of the Program into other free programs +whose distribution conditions are different, write to the author to ask for +permission. For software which is copyrighted by the Free Software Foundation, +write to the Free Software Foundation; we sometimes make exceptions for this. +Our decision will be guided by the two goals of preserving the free status +of all derivatives of our free software and of promoting the sharing and reuse +of software generally. + + NO WARRANTY + +11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY FOR +THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE +STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM +"AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, +BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS +FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE +OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME +THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION. + +12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING +WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE +THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY +GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE +OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA +OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES +OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH +HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. +END OF TERMS AND CONDITIONS + +How to Apply These Terms to Your New Programs + +If you develop a new program, and you want it to be of the greatest possible +use to the public, the best way to achieve this is to make it free software +which everyone can redistribute and change under these terms. + +To do so, attach the following notices to the program. It is safest to attach +them to the start of each source file to most effectively convey the exclusion +of warranty; and each file should have at least the "copyright" line and a +pointer to where the full notice is found. + + + +Copyright (C)< yyyy> + +This program is free software; you can redistribute it and/or modify it under +the terms of the GNU General Public License as published by the Free Software +Foundation; either version 2 of the License, or (at your option) any later +version. + +This program is distributed in the hope that it will be useful, but WITHOUT +ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS +FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. + +You should have received a copy of the GNU General Public License along with +this program; if not, write to the Free Software Foundation, Inc., 51 Franklin +Street, Fifth Floor, Boston, MA 02110-1301, USA. + +Also add information on how to contact you by electronic and paper mail. + +If the program is interactive, make it output a short notice like this when +it starts in an interactive mode: + +Gnomovision version 69, Copyright (C) year name of author Gnomovision comes +with ABSOLUTELY NO WARRANTY; for details type `show w'. This is free software, +and you are welcome to redistribute it under certain conditions; type `show +c' for details. + +The hypothetical commands `show w' and `show c' should show the appropriate +parts of the General Public License. Of course, the commands you use may be +called something other than `show w' and `show c'; they could even be mouse-clicks +or menu items--whatever suits your program. + +You should also get your employer (if you work as a programmer) or your school, +if any, to sign a "copyright disclaimer" for the program, if necessary. Here +is a sample; alter the names: + +Yoyodyne, Inc., hereby disclaims all copyright interest in the program `Gnomovision' +(which makes passes at compilers) written by James Hacker. + +, 1 April 1989 Ty Coon, President of Vice This General +Public License does not permit incorporating your program into proprietary +programs. If your program is a subroutine library, you may consider it more +useful to permit linking proprietary applications with the library. If this +is what you want to do, use the GNU Lesser General Public License instead +of this License. diff --git a/LICENSES/GPL-2.0-or-later.txt b/LICENSES/GPL-2.0-or-later.txt new file mode 100644 --- /dev/null +++ b/LICENSES/GPL-2.0-or-later.txt @@ -0,0 +1,319 @@ +GNU GENERAL PUBLIC LICENSE + +Version 2, June 1991 + +Copyright (C) 1989, 1991 Free Software Foundation, Inc. + +51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA + +Everyone is permitted to copy and distribute verbatim copies of this license +document, but changing it is not allowed. + +Preamble + +The licenses for most software are designed to take away your freedom to share +and change it. By contrast, the GNU General Public License is intended to +guarantee your freedom to share and change free software--to make sure the +software is free for all its users. This General Public License applies to +most of the Free Software Foundation's software and to any other program whose +authors commit to using it. (Some other Free Software Foundation software +is covered by the GNU Lesser General Public License instead.) You can apply +it to your programs, too. + +When we speak of free software, we are referring to freedom, not price. Our +General Public Licenses are designed to make sure that you have the freedom +to distribute copies of free software (and charge for this service if you +wish), that you receive source code or can get it if you want it, that you +can change the software or use pieces of it in new free programs; and that +you know you can do these things. + +To protect your rights, we need to make restrictions that forbid anyone to +deny you these rights or to ask you to surrender the rights. These restrictions +translate to certain responsibilities for you if you distribute copies of +the software, or if you modify it. + +For example, if you distribute copies of such a program, whether gratis or +for a fee, you must give the recipients all the rights that you have. You +must make sure that they, too, receive or can get the source code. And you +must show them these terms so they know their rights. + +We protect your rights with two steps: (1) copyright the software, and (2) +offer you this license which gives you legal permission to copy, distribute +and/or modify the software. + +Also, for each author's protection and ours, we want to make certain that +everyone understands that there is no warranty for this free software. If +the software is modified by someone else and passed on, we want its recipients +to know that what they have is not the original, so that any problems introduced +by others will not reflect on the original authors' reputations. + +Finally, any free program is threatened constantly by software patents. We +wish to avoid the danger that redistributors of a free program will individually +obtain patent licenses, in effect making the program proprietary. To prevent +this, we have made it clear that any patent must be licensed for everyone's +free use or not licensed at all. + +The precise terms and conditions for copying, distribution and modification +follow. + +TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION + +0. This License applies to any program or other work which contains a notice +placed by the copyright holder saying it may be distributed under the terms +of this General Public License. The "Program", below, refers to any such program +or work, and a "work based on the Program" means either the Program or any +derivative work under copyright law: that is to say, a work containing the +Program or a portion of it, either verbatim or with modifications and/or translated +into another language. (Hereinafter, translation is included without limitation +in the term "modification".) Each licensee is addressed as "you". + +Activities other than copying, distribution and modification are not covered +by this License; they are outside its scope. The act of running the Program +is not restricted, and the output from the Program is covered only if its +contents constitute a work based on the Program (independent of having been +made by running the Program). Whether that is true depends on what the Program +does. + +1. You may copy and distribute verbatim copies of the Program's source code +as you receive it, in any medium, provided that you conspicuously and appropriately +publish on each copy an appropriate copyright notice and disclaimer of warranty; +keep intact all the notices that refer to this License and to the absence +of any warranty; and give any other recipients of the Program a copy of this +License along with the Program. + +You may charge a fee for the physical act of transferring a copy, and you +may at your option offer warranty protection in exchange for a fee. + +2. You may modify your copy or copies of the Program or any portion of it, +thus forming a work based on the Program, and copy and distribute such modifications +or work under the terms of Section 1 above, provided that you also meet all +of these conditions: + +a) You must cause the modified files to carry prominent notices stating that +you changed the files and the date of any change. + +b) You must cause any work that you distribute or publish, that in whole or +in part contains or is derived from the Program or any part thereof, to be +licensed as a whole at no charge to all third parties under the terms of this +License. + +c) If the modified program normally reads commands interactively when run, +you must cause it, when started running for such interactive use in the most +ordinary way, to print or display an announcement including an appropriate +copyright notice and a notice that there is no warranty (or else, saying that +you provide a warranty) and that users may redistribute the program under +these conditions, and telling the user how to view a copy of this License. +(Exception: if the Program itself is interactive but does not normally print +such an announcement, your work based on the Program is not required to print +an announcement.) + +These requirements apply to the modified work as a whole. If identifiable +sections of that work are not derived from the Program, and can be reasonably +considered independent and separate works in themselves, then this License, +and its terms, do not apply to those sections when you distribute them as +separate works. But when you distribute the same sections as part of a whole +which is a work based on the Program, the distribution of the whole must be +on the terms of this License, whose permissions for other licensees extend +to the entire whole, and thus to each and every part regardless of who wrote +it. + +Thus, it is not the intent of this section to claim rights or contest your +rights to work written entirely by you; rather, the intent is to exercise +the right to control the distribution of derivative or collective works based +on the Program. + +In addition, mere aggregation of another work not based on the Program with +the Program (or with a work based on the Program) on a volume of a storage +or distribution medium does not bring the other work under the scope of this +License. + +3. You may copy and distribute the Program (or a work based on it, under Section +2) in object code or executable form under the terms of Sections 1 and 2 above +provided that you also do one of the following: + +a) Accompany it with the complete corresponding machine-readable source code, +which must be distributed under the terms of Sections 1 and 2 above on a medium +customarily used for software interchange; or, + +b) Accompany it with a written offer, valid for at least three years, to give +any third party, for a charge no more than your cost of physically performing +source distribution, a complete machine-readable copy of the corresponding +source code, to be distributed under the terms of Sections 1 and 2 above on +a medium customarily used for software interchange; or, + +c) Accompany it with the information you received as to the offer to distribute +corresponding source code. (This alternative is allowed only for noncommercial +distribution and only if you received the program in object code or executable +form with such an offer, in accord with Subsection b above.) + +The source code for a work means the preferred form of the work for making +modifications to it. For an executable work, complete source code means all +the source code for all modules it contains, plus any associated interface +definition files, plus the scripts used to control compilation and installation +of the executable. However, as a special exception, the source code distributed +need not include anything that is normally distributed (in either source or +binary form) with the major components (compiler, kernel, and so on) of the +operating system on which the executable runs, unless that component itself +accompanies the executable. + +If distribution of executable or object code is made by offering access to +copy from a designated place, then offering equivalent access to copy the +source code from the same place counts as distribution of the source code, +even though third parties are not compelled to copy the source along with +the object code. + +4. You may not copy, modify, sublicense, or distribute the Program except +as expressly provided under this License. Any attempt otherwise to copy, modify, +sublicense or distribute the Program is void, and will automatically terminate +your rights under this License. However, parties who have received copies, +or rights, from you under this License will not have their licenses terminated +so long as such parties remain in full compliance. + +5. You are not required to accept this License, since you have not signed +it. However, nothing else grants you permission to modify or distribute the +Program or its derivative works. These actions are prohibited by law if you +do not accept this License. Therefore, by modifying or distributing the Program +(or any work based on the Program), you indicate your acceptance of this License +to do so, and all its terms and conditions for copying, distributing or modifying +the Program or works based on it. + +6. Each time you redistribute the Program (or any work based on the Program), +the recipient automatically receives a license from the original licensor +to copy, distribute or modify the Program subject to these terms and conditions. +You may not impose any further restrictions on the recipients' exercise of +the rights granted herein. You are not responsible for enforcing compliance +by third parties to this License. + +7. If, as a consequence of a court judgment or allegation of patent infringement +or for any other reason (not limited to patent issues), conditions are imposed +on you (whether by court order, agreement or otherwise) that contradict the +conditions of this License, they do not excuse you from the conditions of +this License. If you cannot distribute so as to satisfy simultaneously your +obligations under this License and any other pertinent obligations, then as +a consequence you may not distribute the Program at all. For example, if a +patent license would not permit royalty-free redistribution of the Program +by all those who receive copies directly or indirectly through you, then the +only way you could satisfy both it and this License would be to refrain entirely +from distribution of the Program. + +If any portion of this section is held invalid or unenforceable under any +particular circumstance, the balance of the section is intended to apply and +the section as a whole is intended to apply in other circumstances. + +It is not the purpose of this section to induce you to infringe any patents +or other property right claims or to contest validity of any such claims; +this section has the sole purpose of protecting the integrity of the free +software distribution system, which is implemented by public license practices. +Many people have made generous contributions to the wide range of software +distributed through that system in reliance on consistent application of that +system; it is up to the author/donor to decide if he or she is willing to +distribute software through any other system and a licensee cannot impose +that choice. + +This section is intended to make thoroughly clear what is believed to be a +consequence of the rest of this License. + +8. If the distribution and/or use of the Program is restricted in certain +countries either by patents or by copyrighted interfaces, the original copyright +holder who places the Program under this License may add an explicit geographical +distribution limitation excluding those countries, so that distribution is +permitted only in or among countries not thus excluded. In such case, this +License incorporates the limitation as if written in the body of this License. + +9. The Free Software Foundation may publish revised and/or new versions of +the General Public License from time to time. Such new versions will be similar +in spirit to the present version, but may differ in detail to address new +problems or concerns. + +Each version is given a distinguishing version number. If the Program specifies +a version number of this License which applies to it and "any later version", +you have the option of following the terms and conditions either of that version +or of any later version published by the Free Software Foundation. If the +Program does not specify a version number of this License, you may choose +any version ever published by the Free Software Foundation. + +10. If you wish to incorporate parts of the Program into other free programs +whose distribution conditions are different, write to the author to ask for +permission. For software which is copyrighted by the Free Software Foundation, +write to the Free Software Foundation; we sometimes make exceptions for this. +Our decision will be guided by the two goals of preserving the free status +of all derivatives of our free software and of promoting the sharing and reuse +of software generally. + + NO WARRANTY + +11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY FOR +THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE +STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM +"AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, +BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS +FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE +OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME +THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION. + +12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING +WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE +THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY +GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE +OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA +OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES +OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH +HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. +END OF TERMS AND CONDITIONS + +How to Apply These Terms to Your New Programs + +If you develop a new program, and you want it to be of the greatest possible +use to the public, the best way to achieve this is to make it free software +which everyone can redistribute and change under these terms. + +To do so, attach the following notices to the program. It is safest to attach +them to the start of each source file to most effectively convey the exclusion +of warranty; and each file should have at least the "copyright" line and a +pointer to where the full notice is found. + + + +Copyright (C) + +This program is free software; you can redistribute it and/or modify it under +the terms of the GNU General Public License as published by the Free Software +Foundation; either version 2 of the License, or (at your option) any later +version. + +This program is distributed in the hope that it will be useful, but WITHOUT +ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS +FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. + +You should have received a copy of the GNU General Public License along with +this program; if not, write to the Free Software Foundation, Inc., 51 Franklin +Street, Fifth Floor, Boston, MA 02110-1301, USA. + +Also add information on how to contact you by electronic and paper mail. + +If the program is interactive, make it output a short notice like this when +it starts in an interactive mode: + +Gnomovision version 69, Copyright (C) year name of author Gnomovision comes +with ABSOLUTELY NO WARRANTY; for details type `show w'. This is free software, +and you are welcome to redistribute it under certain conditions; type `show +c' for details. + +The hypothetical commands `show w' and `show c' should show the appropriate +parts of the General Public License. Of course, the commands you use may be +called something other than `show w' and `show c'; they could even be mouse-clicks +or menu items--whatever suits your program. + +You should also get your employer (if you work as a programmer) or your school, +if any, to sign a "copyright disclaimer" for the program, if necessary. Here +is a sample; alter the names: + +Yoyodyne, Inc., hereby disclaims all copyright interest in the program `Gnomovision' +(which makes passes at compilers) written by James Hacker. + +, 1 April 1989 Ty Coon, President of Vice This General +Public License does not permit incorporating your program into proprietary +programs. If your program is a subroutine library, you may consider it more +useful to permit linking proprietary applications with the library. If this +is what you want to do, use the GNU Lesser General Public License instead +of this License. diff --git a/LICENSES/GPL-3.0-only.txt b/LICENSES/GPL-3.0-only.txt new file mode 100644 --- /dev/null +++ b/LICENSES/GPL-3.0-only.txt @@ -0,0 +1,625 @@ +GNU GENERAL PUBLIC LICENSE + +Version 3, 29 June 2007 + +Copyright © 2007 Free Software Foundation, Inc. + +Everyone is permitted to copy and distribute verbatim copies of this license +document, but changing it is not allowed. + +Preamble + +The GNU General Public License is a free, copyleft license for software and +other kinds of works. + +The licenses for most software and other practical works are designed to take +away your freedom to share and change the works. By contrast, the GNU General +Public License is intended to guarantee your freedom to share and change all +versions of a program--to make sure it remains free software for all its users. +We, the Free Software Foundation, use the GNU General Public License for most +of our software; it applies also to any other work released this way by its +authors. You can apply it to your programs, too. + +When we speak of free software, we are referring to freedom, not price. Our +General Public Licenses are designed to make sure that you have the freedom +to distribute copies of free software (and charge for them if you wish), that +you receive source code or can get it if you want it, that you can change +the software or use pieces of it in new free programs, and that you know you +can do these things. + +To protect your rights, we need to prevent others from denying you these rights +or asking you to surrender the rights. Therefore, you have certain responsibilities +if you distribute copies of the software, or if you modify it: responsibilities +to respect the freedom of others. + +For example, if you distribute copies of such a program, whether gratis or +for a fee, you must pass on to the recipients the same freedoms that you received. +You must make sure that they, too, receive or can get the source code. And +you must show them these terms so they know their rights. + +Developers that use the GNU GPL protect your rights with two steps: (1) assert +copyright on the software, and (2) offer you this License giving you legal +permission to copy, distribute and/or modify it. + +For the developers' and authors' protection, the GPL clearly explains that +there is no warranty for this free software. For both users' and authors' +sake, the GPL requires that modified versions be marked as changed, so that +their problems will not be attributed erroneously to authors of previous versions. + +Some devices are designed to deny users access to install or run modified +versions of the software inside them, although the manufacturer can do so. +This is fundamentally incompatible with the aim of protecting users' freedom +to change the software. The systematic pattern of such abuse occurs in the +area of products for individuals to use, which is precisely where it is most +unacceptable. Therefore, we have designed this version of the GPL to prohibit +the practice for those products. If such problems arise substantially in other +domains, we stand ready to extend this provision to those domains in future +versions of the GPL, as needed to protect the freedom of users. + +Finally, every program is threatened constantly by software patents. States +should not allow patents to restrict development and use of software on general-purpose +computers, but in those that do, we wish to avoid the special danger that +patents applied to a free program could make it effectively proprietary. To +prevent this, the GPL assures that patents cannot be used to render the program +non-free. + +The precise terms and conditions for copying, distribution and modification +follow. + +TERMS AND CONDITIONS + + 0. Definitions. + + "This License" refers to version 3 of the GNU General Public License. + +"Copyright" also means copyright-like laws that apply to other kinds of works, +such as semiconductor masks. + +"The Program" refers to any copyrightable work licensed under this License. +Each licensee is addressed as "you". "Licensees" and "recipients" may be individuals +or organizations. + +To "modify" a work means to copy from or adapt all or part of the work in +a fashion requiring copyright permission, other than the making of an exact +copy. The resulting work is called a "modified version" of the earlier work +or a work "based on" the earlier work. + +A "covered work" means either the unmodified Program or a work based on the +Program. + +To "propagate" a work means to do anything with it that, without permission, +would make you directly or secondarily liable for infringement under applicable +copyright law, except executing it on a computer or modifying a private copy. +Propagation includes copying, distribution (with or without modification), +making available to the public, and in some countries other activities as +well. + +To "convey" a work means any kind of propagation that enables other parties +to make or receive copies. Mere interaction with a user through a computer +network, with no transfer of a copy, is not conveying. + +An interactive user interface displays "Appropriate Legal Notices" to the +extent that it includes a convenient and prominently visible feature that +(1) displays an appropriate copyright notice, and (2) tells the user that +there is no warranty for the work (except to the extent that warranties are +provided), that licensees may convey the work under this License, and how +to view a copy of this License. If the interface presents a list of user commands +or options, such as a menu, a prominent item in the list meets this criterion. + + 1. Source Code. + +The "source code" for a work means the preferred form of the work for making +modifications to it. "Object code" means any non-source form of a work. + +A "Standard Interface" means an interface that either is an official standard +defined by a recognized standards body, or, in the case of interfaces specified +for a particular programming language, one that is widely used among developers +working in that language. + +The "System Libraries" of an executable work include anything, other than +the work as a whole, that (a) is included in the normal form of packaging +a Major Component, but which is not part of that Major Component, and (b) +serves only to enable use of the work with that Major Component, or to implement +a Standard Interface for which an implementation is available to the public +in source code form. A "Major Component", in this context, means a major essential +component (kernel, window system, and so on) of the specific operating system +(if any) on which the executable work runs, or a compiler used to produce +the work, or an object code interpreter used to run it. + +The "Corresponding Source" for a work in object code form means all the source +code needed to generate, install, and (for an executable work) run the object +code and to modify the work, including scripts to control those activities. +However, it does not include the work's System Libraries, or general-purpose +tools or generally available free programs which are used unmodified in performing +those activities but which are not part of the work. For example, Corresponding +Source includes interface definition files associated with source files for +the work, and the source code for shared libraries and dynamically linked +subprograms that the work is specifically designed to require, such as by +intimate data communication or control flow between those subprograms and +other parts of the work. + +The Corresponding Source need not include anything that users can regenerate +automatically from other parts of the Corresponding Source. + + The Corresponding Source for a work in source code form is that same work. + + 2. Basic Permissions. + +All rights granted under this License are granted for the term of copyright +on the Program, and are irrevocable provided the stated conditions are met. +This License explicitly affirms your unlimited permission to run the unmodified +Program. The output from running a covered work is covered by this License +only if the output, given its content, constitutes a covered work. This License +acknowledges your rights of fair use or other equivalent, as provided by copyright +law. + +You may make, run and propagate covered works that you do not convey, without +conditions so long as your license otherwise remains in force. You may convey +covered works to others for the sole purpose of having them make modifications +exclusively for you, or provide you with facilities for running those works, +provided that you comply with the terms of this License in conveying all material +for which you do not control copyright. Those thus making or running the covered +works for you must do so exclusively on your behalf, under your direction +and control, on terms that prohibit them from making any copies of your copyrighted +material outside their relationship with you. + +Conveying under any other circumstances is permitted solely under the conditions +stated below. Sublicensing is not allowed; section 10 makes it unnecessary. + + 3. Protecting Users' Legal Rights From Anti-Circumvention Law. + +No covered work shall be deemed part of an effective technological measure +under any applicable law fulfilling obligations under article 11 of the WIPO +copyright treaty adopted on 20 December 1996, or similar laws prohibiting +or restricting circumvention of such measures. + +When you convey a covered work, you waive any legal power to forbid circumvention +of technological measures to the extent such circumvention is effected by +exercising rights under this License with respect to the covered work, and +you disclaim any intention to limit operation or modification of the work +as a means of enforcing, against the work's users, your or third parties' +legal rights to forbid circumvention of technological measures. + + 4. Conveying Verbatim Copies. + +You may convey verbatim copies of the Program's source code as you receive +it, in any medium, provided that you conspicuously and appropriately publish +on each copy an appropriate copyright notice; keep intact all notices stating +that this License and any non-permissive terms added in accord with section +7 apply to the code; keep intact all notices of the absence of any warranty; +and give all recipients a copy of this License along with the Program. + +You may charge any price or no price for each copy that you convey, and you +may offer support or warranty protection for a fee. + + 5. Conveying Modified Source Versions. + +You may convey a work based on the Program, or the modifications to produce +it from the Program, in the form of source code under the terms of section +4, provided that you also meet all of these conditions: + +a) The work must carry prominent notices stating that you modified it, and +giving a relevant date. + +b) The work must carry prominent notices stating that it is released under +this License and any conditions added under section 7. This requirement modifies +the requirement in section 4 to "keep intact all notices". + +c) You must license the entire work, as a whole, under this License to anyone +who comes into possession of a copy. This License will therefore apply, along +with any applicable section 7 additional terms, to the whole of the work, +and all its parts, regardless of how they are packaged. This License gives +no permission to license the work in any other way, but it does not invalidate +such permission if you have separately received it. + +d) If the work has interactive user interfaces, each must display Appropriate +Legal Notices; however, if the Program has interactive interfaces that do +not display Appropriate Legal Notices, your work need not make them do so. + +A compilation of a covered work with other separate and independent works, +which are not by their nature extensions of the covered work, and which are +not combined with it such as to form a larger program, in or on a volume of +a storage or distribution medium, is called an "aggregate" if the compilation +and its resulting copyright are not used to limit the access or legal rights +of the compilation's users beyond what the individual works permit. Inclusion +of a covered work in an aggregate does not cause this License to apply to +the other parts of the aggregate. + + 6. Conveying Non-Source Forms. + +You may convey a covered work in object code form under the terms of sections +4 and 5, provided that you also convey the machine-readable Corresponding +Source under the terms of this License, in one of these ways: + +a) Convey the object code in, or embodied in, a physical product (including +a physical distribution medium), accompanied by the Corresponding Source fixed +on a durable physical medium customarily used for software interchange. + +b) Convey the object code in, or embodied in, a physical product (including +a physical distribution medium), accompanied by a written offer, valid for +at least three years and valid for as long as you offer spare parts or customer +support for that product model, to give anyone who possesses the object code +either (1) a copy of the Corresponding Source for all the software in the +product that is covered by this License, on a durable physical medium customarily +used for software interchange, for a price no more than your reasonable cost +of physically performing this conveying of source, or (2) access to copy the +Corresponding Source from a network server at no charge. + +c) Convey individual copies of the object code with a copy of the written +offer to provide the Corresponding Source. This alternative is allowed only +occasionally and noncommercially, and only if you received the object code +with such an offer, in accord with subsection 6b. + +d) Convey the object code by offering access from a designated place (gratis +or for a charge), and offer equivalent access to the Corresponding Source +in the same way through the same place at no further charge. You need not +require recipients to copy the Corresponding Source along with the object +code. If the place to copy the object code is a network server, the Corresponding +Source may be on a different server (operated by you or a third party) that +supports equivalent copying facilities, provided you maintain clear directions +next to the object code saying where to find the Corresponding Source. Regardless +of what server hosts the Corresponding Source, you remain obligated to ensure +that it is available for as long as needed to satisfy these requirements. + +e) Convey the object code using peer-to-peer transmission, provided you inform +other peers where the object code and Corresponding Source of the work are +being offered to the general public at no charge under subsection 6d. + +A separable portion of the object code, whose source code is excluded from +the Corresponding Source as a System Library, need not be included in conveying +the object code work. + +A "User Product" is either (1) a "consumer product", which means any tangible +personal property which is normally used for personal, family, or household +purposes, or (2) anything designed or sold for incorporation into a dwelling. +In determining whether a product is a consumer product, doubtful cases shall +be resolved in favor of coverage. For a particular product received by a particular +user, "normally used" refers to a typical or common use of that class of product, +regardless of the status of the particular user or of the way in which the +particular user actually uses, or expects or is expected to use, the product. +A product is a consumer product regardless of whether the product has substantial +commercial, industrial or non-consumer uses, unless such uses represent the +only significant mode of use of the product. + +"Installation Information" for a User Product means any methods, procedures, +authorization keys, or other information required to install and execute modified +versions of a covered work in that User Product from a modified version of +its Corresponding Source. The information must suffice to ensure that the +continued functioning of the modified object code is in no case prevented +or interfered with solely because modification has been made. + +If you convey an object code work under this section in, or with, or specifically +for use in, a User Product, and the conveying occurs as part of a transaction +in which the right of possession and use of the User Product is transferred +to the recipient in perpetuity or for a fixed term (regardless of how the +transaction is characterized), the Corresponding Source conveyed under this +section must be accompanied by the Installation Information. But this requirement +does not apply if neither you nor any third party retains the ability to install +modified object code on the User Product (for example, the work has been installed +in ROM). + +The requirement to provide Installation Information does not include a requirement +to continue to provide support service, warranty, or updates for a work that +has been modified or installed by the recipient, or for the User Product in +which it has been modified or installed. Access to a network may be denied +when the modification itself materially and adversely affects the operation +of the network or violates the rules and protocols for communication across +the network. + +Corresponding Source conveyed, and Installation Information provided, in accord +with this section must be in a format that is publicly documented (and with +an implementation available to the public in source code form), and must require +no special password or key for unpacking, reading or copying. + + 7. Additional Terms. + +"Additional permissions" are terms that supplement the terms of this License +by making exceptions from one or more of its conditions. Additional permissions +that are applicable to the entire Program shall be treated as though they +were included in this License, to the extent that they are valid under applicable +law. If additional permissions apply only to part of the Program, that part +may be used separately under those permissions, but the entire Program remains +governed by this License without regard to the additional permissions. + +When you convey a copy of a covered work, you may at your option remove any +additional permissions from that copy, or from any part of it. (Additional +permissions may be written to require their own removal in certain cases when +you modify the work.) You may place additional permissions on material, added +by you to a covered work, for which you have or can give appropriate copyright +permission. + +Notwithstanding any other provision of this License, for material you add +to a covered work, you may (if authorized by the copyright holders of that +material) supplement the terms of this License with terms: + +a) Disclaiming warranty or limiting liability differently from the terms of +sections 15 and 16 of this License; or + +b) Requiring preservation of specified reasonable legal notices or author +attributions in that material or in the Appropriate Legal Notices displayed +by works containing it; or + +c) Prohibiting misrepresentation of the origin of that material, or requiring +that modified versions of such material be marked in reasonable ways as different +from the original version; or + +d) Limiting the use for publicity purposes of names of licensors or authors +of the material; or + +e) Declining to grant rights under trademark law for use of some trade names, +trademarks, or service marks; or + +f) Requiring indemnification of licensors and authors of that material by +anyone who conveys the material (or modified versions of it) with contractual +assumptions of liability to the recipient, for any liability that these contractual +assumptions directly impose on those licensors and authors. + +All other non-permissive additional terms are considered "further restrictions" +within the meaning of section 10. If the Program as you received it, or any +part of it, contains a notice stating that it is governed by this License +along with a term that is a further restriction, you may remove that term. +If a license document contains a further restriction but permits relicensing +or conveying under this License, you may add to a covered work material governed +by the terms of that license document, provided that the further restriction +does not survive such relicensing or conveying. + +If you add terms to a covered work in accord with this section, you must place, +in the relevant source files, a statement of the additional terms that apply +to those files, or a notice indicating where to find the applicable terms. + +Additional terms, permissive or non-permissive, may be stated in the form +of a separately written license, or stated as exceptions; the above requirements +apply either way. + + 8. Termination. + +You may not propagate or modify a covered work except as expressly provided +under this License. Any attempt otherwise to propagate or modify it is void, +and will automatically terminate your rights under this License (including +any patent licenses granted under the third paragraph of section 11). + +However, if you cease all violation of this License, then your license from +a particular copyright holder is reinstated (a) provisionally, unless and +until the copyright holder explicitly and finally terminates your license, +and (b) permanently, if the copyright holder fails to notify you of the violation +by some reasonable means prior to 60 days after the cessation. + +Moreover, your license from a particular copyright holder is reinstated permanently +if the copyright holder notifies you of the violation by some reasonable means, +this is the first time you have received notice of violation of this License +(for any work) from that copyright holder, and you cure the violation prior +to 30 days after your receipt of the notice. + +Termination of your rights under this section does not terminate the licenses +of parties who have received copies or rights from you under this License. +If your rights have been terminated and not permanently reinstated, you do +not qualify to receive new licenses for the same material under section 10. + + 9. Acceptance Not Required for Having Copies. + +You are not required to accept this License in order to receive or run a copy +of the Program. Ancillary propagation of a covered work occurring solely as +a consequence of using peer-to-peer transmission to receive a copy likewise +does not require acceptance. However, nothing other than this License grants +you permission to propagate or modify any covered work. These actions infringe +copyright if you do not accept this License. Therefore, by modifying or propagating +a covered work, you indicate your acceptance of this License to do so. + + 10. Automatic Licensing of Downstream Recipients. + +Each time you convey a covered work, the recipient automatically receives +a license from the original licensors, to run, modify and propagate that work, +subject to this License. You are not responsible for enforcing compliance +by third parties with this License. + +An "entity transaction" is a transaction transferring control of an organization, +or substantially all assets of one, or subdividing an organization, or merging +organizations. If propagation of a covered work results from an entity transaction, +each party to that transaction who receives a copy of the work also receives +whatever licenses to the work the party's predecessor in interest had or could +give under the previous paragraph, plus a right to possession of the Corresponding +Source of the work from the predecessor in interest, if the predecessor has +it or can get it with reasonable efforts. + +You may not impose any further restrictions on the exercise of the rights +granted or affirmed under this License. For example, you may not impose a +license fee, royalty, or other charge for exercise of rights granted under +this License, and you may not initiate litigation (including a cross-claim +or counterclaim in a lawsuit) alleging that any patent claim is infringed +by making, using, selling, offering for sale, or importing the Program or +any portion of it. + + 11. Patents. + +A "contributor" is a copyright holder who authorizes use under this License +of the Program or a work on which the Program is based. The work thus licensed +is called the contributor's "contributor version". + +A contributor's "essential patent claims" are all patent claims owned or controlled +by the contributor, whether already acquired or hereafter acquired, that would +be infringed by some manner, permitted by this License, of making, using, +or selling its contributor version, but do not include claims that would be +infringed only as a consequence of further modification of the contributor +version. For purposes of this definition, "control" includes the right to +grant patent sublicenses in a manner consistent with the requirements of this +License. + +Each contributor grants you a non-exclusive, worldwide, royalty-free patent +license under the contributor's essential patent claims, to make, use, sell, +offer for sale, import and otherwise run, modify and propagate the contents +of its contributor version. + +In the following three paragraphs, a "patent license" is any express agreement +or commitment, however denominated, not to enforce a patent (such as an express +permission to practice a patent or covenant not to sue for patent infringement). +To "grant" such a patent license to a party means to make such an agreement +or commitment not to enforce a patent against the party. + +If you convey a covered work, knowingly relying on a patent license, and the +Corresponding Source of the work is not available for anyone to copy, free +of charge and under the terms of this License, through a publicly available +network server or other readily accessible means, then you must either (1) +cause the Corresponding Source to be so available, or (2) arrange to deprive +yourself of the benefit of the patent license for this particular work, or +(3) arrange, in a manner consistent with the requirements of this License, +to extend the patent license to downstream recipients. "Knowingly relying" +means you have actual knowledge that, but for the patent license, your conveying +the covered work in a country, or your recipient's use of the covered work +in a country, would infringe one or more identifiable patents in that country +that you have reason to believe are valid. + +If, pursuant to or in connection with a single transaction or arrangement, +you convey, or propagate by procuring conveyance of, a covered work, and grant +a patent license to some of the parties receiving the covered work authorizing +them to use, propagate, modify or convey a specific copy of the covered work, +then the patent license you grant is automatically extended to all recipients +of the covered work and works based on it. + +A patent license is "discriminatory" if it does not include within the scope +of its coverage, prohibits the exercise of, or is conditioned on the non-exercise +of one or more of the rights that are specifically granted under this License. +You may not convey a covered work if you are a party to an arrangement with +a third party that is in the business of distributing software, under which +you make payment to the third party based on the extent of your activity of +conveying the work, and under which the third party grants, to any of the +parties who would receive the covered work from you, a discriminatory patent +license (a) in connection with copies of the covered work conveyed by you +(or copies made from those copies), or (b) primarily for and in connection +with specific products or compilations that contain the covered work, unless +you entered into that arrangement, or that patent license was granted, prior +to 28 March 2007. + +Nothing in this License shall be construed as excluding or limiting any implied +license or other defenses to infringement that may otherwise be available +to you under applicable patent law. + + 12. No Surrender of Others' Freedom. + +If conditions are imposed on you (whether by court order, agreement or otherwise) +that contradict the conditions of this License, they do not excuse you from +the conditions of this License. If you cannot convey a covered work so as +to satisfy simultaneously your obligations under this License and any other +pertinent obligations, then as a consequence you may not convey it at all. +For example, if you agree to terms that obligate you to collect a royalty +for further conveying from those to whom you convey the Program, the only +way you could satisfy both those terms and this License would be to refrain +entirely from conveying the Program. + + 13. Use with the GNU Affero General Public License. + +Notwithstanding any other provision of this License, you have permission to +link or combine any covered work with a work licensed under version 3 of the +GNU Affero General Public License into a single combined work, and to convey +the resulting work. The terms of this License will continue to apply to the +part which is the covered work, but the special requirements of the GNU Affero +General Public License, section 13, concerning interaction through a network +will apply to the combination as such. + + 14. Revised Versions of this License. + +The Free Software Foundation may publish revised and/or new versions of the +GNU General Public License from time to time. Such new versions will be similar +in spirit to the present version, but may differ in detail to address new +problems or concerns. + +Each version is given a distinguishing version number. If the Program specifies +that a certain numbered version of the GNU General Public License "or any +later version" applies to it, you have the option of following the terms and +conditions either of that numbered version or of any later version published +by the Free Software Foundation. If the Program does not specify a version +number of the GNU General Public License, you may choose any version ever +published by the Free Software Foundation. + +If the Program specifies that a proxy can decide which future versions of +the GNU General Public License can be used, that proxy's public statement +of acceptance of a version permanently authorizes you to choose that version +for the Program. + +Later license versions may give you additional or different permissions. However, +no additional obligations are imposed on any author or copyright holder as +a result of your choosing to follow a later version. + + 15. Disclaimer of Warranty. + +THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE +LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR +OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER +EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES +OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS +TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM +PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR +CORRECTION. + + 16. Limitation of Liability. + +IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL +ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS THE PROGRAM +AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, +INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO +USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED +INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE +PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER +PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. + + 17. Interpretation of Sections 15 and 16. + +If the disclaimer of warranty and limitation of liability provided above cannot +be given local legal effect according to their terms, reviewing courts shall +apply local law that most closely approximates an absolute waiver of all civil +liability in connection with the Program, unless a warranty or assumption +of liability accompanies a copy of the Program in return for a fee. END OF +TERMS AND CONDITIONS + +How to Apply These Terms to Your New Programs + +If you develop a new program, and you want it to be of the greatest possible +use to the public, the best way to achieve this is to make it free software +which everyone can redistribute and change under these terms. + +To do so, attach the following notices to the program. It is safest to attach +them to the start of each source file to most effectively state the exclusion +of warranty; and each file should have at least the "copyright" line and a +pointer to where the full notice is found. + + + +Copyright (C) + +This program is free software: you can redistribute it and/or modify it under +the terms of the GNU General Public License as published by the Free Software +Foundation, either version 3 of the License, or (at your option) any later +version. + +This program is distributed in the hope that it will be useful, but WITHOUT +ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS +FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. + +You should have received a copy of the GNU General Public License along with +this program. If not, see . + +Also add information on how to contact you by electronic and paper mail. + +If the program does terminal interaction, make it output a short notice like +this when it starts in an interactive mode: + + Copyright (C) + +This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'. + +This is free software, and you are welcome to redistribute it under certain +conditions; type `show c' for details. + +The hypothetical commands `show w' and `show c' should show the appropriate +parts of the General Public License. Of course, your program's commands might +be different; for a GUI interface, you would use an "about box". + +You should also get your employer (if you work as a programmer) or school, +if any, to sign a "copyright disclaimer" for the program, if necessary. For +more information on this, and how to apply and follow the GNU GPL, see . + +The GNU General Public License does not permit incorporating your program +into proprietary programs. If your program is a subroutine library, you may +consider it more useful to permit linking proprietary applications with the +library. If this is what you want to do, use the GNU Lesser General Public +License instead of this License. But first, please read . diff --git a/LICENSES/LicenseRef-KDE-Accepted-GPL.txt b/LICENSES/LicenseRef-KDE-Accepted-GPL.txt new file mode 100644 --- /dev/null +++ b/LICENSES/LicenseRef-KDE-Accepted-GPL.txt @@ -0,0 +1,12 @@ +This library is free software; you can redistribute it and/or +modify it under the terms of the GNU General Public License as +published by the Free Software Foundation; either version 3 of +the license or (at your option) at any later version that is +accepted by the membership of KDE e.V. (or its successor +approved by the membership of KDE e.V.), which shall act as a +proxy as defined in Section 14 of version 3 of the license. + +This program is distributed in the hope that it will be useful, +but WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +GNU General Public License for more details. diff --git a/LICENSES/MIT.txt b/LICENSES/MIT.txt new file mode 100644 --- /dev/null +++ b/LICENSES/MIT.txt @@ -0,0 +1,19 @@ +MIT License Copyright (c) + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is furnished +to do so, subject to the following conditions: + +The above copyright notice and this permission notice (including the next +paragraph) shall be included in all copies or substantial portions of the +Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS +FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS +OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, +WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF +OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. diff --git a/Modules/samba/CMakeLists.txt b/Modules/samba/CMakeLists.txt --- a/Modules/samba/CMakeLists.txt +++ b/Modules/samba/CMakeLists.txt @@ -2,27 +2,27 @@ # KI18N Translation Domain for this library add_definitions(-DTRANSLATION_DOMAIN=\"kcmsamba\") -set(kcm_samba_PART_SRCS - main.cpp - ksmbstatus.cpp - kcmsambaimports.cpp - kcmsambalog.cpp - kcmsambastatistics.cpp ) - - -add_library(kcm_samba MODULE ${kcm_samba_PART_SRCS}) - +set(kcm_samba_PART_SRCS + smbmountmodel.cpp + ksambasharemodel.cpp +) -target_link_libraries(kcm_samba +# Intermediate lib for use in testing. +add_library(kcm_samba_static STATIC ${kcm_samba_PART_SRCS}) +target_link_libraries(kcm_samba_static + KF5::KIOCore + KF5::Solid + KF5::I18n KF5::I18n KF5::KCMUtils - KF5::KIOCore - KF5::KIOWidgets ) -install(TARGETS kcm_samba DESTINATION ${PLUGIN_INSTALL_DIR} ) - +add_library(kcm_samba MODULE main.cpp) +target_link_libraries(kcm_samba + kcm_samba_static +) -########### install files ############### +install(TARGETS kcm_samba DESTINATION ${PLUGIN_INSTALL_DIR}) +install(FILES smbstatus.desktop DESTINATION ${SERVICES_INSTALL_DIR}) -install( FILES smbstatus.desktop DESTINATION ${SERVICES_INSTALL_DIR} ) +add_subdirectory(autotests) diff --git a/Modules/samba/autotests/CMakeLists.txt b/Modules/samba/autotests/CMakeLists.txt new file mode 100644 --- /dev/null +++ b/Modules/samba/autotests/CMakeLists.txt @@ -0,0 +1,18 @@ +if(NOT BUILD_TESTING) + return() +endif() + +remove_definitions(-DQT_NO_CAST_FROM_ASCII) + +find_package(Qt5Test ${QT_MIN_VERSION} CONFIG REQUIRED) + +include(ECMAddTests) + +ecm_add_tests( + ksambasharemodeltest + smbmountmodeltest + LINK_LIBRARIES + Qt5::Core + Qt5::Test + kcm_samba_static +) diff --git a/Modules/samba/autotests/ksambasharemodeltest.cpp b/Modules/samba/autotests/ksambasharemodeltest.cpp new file mode 100644 --- /dev/null +++ b/Modules/samba/autotests/ksambasharemodeltest.cpp @@ -0,0 +1,23 @@ +/* + SPDX-FileCopyrightText: 2020 Harald Sitter + SPDX-License-Identifier: GPL-2.0-only OR GPL-3.0-only OR LicenseRef-KDE-Accepted-GPL +*/ + +#include +#include + +#include "../ksambasharemodel.h" + +class KSambaShareModelTest : public QObject +{ + Q_OBJECT +private Q_SLOTS: + void testModel() + { + QAbstractItemModelTester tester(new KSambaShareModel, QAbstractItemModelTester::FailureReportingMode::QtTest); + } +}; + +QTEST_GUILESS_MAIN(KSambaShareModelTest) + +#include "ksambasharemodeltest.moc" diff --git a/Modules/samba/autotests/smbmountmodeltest.cpp b/Modules/samba/autotests/smbmountmodeltest.cpp new file mode 100644 --- /dev/null +++ b/Modules/samba/autotests/smbmountmodeltest.cpp @@ -0,0 +1,23 @@ +/* + SPDX-FileCopyrightText: 2020 Harald Sitter + SPDX-License-Identifier: GPL-2.0-only OR GPL-3.0-only OR LicenseRef-KDE-Accepted-GPL +*/ + +#include +#include + +#include "../smbmountmodel.h" + +class SmbMountModelTest : public QObject +{ + Q_OBJECT +private Q_SLOTS: + void testModel() + { + QAbstractItemModelTester tester(new SmbMountModel); + } +}; + +QTEST_GUILESS_MAIN(SmbMountModelTest) + +#include "smbmountmodeltest.moc" diff --git a/Modules/samba/kcmsambaimports.h b/Modules/samba/kcmsambaimports.h deleted file mode 100644 --- a/Modules/samba/kcmsambaimports.h +++ /dev/null @@ -1,50 +0,0 @@ -/* - * kcmsambaimports.h - * - * Copyright (c) 2000 Alexander Neundorf - * - * Requires the Qt widget libraries, available at no cost at - * https://www.qt.io/ - * - * This program is free software; you can redistribute it and/or modify - * it under the terms of the GNU General Public License as published by - * the Free Software Foundation; either version 2 of the License, or - * (at your option) any later version. - * - * This program is distributed in the hope that it will be useful, - * but WITHOUT ANY WARRANTY; without even the implied warranty of - * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the - * GNU General Public License for more details. - * - * You should have received a copy of the GNU General Public License - * along with this program; if not, write to the Free Software - * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. - */ - -#ifndef kcmsambaimports_h_included -#define kcmsambaimports_h_included - -#include -#include - -#include - -class ImportsView : public QWidget { -Q_OBJECT -public: - explicit ImportsView(QWidget *parent, KConfig *config=0); - virtual ~ImportsView() { - } - void saveSettings() { - } - void loadSettings() { - } -private: - KConfig *configFile; - QTreeWidget list; - QTimer timer; -private Q_SLOTS: - void updateList(); -}; - -#endif // main_included diff --git a/Modules/samba/kcmsambaimports.cpp b/Modules/samba/kcmsambaimports.cpp deleted file mode 100644 --- a/Modules/samba/kcmsambaimports.cpp +++ /dev/null @@ -1,87 +0,0 @@ -/* - * kcmsambaimports.cpp - * - * Copyright (c) 2000 Alexander Neundorf - * - * Requires the Qt widget libraries, available at no cost at - * https://www.qt.io/ - * - * This program is free software; you can redistribute it and/or modify - * it under the terms of the GNU General Public License as published by - * the Free Software Foundation; either version 2 of the License, or - * (at your option) any later version. - * - * This program is distributed in the hope that it will be useful, - * but WITHOUT ANY WARRANTY; without even the implied warranty of - * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the - * GNU General Public License for more details. - * - * You should have received a copy of the GNU General Public License - * along with this program; if not, write to the Free Software - * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. - */ -#include "kcmsambaimports.h" - -#include -#include - -#include - -#include - -ImportsView::ImportsView(QWidget * parent, KConfig *config) : - QWidget(parent), configFile(config), list(this) { - QBoxLayout *topLayout = new QVBoxLayout(this); - topLayout->addWidget(&list); - - list.setAllColumnsShowFocus(true); - list.setMinimumSize(425, 200); - list.setHeaderLabels(QStringList() << i18n("Type") << i18n("Resource") << i18n("Mounted Under")); - - this->setWhatsThis(i18n("This list shows the Samba and NFS shared" - " resources mounted on your system from other hosts. The \"Type\"" - " column tells you whether the mounted resource is a Samba or an NFS" - " type of resource. The \"Resource\" column shows the descriptive name" - " of the shared resource. Finally, the third column, which is labeled" - " \"Mounted under\" shows the location on your system where the shared" - " resource is mounted.") ); - - timer.start(10000); - QObject::connect(&timer, &QTimer::timeout, this, &ImportsView::updateList); - updateList(); -} - -void ImportsView::updateList() { - list.clear(); - char *e; - char buf[250]; - QByteArray s(""), strSource, strMount; - QString strType; - FILE *f=popen("mount", "r"); - if (f==nullptr) - return; - do { - e=fgets(buf, 250, f); - if (e) { - s=buf; - if ((s.contains(" nfs ")) || (s.contains(" smbfs "))) { - strSource=s.left(s.indexOf(" on /")); - strMount=s.mid(s.indexOf(" on /")+4, s.length()); - if ((s.contains(" nfs ")) || (s.contains("/remote on "))) - strType=QStringLiteral("NFS"); - else if (s.contains(" smbfs ")) - strType=QStringLiteral("SMB"); - int pos(strMount.indexOf(" type ")); - if (pos==-1) - pos=strMount.indexOf(" read/"); - strMount=strMount.left(pos); - QTreeWidgetItem *item = new QTreeWidgetItem(&list); - item->setText(0, strType); - item->setText(1, QString::fromUtf8(strSource)); - item->setText(2, QString::fromUtf8(strMount)); - }; - }; - } while (!feof(f)); - pclose(f); -} - diff --git a/Modules/samba/kcmsambalog.h b/Modules/samba/kcmsambalog.h deleted file mode 100644 --- a/Modules/samba/kcmsambalog.h +++ /dev/null @@ -1,82 +0,0 @@ -/* - * kcmsambalog.h - * - * Copyright (c) 2000 Alexander Neundorf - * - * Requires the Qt widget libraries, available at no cost at - * https://www.qt.io/ - * - * This program is free software; you can redistribute it and/or modify - * it under the terms of the GNU General Public License as published by - * the Free Software Foundation; either version 2 of the License, or - * (at your option) any later version. - * - * This program is distributed in the hope that it will be useful, - * but WITHOUT ANY WARRANTY; without even the implied warranty of - * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the - * GNU General Public License for more details. - * - * You should have received a copy of the GNU General Public License - * along with this program; if not, write to the Free Software - * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. - */ -#ifndef kcmsambalog_h_included -#define kcmsambalog_h_included - -#include -#include -#include -#include - -#include -#include - -#define LOGGROUPNAME "SambaLogFileSettings" - -class LogView : public QWidget { -Q_OBJECT -public: - explicit LogView(QWidget *parent=0, KConfig *config=0); - virtual ~LogView() { - } - void saveSettings(); - void loadSettings(); -private: - KConfig *configFile; - int filesCount, connectionsCount; - KUrlRequester logFileName; - QLabel label; - QTreeWidget viewHistory; - QCheckBox showConnOpen, showConnClose, showFileOpen, showFileClose; - QPushButton updateButton; -private Q_SLOTS: - void updateList(); -Q_SIGNALS: - void contentsChanged(QTreeWidget *list, int nrOfFiles, int nrOfConnections); -}; - -class QTreeWidgetItemX : public QTreeWidgetItem { -public: - //a faster constructor saves a lot time - QTreeWidgetItemX(QTreeWidget *parent, const char *c0, const char *c1 = 0, const char *c2 = 0, const char *c3 = 0, const char *c4 = 0, const char *c5 = 0, const char *c6 = 0, const char *c7 = 0) : - QTreeWidgetItem(parent) { - setText( 0, QString::fromLatin1(c0)); - setText( 1, QString::fromLatin1(c1)); - setText( 2, QString::fromLatin1(c2)); - setText( 3, QString::fromLatin1(c3)); - if (c4==0) - return; - setText( 4, QString::fromLatin1(c4)); - if (c5==0) - return; - setText( 5, QString::fromLatin1(c5)); - if (c6==0) - return; - setText( 6, QString::fromLatin1(c6)); - if (c7==0) - return; - setText( 7, QString::fromLatin1(c7)); - } -}; - -#endif // main_included diff --git a/Modules/samba/kcmsambalog.cpp b/Modules/samba/kcmsambalog.cpp deleted file mode 100644 --- a/Modules/samba/kcmsambalog.cpp +++ /dev/null @@ -1,232 +0,0 @@ -/* - * kcmsambalog.cpp - * - * Copyright (c) 2000 Alexander Neundorf - * - * Requires the Qt widget libraries, available at no cost at - * https://www.qt.io/ - * - * This program is free software; you can redistribute it and/or modify - * it under the terms of the GNU General Public License as published by - * the Free Software Foundation; either version 2 of the License, or - * (at your option) any later version. - * - * This program is distributed in the hope that it will be useful, - * but WITHOUT ANY WARRANTY; without even the implied warranty of - * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the - * GNU General Public License for more details. - * - * You should have received a copy of the GNU General Public License - * along with this program; if not, write to the Free Software - * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. - */ - -#include -#include -#include -#include -#include -#include - -#include -#include -#include - -#include "kcmsambalog.h" - -#define LOG_SCREEN_XY_OFFSET 10 - -LogView::LogView(QWidget *parent, KConfig *config) : - QWidget(parent), configFile(config), filesCount(0), connectionsCount(0), logFileName(QUrl::fromLocalFile(QStringLiteral("/var/log/samba/log.smbd")), this), label(i18n("Samba log file: "), this), viewHistory(this), showConnOpen(i18n("Show opened connections"), this), showConnClose(i18n("Show closed connections"), this), - showFileOpen(i18n("Show opened files"), this), showFileClose(i18n("Show closed files"), this), updateButton(i18n("&Update"), this) { - label.setTextInteractionFlags(Qt::TextSelectableByMouse); - label.setBuddy( &logFileName); - QVBoxLayout *mainLayout=new QVBoxLayout(this); - QHBoxLayout *leLayout=new QHBoxLayout(); - mainLayout->addItem(leLayout); - leLayout->addWidget(&label); - leLayout->addWidget(&logFileName, 1); - mainLayout->addWidget(&viewHistory, 1); - QGridLayout *subLayout=new QGridLayout(); - mainLayout->addItem(subLayout); - subLayout->addWidget(&showConnOpen, 0, 0); - subLayout->addWidget(&showConnClose, 1, 0); - subLayout->addWidget(&showFileOpen, 0, 1); - subLayout->addWidget(&showFileClose, 1, 1); - mainLayout->addWidget(&updateButton, 0, Qt::AlignLeft); - - logFileName.setWhatsThis(i18n("This page presents the contents of" - " your samba log file in a friendly layout. Check that the correct log" - " file for your computer is listed here. If you need to, correct the name" - " or location of the log file, and then click the \"Update\" button.") ); - - showConnOpen.setWhatsThis(i18n("Check this option if you want to" - " view the details for connections opened to your computer.") ); - - showConnClose.setWhatsThis(i18n("Check this option if you want to" - " view the events when connections to your computer were closed.") ); - - showFileOpen.setWhatsThis(i18n("Check this option if you want to" - " see the files which were opened on your computer by remote users." - " Note that file open/close events are not logged unless the samba" - " log level is set to at least 2 (you cannot set the log level" - " using this module).") ); - - showFileClose.setWhatsThis(i18n("Check this option if you want to" - " see the events when files opened by remote users were closed." - " Note that file open/close events are not logged unless the samba" - " log level is set to at least 2 (you cannot set the log level" - " using this module).") ); - - updateButton.setWhatsThis(i18n("Click here to refresh the information" - " on this page. The log file (shown above) will be read to obtain the" - " events logged by samba.") ); - - viewHistory.setAllColumnsShowFocus(true); - viewHistory.setFocusPolicy(Qt::ClickFocus); - - QStringList headers; - headers << i18n("Date & Time") << i18n("Event") << i18n("Service/File") - << i18n("Host/User") << i18n("Date & Time") << i18n("Event") - << i18n("Service/File") << i18n("Host/User"); - viewHistory.setHeaderLabels(headers); - - viewHistory.setWhatsThis(i18n("

This list shows details of the events" - " logged by samba. Note that events at the file level are not logged" - " unless you have configured the log level for samba to 2 or greater.

" - " As with many other lists in KDE, you can click on a column heading" - " to sort on that column. Click again to change the sorting direction" - " from ascending to descending or vice versa.

" - " If the list is empty, try clicking the \"Update\" button. The samba" - " log file will be read and the list refreshed.

") ); - - showConnOpen.setChecked(true); - showConnClose.setChecked(true); - showFileOpen.setChecked(false); - showFileClose.setChecked(false); - - connect(&updateButton, &QPushButton::clicked, this, &LogView::updateList); - emit contentsChanged(&viewHistory, 0, 0); - - label.setMinimumSize(label.sizeHint()); - logFileName.setMinimumSize(250, logFileName.sizeHint().height()); - viewHistory.setMinimumSize(425, 200); - showConnOpen.setMinimumSize(showConnOpen.sizeHint()); - showConnClose.setMinimumSize(showConnClose.sizeHint()); - showFileOpen.setMinimumSize(showFileOpen.sizeHint()); - showFileClose.setMinimumSize(showFileClose.sizeHint()); - updateButton.setFixedSize(updateButton.sizeHint()); -} - -void LogView::loadSettings() { - if (configFile==0) - return; - KConfigGroup group = configFile->group(LOGGROUPNAME); - logFileName.setUrl(QUrl::fromLocalFile(group.readPathEntry("SambaLogFile", QStringLiteral("/var/log/samba/log.smbd")))); - - showConnOpen.setChecked(group.readEntry("ShowConnectionOpen", true)); - showConnClose.setChecked(group.readEntry("ShowConnectionClose", false)); - showFileOpen.setChecked(group.readEntry("ShowFileOpen", true)); - showFileClose.setChecked(group.readEntry("ShowFileClose", false)); -} - -void LogView::saveSettings() { - if (configFile==0) - return; - KConfigGroup group = configFile->group(LOGGROUPNAME); - group.writePathEntry("SambaLogFile", logFileName.url().path()); - - group.writeEntry("ShowConnectionOpen", showConnOpen.isChecked()); - group.writeEntry("ShowConnectionClose", showConnClose.isChecked()); - group.writeEntry("ShowFileOpen", showFileOpen.isChecked()); - group.writeEntry("ShowFileClose", showFileClose.isChecked()); -} - -#define CONN_OPEN " connect to service " -#define CONN_CLOSE " closed connection to service " -#define FILE_OPEN " opened file " -#define FILE_CLOSE " closed file " - -//caution ! high optimized code :-) -void LogView::updateList() { - QFile logFile(logFileName.url().path()); - if (logFile.open(QIODevice::ReadOnly)) { - QApplication::setOverrideCursor(Qt::WaitCursor); - viewHistory.clear(); - filesCount=0; - connectionsCount=0; - - int connOpenLen(strlen(CONN_OPEN)); - int connCloseLen(strlen(CONN_CLOSE)); - int fileOpenLen(strlen(FILE_OPEN)); - int fileCloseLen(strlen(FILE_CLOSE)); - - char buf[400]; - char *c1, *c2, *c3, *c4, *c, time[25]; - int timeRead(0); - - while (!logFile.atEnd()) { - logFile.readLine(buf, sizeof(buf)); - timeRead=0; - if (buf[0]=='[') { - if (strlen(buf)>11) - if (buf[5]=='/') { - buf[20]='\0'; - strncpy(time, buf+1, sizeof(time)); - time[sizeof(time)-1] = '\0'; - timeRead=1; - }; - }; - if (timeRead==0) { - c1=nullptr; - c2=nullptr; - c3=nullptr; - c4=nullptr; - if (showConnOpen.isChecked()) - c1=strstr(buf, CONN_OPEN); - if (!c1) { - if (showConnClose.isChecked()) - c2=strstr(buf, CONN_CLOSE); - if (!c2) { - if (showFileOpen.isChecked()) - c3=strstr(buf, FILE_OPEN); - if (!c3) { - if (showFileClose.isChecked()) - c4=strstr(buf, FILE_CLOSE); - if (!c4) - continue; - }; - }; - }; - if (c1) { - c=strstr(buf, " as user"); - *c='\0'; - *c1='\0'; - new QTreeWidgetItemX(&viewHistory,time,I18N_NOOP("CONNECTION OPENED"),c1+connOpenLen,buf+2); - connectionsCount++; - } else if (c2) { - *c2='\0'; - new QTreeWidgetItemX(&viewHistory,time,I18N_NOOP("CONNECTION CLOSED"),c2+connCloseLen,buf+2); - } else if (c3) { - c=strstr(buf, " read="); - *c='\0'; - *c3='\0'; - new QTreeWidgetItemX(&viewHistory,time,I18N_NOOP(" FILE OPENED"),c3+fileOpenLen,buf+2); - filesCount++; - } else if (c4) { - c=strstr(buf, " (numopen="); - *c='\0'; - *c4='\0'; - new QTreeWidgetItemX(&viewHistory,time,I18N_NOOP(" FILE CLOSED"),c4+fileCloseLen,buf+2); - }; - }; - }; - logFile.close(); - emit contentsChanged(&viewHistory, filesCount, connectionsCount); - QApplication::restoreOverrideCursor(); - } else { - QString tmp = i18n("Could not open file %1", logFileName.url().path()); - KMessageBox::error(this, tmp); - }; -} - diff --git a/Modules/samba/kcmsambastatistics.h b/Modules/samba/kcmsambastatistics.h deleted file mode 100644 --- a/Modules/samba/kcmsambastatistics.h +++ /dev/null @@ -1,113 +0,0 @@ -/* - * kcmsambastatistics.h - * - * Copyright (c) 2000 Alexander Neundorf - * - * Requires the Qt widget libraries, available at no cost at - * https://www.qt.io/ - * - * This program is free software; you can redistribute it and/or modify - * it under the terms of the GNU General Public License as published by - * the Free Software Foundation; either version 2 of the License, or - * (at your option) any later version. - * - * This program is distributed in the hope that it will be useful, - * but WITHOUT ANY WARRANTY; without even the implied warranty of - * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the - * GNU General Public License for more details. - * - * You should have received a copy of the GNU General Public License - * along with this program; if not, write to the Free Software - * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. - */ -#ifndef kcmsambastatistics_h_included -#define kcmsambastatistics_h_included - -#include -#include - -class QTreeWidget; -class QLabel; -class QComboBox; -class QCheckBox; -class QLineEdit; -class QPushButton; - -class KConfig; - -class SmallLogItem { -public: - SmallLogItem() : - name(QLatin1String("")), count(0) { - } - SmallLogItem(const QString &n) : - name(n), count(1) { - } - QString name; - int count; -}; - -class LogItem { -public: - LogItem() : - name(QLatin1String("")), accessed(), count(0) { - } - LogItem(const QString &n, const QString &a) : - name(n), accessed(), count(1) { - accessed.append(new SmallLogItem(a)); - } - ~LogItem() { - qDeleteAll(accessed); - accessed.clear(); - } - QString name; - QList accessed; - int count; - SmallLogItem* itemInList(const QString &name); - void addItem(const QString &host); -}; - -class SambaLog { -public: - ~SambaLog() { - qDeleteAll(items); - items.clear(); - } - QList items; - void addItem(const QString &share, const QString &host); - void printItems(); -private: - LogItem* itemInList(const QString &name); -}; - -class StatisticsView : public QWidget { -Q_OBJECT -public: - explicit StatisticsView(QWidget *parent=0, KConfig *config=0); - virtual ~StatisticsView() { - } - void saveSettings() { - } - void loadSettings() { - } -public Q_SLOTS: - void setListInfo(QTreeWidget *list, int nrOfFiles, int nrOfConnections); -private: - KConfig *configFile; - QTreeWidget* dataList; - QTreeWidget* viewStatistics; - QLabel* connectionsL, *filesL; - QComboBox* eventCb; - QLabel* eventL; - QLineEdit* serviceLe; - QLabel* serviceL; - QLineEdit* hostLe; - QLabel* hostL; - QPushButton* calcButton, *clearButton; - QCheckBox* expandedInfoCb, *expandedUserCb; - int connectionsCount, filesCount, calcCount; -private Q_SLOTS: - void clearStatistics(); - void calculate(); -}; -#endif // main_included diff --git a/Modules/samba/kcmsambastatistics.cpp b/Modules/samba/kcmsambastatistics.cpp deleted file mode 100644 --- a/Modules/samba/kcmsambastatistics.cpp +++ /dev/null @@ -1,302 +0,0 @@ -/* - * kcmsambastatistics.cpp - * - * Copyright (c) 2000 Alexander Neundorf - * - * Requires the Qt widget libraries, available at no cost at - * https://www.qt.io/ - * - * This program is free software; you can redistribute it and/or modify - * it under the terms of the GNU General Public License as published by - * the Free Software Foundation; either version 2 of the License, or - * (at your option) any later version. - * - * This program is distributed in the hope that it will be useful, - * but WITHOUT ANY WARRANTY; without even the implied warranty of - * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the - * GNU General Public License for more details. - * - * You should have received a copy of the GNU General Public License - * along with this program; if not, write to the Free Software - * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. - */ -#include "kcmsambastatistics.h" - -#include -#include -#include -#include -#include -#include -#include -#include -#include -#include -#include -#include - -#include - -StatisticsView::StatisticsView(QWidget *parent, KConfig *config) : - QWidget(parent), configFile(config), dataList(0), connectionsCount(0), filesCount(0), calcCount(0) { - viewStatistics = new QTreeWidget( this ); - connectionsL = new QLabel( i18n( "Connections: 0" ), this ); - connectionsL->setTextInteractionFlags(Qt::TextSelectableByMouse); - filesL = new QLabel( i18n( "File accesses: 0" ), this ); - filesL->setTextInteractionFlags(Qt::TextSelectableByMouse); - eventCb = new QComboBox( this ); - eventL = new QLabel( i18n( "Event: " ), this ); - eventL->setTextInteractionFlags(Qt::TextSelectableByMouse); - eventL->setBuddy(eventCb); - serviceLe = new QLineEdit( this ); - serviceL = new QLabel( i18n( "Service/File:" ), this ); - serviceL->setTextInteractionFlags(Qt::TextSelectableByMouse); - serviceL->setBuddy(serviceLe); - hostLe = new QLineEdit( this ); - hostL = new QLabel( i18n( "Host/User:" ), this ); - hostL->setTextInteractionFlags(Qt::TextSelectableByMouse); - hostL->setBuddy(hostLe); - calcButton = new QPushButton( i18n( "&Search" ), this ); - clearButton = new QPushButton( i18n( "Clear Results" ), this ); - expandedInfoCb = new QCheckBox( i18n( "Show expanded service info" ), this ); - expandedUserCb = new QCheckBox( i18n( "Show expanded host info" ), this ); - - viewStatistics->setAllColumnsShowFocus(true); - viewStatistics->setFocusPolicy(Qt::ClickFocus); - - QStringList headers; - headers << i18n("Nr") << i18n("Event") << i18n("Service/File") << i18n("Host/User") << i18n("Hits"); //i18n("Percentage"),100); - viewStatistics->setHeaderLabels(headers); - - eventCb->setEditable(false); - eventCb->addItem(i18n("Connection")); - eventCb->addItem(i18n("File Access")); - - expandedInfoCb->setChecked(false); - expandedUserCb->setChecked(false); - clearStatistics(); - serviceLe->setText(QStringLiteral("*")); - hostLe->setText(QStringLiteral("*")); - - viewStatistics->setMinimumSize(375, 200); - connectionsL->setMinimumSize(connectionsL->sizeHint()); - filesL->setMinimumSize(filesL->sizeHint()); - eventL->setMinimumSize(eventL->sizeHint()); - eventCb->setMinimumSize(eventCb->sizeHint()); - hostL->setMinimumSize(hostL->sizeHint()); - hostLe->setMinimumSize(120, hostLe->sizeHint().height()); - serviceL->setMinimumSize(serviceL->sizeHint()); - serviceLe->setMinimumSize(120, serviceLe->sizeHint().height()); - calcButton->setMinimumSize(calcButton->sizeHint()); - clearButton->setMinimumSize(clearButton->sizeHint()); - expandedInfoCb->setMinimumSize(expandedInfoCb->sizeHint()); - expandedUserCb->setMinimumSize(expandedUserCb->sizeHint()); - - QVBoxLayout *topLayout=new QVBoxLayout(this); - topLayout->addWidget(viewStatistics, 1); - QGridLayout *subLayout=new QGridLayout(); - topLayout->addItem(subLayout); - subLayout->setColumnStretch(1, 1); - subLayout->setColumnStretch(2, 1); - - QHBoxLayout *twoButtonsLayout=new QHBoxLayout; - twoButtonsLayout->addWidget(calcButton, 1); - twoButtonsLayout->addWidget(clearButton, 1); - - subLayout->addWidget(connectionsL, 0, 0); - subLayout->addWidget(filesL, 0, 1); - subLayout->addWidget(eventL, 1, 0); - subLayout->addWidget(serviceL, 1, 1); - subLayout->addWidget(hostL, 1, 2); - subLayout->addWidget(eventCb, 2, 0); - subLayout->addWidget(serviceLe, 2, 1); - subLayout->addWidget(hostLe, 2, 2); - subLayout->addLayout(twoButtonsLayout, 3, 0); - subLayout->addWidget(expandedInfoCb, 3, 1); - subLayout->addWidget(expandedUserCb, 3, 2); - - connect(clearButton, &QPushButton::clicked, this, &StatisticsView::clearStatistics); - connect(calcButton, &QPushButton::clicked, this, &StatisticsView::calculate); - setListInfo(0, 0, 0); -} - -void StatisticsView::setListInfo(QTreeWidget *list, int nrOfFiles, int nrOfConnections) { - dataList=list; - filesCount=nrOfFiles; - connectionsCount=nrOfConnections; - connectionsL->setText(i18n("Connections: %1", connectionsCount)); - filesL->setText(i18n("File accesses: %1", filesCount)); - clearStatistics(); -} - -void StatisticsView::calculate() { - if (dataList==0) - return; - QApplication::setOverrideCursor(Qt::WaitCursor); - int connCount(0); - if (eventCb->currentText()==i18n("Connection")) - connCount=1; - //something has to be counted exactly - if ((expandedInfoCb->isChecked()) || (expandedUserCb->isChecked())) { - SambaLog sLog; - QRegExp rService(serviceLe->text(), Qt::CaseInsensitive, QRegExp::Wildcard); - QRegExp rHost(hostLe->text(), Qt::CaseInsensitive, QRegExp::Wildcard); - QString item2, item3; - for (int i = 0; i < dataList->topLevelItemCount(); ++i) - { - QTreeWidgetItem *item = dataList->topLevelItem(i); - if (connCount) { - if ((QString(item->text(1)).contains(i18n("CONNECTION OPENED"))) && (QString(item->text(2)).contains(rService)) && (QString(item->text(3)).contains(rHost))) { - if (expandedInfoCb->isChecked()) - item2=item->text(2); - else - item2=serviceLe->text(); - if (expandedUserCb->isChecked()) - item3=item->text(3); - else - item3=hostLe->text(); - sLog.addItem(item2, item3); - //count++; - } - } else { - if ((QString(item->text(1)).contains(i18n("FILE OPENED"))) && (QString(item->text(2)).contains(rService)) && (QString(item->text(3)).contains(rHost))) { - if (expandedInfoCb->isChecked()) - item2=item->text(2); - else - item2=serviceLe->text(); - if (expandedUserCb->isChecked()) - item3=item->text(3); - else - item3=hostLe->text(); - sLog.addItem(item2, item3); - - } - } - } - - foreach (const LogItem *tmpItem, sLog.items) - { - if (!tmpItem) - { - continue; - } - - foreach (const SmallLogItem *tmpStr, tmpItem->accessed) { - if (!tmpStr) - { - continue; - } - - calcCount++; - const QString number = QString::asprintf("%6d", calcCount); - const QString hits = QString::asprintf("%7d", tmpStr->count); - QTreeWidgetItem *item = new QTreeWidgetItem(viewStatistics); - item->setText(0, number); - item->setText(1, eventCb->currentText()); - item->setText(2, tmpItem->name); - item->setText(3, tmpStr->name); - item->setText(4, hits); - } - } - } - //no expanded info needed - else { - calcCount++; - int count(0); - QRegExp rService(serviceLe->text(), Qt::CaseInsensitive, QRegExp::Wildcard); - QRegExp rHost(hostLe->text(), Qt::CaseInsensitive, QRegExp::Wildcard); - for (int i = 0; i < dataList->topLevelItemCount(); ++i) - { - QTreeWidgetItem *item = dataList->topLevelItem(i); - if (connCount) { - if ((item->text(1).contains(i18n("CONNECTION OPENED"))) && (item->text(2).contains(rService)) && (item->text(3).contains(rHost))) - count++; - } else { - if ((item->text(1).contains(i18n("FILE OPENED"))) && (item->text(2).contains(rService)) && (item->text(3).contains(rHost))) - count++; - } - } - const QString number = QString::asprintf("%6d", calcCount); - const QString hits = QString::asprintf("%7d", count); - QTreeWidgetItem *item = new QTreeWidgetItem(viewStatistics); - item->setText(0, number); - item->setText(1, eventCb->currentText()); - item->setText(2, serviceLe->text()); - item->setText(3, hostLe->text()); - item->setText(4, hits); - }; - QApplication::restoreOverrideCursor(); -} - -void StatisticsView::clearStatistics() { - viewStatistics->clear(); - calcCount=0; -} - -void SambaLog::printItems() { - //qDebug() << "****** printing items: ******"; - foreach (const LogItem *tmpItem, items) - { - if (!tmpItem) - { - continue; - } - - //qDebug() << "SERVICE: " << tmpItem->name; - foreach (const SmallLogItem *tmpLog, tmpItem->accessed) { - if (!tmpLog) - { - continue; - } - //qDebug() << " accessed by: " << tmpLog->name << " " << tmpLog->count; - } - } - - //qDebug() << "------ end of printing ------"; -} - -LogItem* SambaLog::itemInList(const QString &name) { - foreach (LogItem *tmpItem, items) - { - if (!tmpItem) - { - continue; - } - - if (tmpItem->name==name) - { - return tmpItem; - } - } - - return nullptr; -} - -void SambaLog::addItem(const QString &share, const QString &user) { - //cout<<" adding connection: -"<count++; - tmp->addItem(user); - } else { - items.append(new LogItem(share,user)); - } -} - -SmallLogItem* LogItem::itemInList(const QString &name) { - foreach (SmallLogItem *tmpLog, accessed) { - if (tmpLog && tmpLog->name==name) { - return tmpLog; - } - } - return 0; -} - -void LogItem::addItem(const QString &host) { - SmallLogItem* tmp(itemInList(host)); - if (tmp!=0) - tmp->count++; - else - accessed.append(new SmallLogItem(host)); -} - diff --git a/Modules/samba/ksambasharemodel.h b/Modules/samba/ksambasharemodel.h new file mode 100644 --- /dev/null +++ b/Modules/samba/ksambasharemodel.h @@ -0,0 +1,43 @@ +/* + SPDX-FileCopyrightText: 2020 Harald Sitter + SPDX-License-Identifier: GPL-2.0-only OR GPL-3.0-only OR LicenseRef-KDE-Accepted-GPL +*/ + +#ifndef KSAMBASHAREMODEL_H +#define KSAMBASHAREMODEL_H + +#include +#include + +/** + * Model of ksamabasharedata. Implementing properties + * as columns rather than roles. + */ +class KSambaShareModel : public QAbstractListModel +{ +Q_OBJECT +public: + enum class ColumnRole { + Name, + Path, + Comment, + ColumnCount, // End marker + }; + + explicit KSambaShareModel(QObject *parent = nullptr); + ~KSambaShareModel() override; + + int rowCount(const QModelIndex &parent) const override; + int columnCount(const QModelIndex &parent) const override; + QVariant headerData(int section, Qt::Orientation orientation, int role) const override; + QVariant data(const QModelIndex &index, int role) const override; + bool hasChildren(const QModelIndex &parent) const override; + +public slots: + void reloadData(); + +private: + QList m_list; +}; + +#endif // KSAMBASHAREMODEL_H diff --git a/Modules/samba/ksambasharemodel.cpp b/Modules/samba/ksambasharemodel.cpp new file mode 100644 --- /dev/null +++ b/Modules/samba/ksambasharemodel.cpp @@ -0,0 +1,92 @@ +/* + SPDX-FileCopyrightText: 2020 Harald Sitter + SPDX-License-Identifier: GPL-2.0-only OR GPL-3.0-only OR LicenseRef-KDE-Accepted-GPL +*/ + +#include "ksambasharemodel.h" + +#include +#include + +KSambaShareModel::KSambaShareModel(QObject *parent) + : QAbstractListModel(parent) +{ + connect(KSambaShare::instance(), &KSambaShare::changed, + this, &KSambaShareModel::reloadData); + reloadData(); +} + +KSambaShareModel::~KSambaShareModel() = default; + +int KSambaShareModel::rowCount(const QModelIndex &parent) const +{ + Q_UNUSED(parent) + return m_list.size(); +} + +int KSambaShareModel::columnCount(const QModelIndex &parent) const +{ + Q_UNUSED(parent) + return static_cast(ColumnRole::ColumnCount); +} + +QVariant KSambaShareModel::headerData(int section, Qt::Orientation orientation, int role) const +{ + if (orientation != Qt::Horizontal || role != Qt::DisplayRole) { + return {}; // we only have column headers. + } + + Q_ASSERT(section < static_cast(ColumnRole::ColumnCount)); + switch (static_cast(section)) { + case ColumnRole::Name: + return i18nc("@title:column samba share name", "Name"); + case ColumnRole::Path: + return i18nc("@title:column samba share dir path", "Path"); + case ColumnRole::Comment: + return i18nc("@title:column samba share text comment/description", "Comment"); + case ColumnRole::ColumnCount: + break; // noop + } + + return {}; +} + +QVariant KSambaShareModel::data(const QModelIndex &index, int role) const +{ + if (!index.isValid()) { + return {}; + } + + Q_ASSERT(index.row() < m_list.length()); + Q_ASSERT(index.column() < static_cast(ColumnRole::ColumnCount)); + if (role == Qt::DisplayRole) { + switch (static_cast(index.column())) { + case ColumnRole::Name: + return m_list.at(index.row()).name(); + case ColumnRole::Path: + return m_list.at(index.row()).path(); + case ColumnRole::Comment: + return m_list.at(index.row()).comment(); + case ColumnRole::ColumnCount: + break; // noop + } + } + + return {}; +} + +void KSambaShareModel::reloadData() +{ + beginResetModel(); + m_list.clear(); + const auto samba = KSambaShare::instance(); + for (const auto &path : samba->sharedDirectories()) { + m_list += samba->getSharesByPath(path); + } + endResetModel(); +} + +bool KSambaShareModel::hasChildren(const QModelIndex &parent) const +{ + return !parent.isValid() ? false : (rowCount(parent) > 0); +} diff --git a/Modules/samba/ksmbstatus.h b/Modules/samba/ksmbstatus.h deleted file mode 100644 --- a/Modules/samba/ksmbstatus.h +++ /dev/null @@ -1,61 +0,0 @@ -/* - * ksmbstatus.h - * - * - * This program is free software; you can redistribute it and/or modify - * it under the terms of the GNU General Public License as published by - * the Free Software Foundation; either version 2 of the License, or - * (at your option) any later version. - * - * This program is distributed in the hope that it will be useful, - * but WITHOUT ANY WARRANTY; without even the implied warranty of - * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the - * GNU General Public License for more details. - * - * You should have received a copy of the GNU General Public License - * along with this program; if not, write to the Free Software - * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. - */ -#ifndef ksmbstatus_h_included -#define ksmbstatus_h_included - -#include -#include -#include -#include - -#include - -#define SCREEN_XY_OFFSET 20 - -class NetMon : public QWidget { -Q_OBJECT -public: - explicit NetMon(QWidget *parent, KConfig * config=0); - void saveSettings() { - } - void loadSettings() { - } -private: - KConfig *configFile; - QProcess *showmountProc; - QTreeWidget *list; - QLabel *version; - QTimer *timer; - int rownumber; - enum {header, connexions, locked_files, finished, nfs} readingpart; - int lo[65536]; - int nrpid; - void processNFSLine(char *bufline, int linelen); - void processSambaLine(char *bufline, int linelen); - - QByteArray strShare, strUser, strGroup, strMachine, strSince, strPid; - int iUser, iGroup, iMachine, iPid; - -private Q_SLOTS: - void killShowmount(); - void update(); - void readFromProcess(); -}; - -#endif // main_included diff --git a/Modules/samba/ksmbstatus.cpp b/Modules/samba/ksmbstatus.cpp deleted file mode 100644 --- a/Modules/samba/ksmbstatus.cpp +++ /dev/null @@ -1,210 +0,0 @@ -/* - * ksmbstatus.cpp - * - * This program is free software; you can redistribute it and/or modify - * it under the terms of the GNU General Public License as published by - * the Free Software Foundation; either version 2 of the License, or - * (at your option) any later version. - * - * This program is distributed in the hope that it will be useful, - * but WITHOUT ANY WARRANTY; without even the implied warranty of - * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the - * GNU General Public License for more details. - * - * You should have received a copy of the GNU General Public License - * along with this program; if not, write to the Free Software - * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. - */ - -#include -#include -#include -#include -#include - -#include - -#include -#include - -#include "ksmbstatus.h" - -#define Before(ttf,in) in.left(in.indexOf(ttf)) -#define After(ttf,in) (in.contains(ttf)?QString(in.mid(in.indexOf(ttf)+QString(ttf).length())):QLatin1String("")) - -NetMon::NetMon(QWidget * parent, KConfig *config) : - QWidget(parent), configFile(config), showmountProc(nullptr), strShare(""), strUser(""), strGroup(""), strMachine(""), strSince(""), strPid(""), iUser(0), iGroup(0), iMachine(0), iPid(0) { - QBoxLayout *topLayout = new QVBoxLayout(this); - - list = new QTreeWidget(this); - topLayout->addWidget(list); - version=new QLabel(this); - version->setTextInteractionFlags(Qt::TextSelectableByMouse); - topLayout->addWidget(version); - - list->setAllColumnsShowFocus(true); - list->setMinimumSize(425, 200); - - QStringList headers; - headers << i18n("Type") << i18n("Service") << i18n("Accessed From") - << i18n("UID") << i18n("GID") << i18n("PID") << i18n("Open Files"); - list->setHeaderLabels(headers); - - timer = new QTimer(this); - timer->start(15000); - QObject::connect(timer, &QTimer::timeout, this, &NetMon::update); - update(); -} - -void NetMon::processNFSLine(char *bufline, int) { - QByteArray line(bufline); - if (line.contains(":/")) { - QTreeWidgetItem *item = new QTreeWidgetItem(list); - item->setText(0, QStringLiteral("NFS")); - item->setText(0, After(QLatin1String(":"),QString::fromUtf8(line))); - item->setText(0, Before(QLatin1String(":/"),QString::fromUtf8(line))); - } -} - -void NetMon::processSambaLine(char *bufline, int) { - QByteArray line(bufline); - rownumber++; - if (rownumber == 2) - version->setText(QString::fromUtf8(bufline)); // second line = samba version - if ((readingpart==header) && line.contains("Service")) { - iUser=line.indexOf("uid"); - iGroup=line.indexOf("gid"); - iPid=line.indexOf("pid"); - iMachine=line.indexOf("machine"); - } else if ((readingpart==header) && (line.contains("---"))) { - readingpart=connexions; - } else if ((readingpart==connexions) && (int(line.length())>=iMachine)) { - strShare=line.mid(0, iUser); - strUser=line.mid(iUser, iGroup-iUser); - strGroup=line.mid(iGroup, iPid-iGroup); - strPid=line.mid(iPid, iMachine-iPid); - - line=line.mid(iMachine, line.length()); - strMachine=line; - QTreeWidgetItem * item = new QTreeWidgetItem(list); - item->setText(0, QStringLiteral("SMB")); - item->setText(1, QString::fromUtf8(strShare)); - item->setText(2, QString::fromUtf8(strMachine)); - item->setText(3, QString::fromUtf8(strUser)); - item->setText(4, QString::fromUtf8(strGroup)); - item->setText(5, QString::fromUtf8(strPid)/*,strSince*/); - } else if (readingpart==connexions) - readingpart=locked_files; - else if ((readingpart==locked_files) && (line.indexOf("No ")==0)) - readingpart=finished; - else if (readingpart==locked_files) { - if ((strncmp(bufline, "Pi", 2) !=0) // "Pid DenyMode ..." - && (strncmp(bufline, "--", 2) !=0)) // "------------" - { - char *tok=strtok(bufline, " "); - if (tok) { - int pid=atoi(tok); - (lo)[pid]++; - } - } - } -} - -// called when we get some data from smbstatus -// can be called for any size of buffer (one line, several lines, -// half of one ...) -void NetMon::readFromProcess() { - QProcess *process = qobject_cast(sender()); - if (!process || !process->canReadLine()) - return; - - qint64 buflen = 8046; // 8k enough? - char buffer[buflen]; - buflen = process->readLine(buffer, buflen); - ////qDebug()<<"received stuff"; - char s[250], *start, *end; - size_t len; - start = buffer; - while ((end = strchr(start, '\n'))) // look for '\n' - { - len = end-start; - if (len>=sizeof(s)) - len=sizeof(s)-1; - strncpy(s, start, len); - s[len] = '\0'; - ////qDebug() << "received: "<viewport()->update(); - list->update(); - } - */ - // here we could save the remaining part of line, if ever buffer - // doesn't end with a '\n' ... but will this happen ? -} - -void NetMon::update() { - QProcess *process = new QProcess(); - - memset(&lo, 0, sizeof(lo)); - list->clear(); - /* Re-read the Contents ... */ - - QString path(QString::fromUtf8(::getenv("PATH"))); - path += QLatin1String("/bin:/sbin:/usr/bin:/usr/sbin"); - - rownumber=0; - readingpart=header; - nrpid=0; - process->setEnvironment(QStringList() << (QStringLiteral("PATH=") + path)); - connect(process, &QProcess::readyRead, this, &NetMon::readFromProcess); - process->start(QStringLiteral("smbstatus")); - if (!process->waitForFinished()) { - version->setText(i18n("Error run smbstatus: %1", process->errorString())); - } else { - if (rownumber==0) // empty result - version->setText(i18n("Error: Unable to open configuration file \"smb.conf\"")); - else { - // ok -> count the number of locked files for each pid - for (int i = 0; i < list->topLevelItemCount(); ++i) - { - QTreeWidgetItem *row = list->topLevelItem(i); - // cerr<<"NetMon::update: this should be the pid: "<text(5)<text(5).toInt(); - row->setText(6,QStringLiteral("%1").arg((lo)[pid])); - } - } - } - - delete process; - process=nullptr; - - readingpart=nfs; - delete showmountProc; - showmountProc=new QProcess(); - connect(showmountProc, &QProcess::readyRead, this, &NetMon::readFromProcess); - showmountProc->setEnvironment(QStringList() << (QStringLiteral("PATH=") + path)); - //without this timer showmount hangs up to 5 minutes - //if the portmapper daemon isn't running - QTimer::singleShot(5000,this,&NetMon::killShowmount); - ////qDebug()<<"starting kill timer with 5 seconds"; - connect(showmountProc, static_cast(&QProcess::finished), this, &NetMon::killShowmount); - connect(showmountProc, &QProcess::errorOccurred, this, &NetMon::killShowmount); - showmountProc->start(QStringLiteral("showmount"), QStringList() << QStringLiteral("-a") << QStringLiteral("localhost")); - - version->adjustSize(); - list->show(); -} - -void NetMon::killShowmount() { - ////qDebug()<<"killShowmount()"; - showmountProc->deleteLater(); - showmountProc=nullptr; -} - diff --git a/Modules/samba/main.cpp b/Modules/samba/main.cpp --- a/Modules/samba/main.cpp +++ b/Modules/samba/main.cpp @@ -1,105 +1,82 @@ /* - * main.cpp for the samba kcontrol module - * - * This program is free software; you can redistribute it and/or modify - * it under the terms of the GNU General Public License as published by - * the Free Software Foundation; either version 2 of the License, or - * (at your option) any later version. - * - * This program is distributed in the hope that it will be useful, - * but WITHOUT ANY WARRANTY; without even the implied warranty of - * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the - * GNU General Public License for more details. - * - * You should have received a copy of the GNU General Public License - * along with this program; if not, write to the Free Software - * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. - */ + SPDX-FileCopyrightText: 2020 Harald Sitter + SPDX-License-Identifier: GPL-2.0-only OR GPL-3.0-only OR LicenseRef-KDE-Accepted-GPL +*/ -#include - -#include -#include -#include +#include +#include #include -#include "kcmsambaimports.h" -#include "kcmsambalog.h" -#include "kcmsambastatistics.h" -#include "ksmbstatus.h" +#include #include +#include +#include +#include + +#include "ksambasharemodel.h" +#include "smbmountmodel.h" class SambaContainer : public KCModule { Q_OBJECT public: - SambaContainer(QWidget *parent=nullptr, const QVariantList &list = QVariantList()); - virtual ~SambaContainer(); - void load() override; - void save() override; + SambaContainer(QWidget *parent = nullptr, const QVariantList &list = QVariantList()); + ~SambaContainer() override = default; private: - KConfig config; - QTabWidget tabs; - NetMon status; - ImportsView imports; - LogView logView; - StatisticsView statisticsView; + QTableView *addTableView(const QString &localizedLabel, QAbstractListModel *model); }; K_PLUGIN_FACTORY(SambaFactory, registerPlugin(); ) -SambaContainer::SambaContainer(QWidget *parent, const QVariantList&) : - KCModule(parent), config(QStringLiteral("kcmsambarc")), tabs(this), status(&tabs, &config), imports(&tabs, &config), logView(&tabs, &config), statisticsView(&tabs, &config) { - QVBoxLayout *layout = new QVBoxLayout( this ); - layout->setContentsMargins(0, 0, 0, 0); - layout->setSpacing(0); - layout->addWidget(&tabs); - tabs.addTab(&status, i18n("&Exports")); - tabs.addTab(&imports, i18n("&Imports")); - tabs.addTab(&logView, i18n("&Log")); - tabs.addTab(&statisticsView, i18n("&Statistics")); - connect(&logView, &LogView::contentsChanged, &statisticsView, &StatisticsView::setListInfo); - setButtons(Help); - - setQuickHelp(i18n("

The Samba and NFS Status Monitor is a front end to the programs" - " smbstatus and showmount. Smbstatus reports on current" - " Samba connections, and is part of the suite of Samba tools, which" - " implements the SMB (Session Message Block) protocol, also called the" - " NetBIOS or LanManager protocol. This protocol can be used to provide" - " printer sharing or drive sharing services on a network including" - " machines running the various flavors of Microsoft Windows.

")); - - KAboutData *about = new KAboutData(i18n("kcmsamba"), - i18n("System Information Control Module"), - QString(), QString(), KAboutLicense::GPL, - i18n("(c) 2002 KDE Information Control Module Samba Team")); - about->addAuthor(i18n("Michael Glauche"), QString(), QStringLiteral("glauche@isa.rwth-aachen.de")); - about->addAuthor(i18n("Matthias Hoelzer"), QString(), QStringLiteral("hoelzer@kde.org")); +SambaContainer::SambaContainer(QWidget *parent, const QVariantList &) + : KCModule(parent) +{ + KAboutData *about = new KAboutData(i18n("kcmsamba"), + i18n("System Information Control Module"), + QString(), QString(), KAboutLicense::GPL, + i18n("(c) 2002 KDE Information Control Module Samba Team")); + about->addAuthor(i18n("Michael Glauche"), QString(), QStringLiteral("glauche@isa.rwth-aachen.de")); + about->addAuthor(i18n("Matthias Hoelzer"), QString(), QStringLiteral("hoelzer@kde.org")); about->addAuthor(i18n("David Faure"), QString(), QStringLiteral("faure@kde.org")); about->addAuthor(i18n("Harald Koschinski"), QString(), QStringLiteral("Harald.Koschinski@arcormail.de")); about->addAuthor(i18n("Wilco Greven"), QString(), QStringLiteral("greven@kde.org")); about->addAuthor(i18n("Alexander Neundorf"), QString(), QStringLiteral("neundorf@kde.org")); + about->addAuthor(i18n("Harald Sitter"), QString(), QStringLiteral("sitter@kde.org")); setAboutData(about); -} -SambaContainer::~SambaContainer() { - save(); -} + QVBoxLayout *layout = new QVBoxLayout(this); + Q_ASSERT(this->layout()); + setLayout(layout); + + addTableView(i18n("&Exports"), new KSambaShareModel(this)); -void SambaContainer::load() { - status.loadSettings(); - imports.loadSettings(); - logView.loadSettings(); - statisticsView.loadSettings(); + auto importsView = addTableView(i18n("&Imports"), new SmbMountModel(this)); + importsView->horizontalHeader()->setSectionResizeMode(static_cast(SmbMountModel::ColumnRole::Accessible), + QHeaderView::ResizeToContents); + + setButtons(Help); } -void SambaContainer::save() { - status.saveSettings(); - imports.saveSettings(); - logView.saveSettings(); - statisticsView.saveSettings(); - config.sync(); +QTableView *SambaContainer::addTableView(const QString &localizedLabel, QAbstractListModel *model) +{ + QString text = localizedLabel; + auto title = new KTitleWidget(this); + // hackily remove ampersand to not break i18n too much in 5.18 + // TODO: replace i18n'd string to one without quick access marker + title->setText(text.remove("&")); + title->setLevel(2); + layout()->addWidget(title); + + auto view = new QTableView(this); + layout()->addWidget(view); + view->setModel(model); + view->horizontalHeader()->setSectionResizeMode(QHeaderView::Stretch); + view->horizontalHeader()->reset(); + view->horizontalHeader()->setVisible(true); + view->verticalHeader()->setVisible(false); + + return view; } #include "main.moc" diff --git a/Modules/samba/smbmountmodel.h b/Modules/samba/smbmountmodel.h new file mode 100644 --- /dev/null +++ b/Modules/samba/smbmountmodel.h @@ -0,0 +1,51 @@ +/* + SPDX-FileCopyrightText: 2020 Harald Sitter + SPDX-License-Identifier: GPL-2.0-only OR GPL-3.0-only OR LicenseRef-KDE-Accepted-GPL +*/ + +#ifndef SMBMOUNTMODEL_H +#define SMBMOUNTMODEL_H + +#include +#include +#include + +/** + * Model of cifs mount entires. Implementing properties + * as columns rather than roles. + */ +class SmbMountModel : public QAbstractListModel +{ + Q_OBJECT +public: + enum class ColumnRole { + Share, + Path, + Accessible, + ColumnCount, // End marker + }; + + explicit SmbMountModel(QObject *parent = nullptr); + ~SmbMountModel() override; + + int rowCount(const QModelIndex &parent) const override; + int columnCount(const QModelIndex &parent) const override; + QVariant headerData(int section, Qt::Orientation orientation, int role) const override; + QVariant data(const QModelIndex &index, int role) const override; + bool hasChildren(const QModelIndex &parent) const override; + +private slots: + void addDevice(const QString &udi); + void removeDevice(const QString &udi); + void reloadData(); + +private: + inline QList devices() const + { + return m_uidDeviceMap.values(); + } + + QMap m_uidDeviceMap; +}; + +#endif // SMBMOUNTMODEL_H diff --git a/Modules/samba/smbmountmodel.cpp b/Modules/samba/smbmountmodel.cpp new file mode 100644 --- /dev/null +++ b/Modules/samba/smbmountmodel.cpp @@ -0,0 +1,152 @@ +/* + SPDX-FileCopyrightText: 2020 Harald Sitter + SPDX-License-Identifier: GPL-2.0-only OR GPL-3.0-only OR LicenseRef-KDE-Accepted-GPL +*/ + +#include "smbmountmodel.h" + +#include +#include +#include +#include +#include +#include +#include + +SmbMountModel::SmbMountModel(QObject *parent) + : QAbstractListModel(parent) +{ + connect(Solid::DeviceNotifier::instance(), &Solid::DeviceNotifier::deviceAdded, + this, &SmbMountModel::addDevice); + connect(Solid::DeviceNotifier::instance(), &Solid::DeviceNotifier::deviceRemoved, + this, &SmbMountModel::removeDevice); + reloadData(); +} + +SmbMountModel::~SmbMountModel() = default; + +int SmbMountModel::rowCount(const QModelIndex &parent) const +{ + Q_UNUSED(parent) + return devices().size(); +} + +int SmbMountModel::columnCount(const QModelIndex &parent) const +{ + Q_UNUSED(parent) + return static_cast(ColumnRole::ColumnCount); +} + +QVariant SmbMountModel::headerData(int section, Qt::Orientation orientation, int role) const +{ + if (orientation != Qt::Horizontal || role != Qt::DisplayRole) { + return {}; // we only have column headers. + } + + Q_ASSERT(section < static_cast(ColumnRole::ColumnCount)); + switch (static_cast(section)) { + case ColumnRole::Share: + return i18n("Resource"); // TODO: maybe reword for 5.19 + case ColumnRole::Path: + return i18n("Mounted Under"); // TODO: maybe reword for 5.19 + case ColumnRole::Accessible: + return i18nc("@title:column whether a samba share is accessible locally (i.e. mounted)", "Accessible"); + case ColumnRole::ColumnCount: + break; // noop + } + + return {}; +} + +QVariant SmbMountModel::data(const QModelIndex &index, int role) const +{ + if (!index.isValid()) { + return {}; + } + + Q_ASSERT(index.row() < m_uidDeviceMap.count()); + Q_ASSERT(index.column() < static_cast(ColumnRole::ColumnCount)); + + if (role == Qt::DisplayRole) { + switch (static_cast(index.column())) { + case ColumnRole::Share: + return devices().at(index.row()).as()->url(); + case ColumnRole::Path: + return devices().at(index.row()).as()->filePath(); + case ColumnRole::Accessible: + break; // Decoration only + case ColumnRole::ColumnCount: + break; // noop + } + } + + if (role == Qt::DecorationRole) { + switch (static_cast(index.column())) { + case ColumnRole::Accessible: + // Using characters here since we use a QTableView and can't just + return devices().at(index.row()).as()->isAccessible() + ? QIcon::fromTheme("dialog-ok") + : QIcon::fromTheme("dialog-cancel"); + case ColumnRole::Share: + case ColumnRole::Path: + break; // Display only + case ColumnRole::ColumnCount: + break; // noop + } + } + + return {}; +} + +void SmbMountModel::addDevice(const QString &udi) +{ + const Solid::Device device(udi); + if (m_uidDeviceMap.contains(udi) || !device.is()) { + return; + } + beginInsertRows(QModelIndex(), m_uidDeviceMap.count(), m_uidDeviceMap.count()); + m_uidDeviceMap[udi] = device; + endInsertRows(); +} + +void SmbMountModel::removeDevice(const QString &udi) +{ + auto it = std::find_if(m_uidDeviceMap.begin(), + m_uidDeviceMap.end(), + [&udi](const Solid::Device &device) { + return device.udi() == udi; + }); + + if (it == m_uidDeviceMap.constEnd()) { + return; + } + + int index = static_cast(std::distance(m_uidDeviceMap.begin(), it)); + + beginRemoveRows(QModelIndex(), index, index); + m_uidDeviceMap.erase(it); + endRemoveRows(); +} + +void SmbMountModel::reloadData() +{ + beginResetModel(); + m_uidDeviceMap.clear(); + const auto devices = Solid::Device::listFromType(Solid::DeviceInterface::NetworkShare); + for (auto it = devices.begin(); it != devices.end(); ++it) { + switch (it->as()->type()) { + case Solid::NetworkShare::Cifs: + m_uidDeviceMap[it->udi()] = *it; + continue; + case Solid::NetworkShare::Nfs: + case Solid::NetworkShare::Unknown: + continue; + } + } + endResetModel(); +} + +bool SmbMountModel::hasChildren(const QModelIndex &parent) const +{ + return !parent.isValid() ? false : (rowCount(parent) > 0); +}