pax_global_header00006660000000000000000000000064144362716740014530gustar00rootroot0000000000000052 comment=8fb58f2255a48b19f46f00e50ac90162b757c1b1 itools-1.1/000077500000000000000000000000001443627167400127025ustar00rootroot00000000000000itools-1.1/AUTHORS000066400000000000000000000005441443627167400137550ustar00rootroot00000000000000#-- # $Id: AUTHORS 10333 2004-07-18 10:11:47Z thamer $ #-- (To reach any/all of the contributors mail to developer -at- arabeyes . org) Thamer Mahmoud: - Various updates due to ITL library changes - Various bug fixes and enhacements to ipraytime Nadim Shaikli: - Added ical/idate/ipraytime applications based on ITL's demo applications - Added manpages itools-1.1/COPYING000066400000000000000000000440541443627167400137440ustar00rootroot00000000000000 -* Disclaimer *- This software package/product and attached documentations are provided "as is", with no warranty. -* www.arabeyes.org *- If you'd like to help the Arabeyes Project, then consider: http://www.arabeyes.org/donate.php -- This package is subject to the GNU GENERAL PUBLIC (GPL) LICENSE (Version 2). See below for details or http://www.gnu.org/copyleft/gpl.html -- -* www.gnu.org *- GNU GENERAL PUBLIC LICENSE Version 2, June 1991 Copyright (C) 1989, 1991 Free Software Foundation, Inc. 59 Temple Place, Suite 330, Boston, MA 02111-1307 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 Library 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. GNU GENERAL PUBLIC LICENSE 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., 59 Temple Place, Suite 330, Boston, MA 02111-1307 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 Library General Public License instead of this License. itools-1.1/ChangeLog000066400000000000000000000000111443627167400144440ustar00rootroot00000000000000See NEWS itools-1.1/Makefile.am000066400000000000000000000004221443627167400147340ustar00rootroot00000000000000bin_PROGRAMS = ical idate ipraytime ical_LDADD= -litl -lm ical_SOURCES = ical.c idate_LDADD= -litl -lm idate_SOURCES = idate.c ipraytime_LDADD= -litl -lm ipraytime_SOURCES = ipraytime.c bin_SCRIPTS=ireminder man_MANS=doc/ical.1 doc/idate.1 doc/ipraytime.1 doc/ireminder.1 itools-1.1/NEWS000066400000000000000000000026261443627167400134070ustar00rootroot00000000000000/************************************************************************ * $Id$ * * ------------ * Description: * ------------ * This file is about changes to itools. For now, the style of the * file follows the format used in Emacs org-mode. * * ----------------- * Revision Details: (Updated by Revision Control System) * ----------------- * $Date$ * $Author$ * $Revision$ * $Source$ * ************************************************************************/ * Changes in itools-1.1 ** New Features *** Add new prayertime calc method names *** Read config file from ~/.iprayrc or /itools/iprayrc ** Bug fixes *** Fix spelling mistake in manpage *** Fix string format security ** Build process *** Replace old configure scripts with autoconf scripts * Changes in itools-1.0 ** New Features *** ireminder: Added -execr and -execs options for external application triggers at Athan. *** ipraytime: Adding support for passing arguments --fajrangle and --ishaangle. *** ipraytime: Adding option "OffsetList" to add and subtract minutes or seconds from numbers computed by ipraytime. *** ipraytime: Improved man-page and added examples. ** Bug fixes *** ipraytime: Fixed crashes with regards to memory allocation. ** Build process *** configure now checks for lib32 and lib64 also. *** Switched to using install instead of cp (this would automatically preserve proper permissions). itools-1.1/README000066400000000000000000000033141443627167400135630ustar00rootroot00000000000000/************************************************************************ * $Id: README 10344 2004-07-28 23:11:30Z nadim $ * * ------------ * Description: * ------------ * This README file is intended to be give a glimpse of what the * Islamic Tools Library (ITL) project is all about. * * For INSTALL details note the 'Basic Instructions' section below. * * ----------------- * Revision Details: (Updated by Revision Control System) * ----------------- * $Date: 2004-07-29 01:11:30 +0200 (Thu, 29 Jul 2004) $ * $Author: nadim $ * $Revision: 10344 $ * $Source$ * ************************************************************************/ The itools package is a set of user friendly applications utilizing Arabeyes' ITL library. The package currently addresses two main areas - hijri date and prayertime calculation. The package is envisioned to mimick the development of the underlying ITL library and is meant to always give the end-user a simple means to access its functions. The project's homepage is, http://www.arabeyes.org/project.php?proj=ITL ------------------- Basic Instructions: ------------------- + Download and install the ITL-lib (the actual library component) + Download the install the ITL-tools (ie. itools package) - Compile the package $ autoreconf -f -i $ configure $ make - To install post a succesful compilation, $ make install -------------------- Support/Suggestions: -------------------- The project is always in need of volunteers, so if you think you have a better implementation and/or would like to augment the library with an addition of your own, mail your ideas, comments and suggestions to 'developer -at- arabeyes .org' Salam and have fun! itools-1.1/config.h.in000066400000000000000000000002151443627167400147230ustar00rootroot00000000000000/* $Id: config.h.in 10331 2004-07-17 01:26:54Z nadim $ */ /* Define to 1 if `tm_gmtoff' is member of `struct tm'. */ #undef HAVE_TM_GMTOFF itools-1.1/configure.ac000066400000000000000000000015731443627167400151760ustar00rootroot00000000000000# -*- Autoconf -*- # Process this file with autoconf to produce a configure script. AC_PREREQ([2.69]) AC_INIT([itools], [1.0], [https://github.com/arabeyes-org/itools/issues/new]) AM_INIT_AUTOMAKE() AC_CONFIG_SRCDIR([ipraytime.c]) AC_CONFIG_HEADERS([config.h]) # Checks for programs. AC_PROG_CC #AC_PROG_INSTALL AC_PROG_MAKE_SET # Checks for libraries. PKG_CHECK_MODULES(ITL, libitl, [], AC_CHECK_LIB([itl], [getNorthQibla], [], AC_MSG_ERROR([ITL library required])) ) AC_CHECK_LIB([m], [pow]) # Checks for header files. AC_CHECK_HEADERS([stdlib.h string.h sys/time.h unistd.h]) # Checks for typedefs, structures, and compiler characteristics. AC_CHECK_HEADER_STDBOOL AC_TYPE_UID_T # Checks for library functions. AC_FUNC_ERROR_AT_LINE AC_FUNC_MALLOC AC_FUNC_MKTIME AC_CHECK_FUNCS([strcasecmp]) AC_CONFIG_FILES([Makefile]) AC_OUTPUT itools-1.1/debian/000077500000000000000000000000001443627167400141245ustar00rootroot00000000000000itools-1.1/debian/changelog000066400000000000000000000010161443627167400157740ustar00rootroot00000000000000itools (1.0-1) unstable; urgency=low * New upstream release. -- Thamer Mahmoud Tue, 17 Mar 2009 20:26:02 +0300 itools (0.6.2-1) unstable; urgency=low * New upstream release. * Fixes: ireminder.pl should know where ipraytime is", thanks to Justin B Rye (Closes: #298813). -- Thamer Mahmoud Thu, 17 Mar 2005 01:29:53 +0300 itools (0.6.1-1) unstable; urgency=low * Initial Release. -- Thamer Mahmoud Mon, 27 Dec 2004 00:15:15 +0300 itools-1.1/debian/compat000066400000000000000000000000021443627167400153220ustar00rootroot000000000000004 itools-1.1/debian/control000066400000000000000000000015701443627167400155320ustar00rootroot00000000000000Source: itools Section: misc Priority: optional Maintainer: Thamer Mahmoud Build-Depends: debhelper (>= 4.0.0), libitl-dev Standards-Version: 3.8.0 Homepage: http://www.arabeyes.org/project.php?proj=ITL Package: itools Architecture: any Depends: ${shlibs:Depends}, ${perl:Depends} Description: Islamic hijri date and prayer time utilities The itools is a collection of command line tools that mimics the development of the underlying ITL library (libitl) and is meant to always give the end-user simple means to access its functions. The available tools are: . * ical: Display a Hijri calendar. * idate: Multi method Hijri/Gregorian date converter. * ipraytime: Prayer times and Qibla calculator and schedule table generator. * ireminder: Prayer time reminder Perl script. . This package is part of the Islamic Tools and Libraries project. . itools-1.1/debian/copyright000066400000000000000000000021001443627167400160500ustar00rootroot00000000000000This package was debianized by Thamer Mahmoud on Mon, 27 Dec 2004 00:15:15 +0300. It was downloaded from http://www.arabeyes.org/project.php?proj=ITL Upstream Author: Copyright (c) 2003-2009, Arabeyes, The ITL project developers (see AUTHORS file) License: 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. A copy of the GNU General Public License is available at `/usr/share/common-licenses/GPL' in the Debian GNU/Linux distribution or on the World Wide Web at `http://www.gnu.org/copyleft/gpl.html'. You can also obtain it by writing to the Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.itools-1.1/debian/dirs000066400000000000000000000000331443627167400150040ustar00rootroot00000000000000usr/bin usr/share/man/man1 itools-1.1/debian/docs000066400000000000000000000000171443627167400147750ustar00rootroot00000000000000README AUTHORS itools-1.1/debian/rules000077500000000000000000000052661443627167400152150ustar00rootroot00000000000000#!/usr/bin/make -f # -*- makefile -*- # Sample debian/rules that uses debhelper. # # This file was originally written by Joey Hess and Craig Small. # As a special exception, when this file is copied by dh-make into a # dh-make output file, you may use that output file without restriction. # This special exception was added by Craig Small in version 0.37 of dh-make. # # Modified to make a template file for a multi-binary package with separated # build-arch and build-indep targets by Bill Allombert 2001 # Uncomment this to turn on verbose mode. #export DH_VERBOSE=1 # This has to be exported to make some magic below work. export DH_OPTIONS DESTDIR := debian/itools mandir := $(DESTDIR)/usr/share/man install_file := install -m 644 CFLAGS = -Wall -g ifneq (,$(findstring noopt,$(DEB_BUILD_OPTIONS))) CFLAGS += -O0 else CFLAGS += -O2 endif configure: configure-stamp configure-stamp: dh_testdir # Add here commands to configure the package. ./configure prefix=$(CURDIR)/debian/itools/usr touch configure-stamp #Architecture build: build-arch build-arch: build-arch-stamp build-arch-stamp: configure-stamp # Add here commands to compile the arch part of the package. #$(MAKE) touch build-arch-stamp clean: dh_testdir dh_testroot # rm -f build-arch-stamp build-indep-stamp #CONFIGURE-STAMP# # Add here commands to clean up after the build process. # Is this right? rm -f config.log config.status config.cache dh_clean install: install-arch install-indep: dh_testdir dh_testroot dh_clean -k -i dh_installdirs -i # Add here commands to install the indep part of the package into # debian/-doc. #INSTALLDOC# dh_install -i install-arch: dh_testdir dh_testroot dh_clean -k -s dh_installdirs -s # Add here commands to install the arch part of the package into # debian/tmp. $(MAKE) debinstall dh_install -s # Must not depend on anything. This is to be called by # binary-arch/binary-indep # in another 'make' thread. binary-common: dh_testdir dh_testroot dh_installchangelogs dh_installdocs dh_installexamples dh_installman doc/ical.1 doc/idate.1 doc/ipraytime.1 doc/ireminder.1 dh_link dh_strip dh_compress dh_fixperms dh_perl dh_makeshlibs dh_installdeb dh_shlibdeps dh_gencontrol dh_md5sums dh_builddeb # Build architecture independant packages using the common target. # binary-indep: build-indep install-indep # $(MAKE) -f debian/rules DH_OPTIONS=-i binary-common # Build architecture dependant packages using the common target. binary-arch: build-arch install-arch $(MAKE) -f debian/rules DH_OPTIONS=-a binary-common binary: binary-arch binary-indep .PHONY: build clean binary-indep binary-arch binary install install-indep install-arch configure itools-1.1/doc/000077500000000000000000000000001443627167400134475ustar00rootroot00000000000000itools-1.1/doc/ical.1000066400000000000000000000100131443627167400144340ustar00rootroot00000000000000.\" -*- nroff -*- .\" $Id: ical.1 11011 2009-03-19 09:20:05Z thamer $ .\" .\" NOTE: Please adjust .TH date whenever modifying the manpage. .\" .TH IDATE "1" "January 05, 2005" "ical" "User Commands" .\" .SH NAME ical \- A Hijri/Islamic calendar (and converter) .\" .SH SYNOPSIS .B ical .RB [ \-\-gregorian .RI yyyymmdd] .RB [ \-\-hijri .RI yyyymmdd] .RB [ \-\-umm_alqura ] .RB [ \-\-fixed_view ] .RB [ \-\-dual ] .RB [ \-\-help ] .SH DESCRIPTION The \fBical\fR program is a Hijri/Islamic calendar displayer. It utilizes and includes a Gregorian to Hijri (and vice-versa) date converter. The application uses and offers multiple calculation methods with not all of them agreeing at all times. The reason for this multiplicity is due to not having one agreed upon method and so various entities develop and advocate their calculations. .PP \fBical\fR is able to comprehend and calculate both pre-epoch or pre-Hijrah, denoted as "B.H", as well as post-epoch or post-Hijrah, denoted as "A.H", dates. \fBical\fR also utilizes Gregorian's pre-epoch "B.C" and post-epoch "A.D" dates and notes them per its output. When entering pre-epoch years, negative numbers ought to be utilized. .PP \fBical\fR when run without any command-line options uses the host machine's Gregorian date and converts it to Hijri to display that month's view. Entries enclosed by [] denote exact day specified. .SH OPTIONS \fBical\fR follows the usual GNU command line syntax, with long options starting with two dashes (`-'). A summary of all options is noted below: .TP .B \-h, \-\-help Show summary of options .TP .B \-g, \-\-gregorian \fIyyyymmdd\fR Specify the Gregorian date to be converted where 'y' stands for year, 'm' for month and 'd' for day .TP .B \-hi, \-\-hijri \fIyyyymmdd\fR Specify the Hijri date to be converted where 'y' stands for year, 'm' for month and 'd' for day .TP .B \-u, \-\-umm_alqura Specify to use the Umm Al-Qura calculation method (used mostly in Saudi Arabia) .TP .B \-f, \-\-fixed_view Show a fixed week view (ie. start on Sun and end on Sat) else default to showing the preferred week view of the resulting calendar (Gregorian starts on Sunday, Hijri starts on Saturday) .TP .B \-d, \-\-dual Show both conversion from and to calendar months simultaneously .SH BACKGROUND The Hijri calendar is used in most of the Arab world and is the symbolic calendar of the Islamic faithed worldwide. This calendar is known as the "Hijri" (based on the word "Hijrah" - denoting migration in Arabic) to signal Prophet Mohammed's (PBUH) migration from Makkah to Medinah on Thursday, July 15, 622 AD (Julian). The Islamic Hijri calendar is strictly lunar (ie. moon-based) with twelve lunar months which do not correspond or track their solar counterparts (the Gregorian calendar is a solar or sun-based calendar). Lunar years and thus Hijri years are, on average, about 354 days long resulting in a Hijri year being roughly about 11 days shorter than its Gregorian counterpart. There is much discussion and confusion regarding how best to track the Hijri calendar. A great deal of that confusion is based on the fact that many relay on a human moon sighting to denote the start (or end) of a month (each month of the Hijri calendar starts when a new moon's crescent is observed or is made visible at sunset) as opposed to using an empirical mathematic certainty. The methods presented in this application and its underlying ITL library are strictly arithmetic in nature and do NOT take moon-phases into consideration (in short, observational approximation is not used). .SH LIMITATIONS There is currently no Umm Al-Qura support. .SH REPORTING BUGS Report bugs on the web using http://bugs.arabeyes.org .SH AUTHOR Written by Nadim Shaikli as part of the Arabeyes.org project. .SH COPYRIGHT \fBical\fR is subject to the GNU General Public License (GPL). .br Copyright \(co 2005, Arabeyes, Nadim Shaikli. .SH SEE ALSO \" .BR libitl (1). .PP The ITL (Islamic Tools Library). It is the underlying requirement for \fBical\fR to function. The ITL library was created and is hosted at \fBwww.arabeyes.org\fR. itools-1.1/doc/idate.1000066400000000000000000000073541443627167400146300ustar00rootroot00000000000000.\" -*- nroff -*- .\" $Id: idate.1 11011 2009-03-19 09:20:05Z thamer $ .\" .\" NOTE: Please adjust .TH date whenever modifying the manpage. .\" .TH IDATE "1" "January 05, 2005" "idate" "User Commands" .\" .SH NAME idate \- A Gregorian/Meladi to/from Hijri/Islamic date converter .\" .SH SYNOPSIS .B idate .RB [ \--gregorian .RI yyyymmdd ] .RB [ \--hijri .RI yyyymmdd ] .RB [ \--simple] .RB [ \--umm_alqura ] .RB [ \--help ] .SH DESCRIPTION The \fBidate\fR program is a Gregorian to Hijri (and vice-versa) date converter. The application uses and offers multiple calculation methods with not all of them agreeing at all times. The reason for this multiplicity is due to not having one agreed upon method and so various entities develop and advocate their calculations. .PP \fBidate\fR is able to comprehend and calculate both pre-epoch or pre-Hijrah, denoted as "B.H", as well as post-epoch or post-Hijrah, denoted as "A.H", dates. \fBidate\fR also utilizes Gregorian's pre-epoch "B.C" and post-epoch "A.D" dates and notes them per its output. When entering pre-epoch years, negative numbers ought to be utilized. .PP \fBidate\fR when run without any command-line options uses the host machine's current Gregorian date and converts it to Hijri. .SH OPTIONS \fBidate\fR follows the usual GNU command line syntax, with long options starting with two dashes (`-'). A summary of all options is noted below: .TP .B \-h, \-\-help Show summary of options .TP .B \-g, \-\-gregorian \fIyyyymmdd\fR Specify the Gregorian date to be converted where 'y' stands for year, 'm' for month and 'd' for day .TP .B \-hi, \-\-hijri \fIyyyymmdd\fR Specify the Hijri date to be converted where 'y' stands for year, 'm' for month and 'd' for day .TP .B \-s, \-\-simple Specify a simplified output mode .TP .B \-u, \-\-umm_alqura Specify to use the Umm Al-Qura calculation method (used mostly in Saudi Arabia) .SH BACKGROUND The Hijri calendar is used in most of the Arab world and is the symbolic calendar of the Islamic faithed worldwide. This calendar is known as the "Hijri" (based on the word "Hijrah" - denoting migration in Arabic) to signal Prophet Mohammed's (PBUH) migration from Makkah to Medinah on Thursday, July 15, 622 AD (Julian) or July 19, 622 AD (Gregorian). The Islamic Hijri calendar is strictly lunar (ie. moon-based) with twelve lunar months which do not correspond or track their solar counterparts (the Gregorian calendar is a solar or sun-based calendar). Lunar years and thus Hijri years are, on average, about 354 days long resulting in a Hijri year being roughly about 11 days shorter than its Gregorian counterpart. There is much discussion and confusion regarding how best to track the Hijri calendar. A great deal of that confusion is based on the fact that many rely on a human moon sighting to denote the start (or end) of a month (each month of the Hijri calendar starts when a new moon's crescent is observed or is made visible at sunset) as opposed to using an empirical mathematic certainty. The methods presented in this application and its underlying ITL library are strictly arithmetic in nature and do NOT take moon-phases into consideration (in short, observational approximation is not used). .SH LIMITATIONS The Umm Al-Qura option doesn't function with pre-epoch settings. .SH REPORTING BUGS Report bugs on the web using http://bugs.arabeyes.org .SH AUTHOR Written by Nadim Shaikli as part of the Arabeyes.org project. .SH COPYRIGHT \fBidate\fR is subject to the GNU General Public License (GPL). .br Copyright \(co 2005, Arabeyes, Nadim Shaikli. .SH SEE ALSO \" .BR libitl (1). .PP The ITL library (libitl) from the Islamic Tools and Libraries project. It is the underlying requirement for \fBidate\fR to function. The ITL library was created and is hosted at \fBwww.arabeyes.org\fR. itools-1.1/doc/ipraytime.1000066400000000000000000000351061443627167400155410ustar00rootroot00000000000000.\" \" -*- nroff -*- .\" \" $Id: ipraytime.1 11579 2010-05-06 13:59:19Z thamer $ .\" \" .\" \" - Define 'example' macro .\" .de EX .\" .ne 5 .\" .if n .sp 1 .\" .if t .sp .5 .\" .nf .\" .in +.5i .\" .. .\" .de EE .\" .fi .\" .in -.5i .\" .if n .sp 1 .\" .if t .sp .5 .\" .. .\" \" - Define 'example' macro .\" \" .\" \" NOTE: Please adjust .TH date whenever modifying the manpage. .\" \" .\" \" .\" .TH "IPRAYTIME" "1" "May 1, 2010" "ipraytime" "User Commands" .SH "NAME" ipraytime \- An Islamic Prayer Times Calculator .\" .SH "SYNOPSIS" .B ipraytime .RB [ \-\-date .RI yyyymmdd ] .RB [ \-\-latitude .RI real_num ] .RB [ \-\-longitude .RI real_num ] .RB [ \-\-utcdiff .RI real_num ] .RB [ \-\-method .RI int_num ] .RB [ \-\-ishaangle .RI real_num ] .RB [ \-\-fajrangle .RI real_num ] .RB [ \-\-dst .RI int_num ] .RB [ \-\-dst\-start .RI yyyymmdd ] .RB [ \-\-dst\-end .RI yyyymmdd ] .RB [ \-\-round .RI int_num ] .RB [ \-\-extreme .RI int_num ] .RB [ \-\-sea\-level .RI int_num ] .RB [ \-\-month .RI [int_num] ] .RB [ \-\-year .RI [int_num] ] .RB [ \-\-file .RI pref_file ] .RB [ \-\-end ] .RB [ \-\-brief ] .RB [ \-\-help ] .SH "DESCRIPTION" \fBipraytime\fR is a generator of Islamic prayer times for any given location. It is capable of generating daily, monthly, and yearly schedules based on user specified settings. In its single day output format, it can calculate the appropriate Qibla direction (heading towards the Kabaa) and Imsaak time (the time when one is to start fasting). \fBipraytime\fR also has a minimalistic option to show a brief one\-liner showing prayer times for a single day. .PP \fBipraytime\fR is configured using a file in the user's home directory (\fI~/.iprayrc\fR). For configuration and usage samples, see the \fBEXAMPLES\fR section below. It is also possible to specify settings using an environment variable (IPT_DATA) or through passing arguments to the command line (which takes precedent over all other settings). If none of the above is found, \fBipraytime\fR defaults to using Makkah's location with the host machine's current date settings. .SH "OPTIONS" A summary of all command\-line arguments and configuration options are noted below: .TP .B \-h, \-\-help Show summary of options. .TP .B \-d, \-\-date \fIyyyymmdd\fR Specify the Gregorian date to use where `y' stands for year, `m' for month and `d' for day. .TP .B \-lat, \-\-latitude \fIreal_num\fR Specify the latitude setting to use during calculations. The value could be any real number. .TP .B \-lon, \-\-longitude \fIreal_num\fR Specify the longitude setting to use during calculations. The value could be any real number. .TP .B \-sea, \-\-sea\-level \fIreal_num\fR Specify height above Sea level (in meters). .TP .B \-u, \-\-utcdiff \fIreal_num\fR Specify the difference between the specified timezone and that of GMT/UTC. The value could be any real number. .TP .B \-a, \-\-anglemethod \fI[int_num]\fR Specify which angle method calculation to use. The angle methods that are currently supported by \fIipraytime\fR are, .RS 8 .TP 4 .B 1 Egyptian General Authority of Survey Fajr/Isha Angle : 20/18 Used in : Africa, Indonesia, Iraq, Jordan, Lebanon, Malaysia, Singapore, Syria, Parts of the USA .TP 4 .B 2 University of Islamic Sciences, Karachi (Shaf'i) Fajr/Isha Angle : 18/18 Used in : Iran, Kuwait, Parts of Europe .TP 4 .B 3 University of Islamic Sciences, Karachi (Hanafi) Fajr/Isha Angle : 18/18 Used in : Afghanistan, Bangladesh, India .TP 4 .B 4 Islamic Society of North America Fajr/Isha Angle : 15/15 Used in : Canada, Parts of UK, Parts of USA .TP 4 .B 5 Muslim World League (MWL) Fajr/Isha Angle : 18/17 Used in : Parts of Europe, Far East, Parts of USA .TP 4 .B 6 Umm Al\-Qurra University Fajr/Isha Angl e : 19/0 Isha Interval : 90 minutes from Al\-Maghrib prayer but set to 120 during Ramadan. Used in : Saudi Arabia .TP 4 .B 7 Fixed Isha Angle Interval (always 90) Fajr/Isha Angle : 19.5/0 Isha Interval : 90 minutes from Al\-Maghrib prayer Used in : Bahrain, Oman, Qatar, UAE .TP 4 .B 8 Egyptian General Authority of Survey (Egypt) Fajr/Isha Angle : 19.5/17.5 Used in : Egypt .TP 4 .B 9 Om Al-Qurra University (Ramadan) Fajr/Isha Angle : 19/0 Isha Interval : 120 minutes from Al\-Maghrib prayer Used in : Saudi Arabia (during Ramadan) .TP 4 .B 10 Moonsighting Committee Worldwide (MWC) Fajr/Isha Angle : 18/18 (used for comparison) Fajr and Isha calculated with different values based on the season Used in : parts of the United States, parts of the UK .TP 4 .B 11 Morocco Awqaf Ministry Fajr/Isha Angle : 19/17 Zuhr Offset : 5 min Maghrib Offset : 5 min Used in : Morocco .RE .TP .B \-fa, \-\-fajrangle \fI[real_num]\fR Specify which angle to use for Fajr. Will override the one set by the \-\-anglemethod. .TP .B \-ia, \-\-ishaangle \fI[real_num]\fR Specify which angle to use for Isha. Will override the one set by the \-\-anglemethod. .TP .B \-s, \-\-dst \fI[int_num]\fR By default, \fBipraytime\fR uses the host's machine timezone information to determine whether daylight saving time is in effect or not. If this information is unavailable or not accurate, this option provides the means to explicitly set the DST status. Set this to 0 to completely disable daylight saving time. Set it to 1 to always add one hour to the computed prayer times. .PP .B \-ss, \-\-dst\-start \fIyyyymmdd\fR .br .B \-se, \-\-dst\-end \fIyyyymmdd\fR .br .RS Specify a range of dates where day light saving time is in effect for your location. For example: .RE .RS 12 .TP 4 ipraytime \-\-dst\-start 20040328 \-\-dst\-end 20041029 .RE .TP .B \-m, \-\-month \fI[int_num]\fR Specify to print either current month's schedule or the passed\-in value's month schedule. .TP .B \-y, \-\-year \fI[int_num]\fR Specify to print either current year's schedule or the passed\-in value's year schedule. .TP .B \-f, \-\-file \fIpref_file\fR Specify filename to load which contains user's settings and preferences. .TP .B \-e, \-\-end Specify to continue with schedule printing until the end of specified month. .TP .B \-b, \-\-brief Specify to print a brief one\-liner output for single day mode. .TP .B \-h12, \-\-regular\-hour Display the prayer times in regular time instead of military time. .TP .B \-r, \-\-round \fI[int_num]\fR Specify a method for rounding seconds. The supported methods are, .RS 8 .TP 4 .B 0 No Rounding. Completely ignore the computed seconds value. .TP 4 .B 1 Regular Rounding. If seconds are equal to 30 or above, add 1 minute. .TP 4 .B 2 Special Rounding. Similar to regular rounding but we always round down for Shurooq and Imsaak times. (This is the default method). .TP 4 .B 3 Aggressive Rounding. Similar to Special Rounding but we add 1 minute if the seconds value are equal to 1 second or more. .RE .TP .B \-x, \-\-extreme \fI[int_num]\fR Specify a method for prayer times calculations at high (49+) or extreme (66+) latitudes. Prayer times calculations relies heavily on astronomical events. At these latitudes some of those events do not occur at all, or are impossible to precisely calculate using conventional means. For example, at certain locations the sun never moves below the horizon to the position of the amount of Fajr angle degrees specified, therefore there will be no real Fajr time at that location. The supported extreme methods are: .RS 8 .PP 5 .B Note: Methods that have the \fBIf Invalid\fR keyword are applied only when \fBipraytime\fR is unable to calculate these times. Methods that have the \fBAlways\fR keyword are applied always. .TP 4 .B 0 None. If unable to calculate, leave as 99:99 .TP 4 .B 1 Nearest Latitude (Aqrab Al\-Bilaad): All prayers [Always] .TP 4 .B 2 Nearest Latitude (Aqrab Al\-Bilaad): Fajr and Isha [Always] .TP 4 .B 3 Nearest Latitude (Aqrab Al\-Bilaad): All prayers [If Invalid] .TP 4 .B 4 Nearest Good Day (Aqrab Al\-Ayyam): All prayers [Always] .TP 4 .B 5 Nearest Good Day (Aqrab Al\-Ayyam): All prayers [If Invalid] (This is the default method) .PP 4 .B Note: All the extreme methods following below do not have a proof in traditional Shari'a (Fiqh) resources. These methods were introduced by modern day Muslim scholars and scientists for practical reasons only. .TP 4 .B 6 Seventh of Night: Fajr and Isha [Always] .TP 4 .B 7 Seventh of Night: Fajr and Isha [If Invalid] .TP 4 .B 8 Seventh of Day: Fajr and Isha [Always] .TP 4 .B 9 Seventh of Day: Fajr and Isha [If Invalid] .TP 4 .B 10 Half of the Night: Fajr and Isha [Always] .TP 4 .B 11 Half of the Night: Fajr and Isha [If Invalid] .PP 4 .B Note: To use the next two methods, you will need to specify \fBFajrInterval\fR and \fBIshaInterval\fR in your configuration file. .TP 4 .B 12 Minutes from Shorooq/Maghrib: Fajr and Isha [Always] .TP 4 .B 13 Minutes from Shorooq/Maghrib: Fajr and Isha [If invalid] .TP 4 .B 14 Nearest Good Day: Fajr and Ishaa if either is invalid .TP 4 .B 15 Angle based: Fajr and Ishaa if invalid .RE .SH "CONFIGURATION" \fBipraytime\fR is capable of loading settings from a configuration file (\fI~/.iprayrc\fR). The default location of the configuration file can be changed using the \-\-file option. The content of the file should be in the following syntax `variable_string: value'. See the \fBEXAMPLES\fR section for usage examples. Below is a list of all the supported settings which can be used in the configuration file: .SS "Location Settings" .TP 2 .B City Specifies an informational city name string to be displayed for reference. .TP 2 .B Latitude Specify the latitude setting to use during calculations. The value could be any real number. .TP 2 .B Longitude Specify the longitude setting to use during calculations. The value could be any real number. .TP 2 .B UTC Specify the difference between the specified timezone and that of GMT/UTC. The value could be any real number. .TP 2 .B SeaLevel Specify height above Sea level (in meters). .TP 2 .B Pressure Specify the atmospheric pressure in millibars. The default value is 1010. .TP 2 .B Temperature Specify the temperature in Celsius degree. The default value is 10. .SS "Calculation Method Settings" .TP 2 .B AngleMethod Specify which angle method calculation to use. The value needs to be a positive integer of one of the supported methods. See the \-\-anglemethod option for more information. .TP 2 .B Mathhab Specify which mathhab to use in one's calculations. The current supported value are 1 for Shaf'i and 2 for Hanafi. .TP 2 .B OffsetList Specify a list of values in minutes to add or subtract any amount of minutes from the daily computed prayer times. For example, If you want to add 30 seconds to Maghrib and subtract 2 minutes from Isha, you will set this option to `0 0 0 0 0.5 \-2'. .TP 2 .B FajrAngle Specify the fajr angle to use during calculations. Will override the values of the specified method. .TP 2 .B IshaAngle Specify the isha angle to use during calculations. Will override the values of the specified method. .TP 2 .B ImsaakAngle Specify imsaak and fajr angle difference. The default value is 1.5 degrees. .TP 2 .B FajrInterval Specify the number of minutes between fajr and shorooq. This should be a positive integer. .TP 2 .B IshaInterval Specify the number of minutes between Isha and Maghrib. This should be a positive integer. .TP 2 .B ImsaakInterval Specify a difference in minutes between imsaak and fajr. The default Imsaak interval from fajr is 10 minutes if the FajrInterval is set. .TP 2 .B ExtremeMethod Specify which method to use for high and extreme latitudes. The value needs to be an integer of one of the supported extreme methods. See descriptions of the \-\-extreme option for a list of the supported methods. .TP 2 .B NearestLatitude Specify the latitude Used for the `Nearest Latitude' extreme methods. The default is at 48.5 degrees. .TP 2 .B RoundMethod Specify which method to use for rounding seconds. The value needs to be an integer of one of the supported rounding methods. See the \-\-round option for a list of the supported methods. .SS "Daylight Saving Time Settings" By default, \fBipraytime\fR uses the host's machine timezone information to determine whether daylight saving time is in effect or not. If this information is unavailable or not accurate, these options provide the means to explicitly set the DST status. .TP 2 .B DST Specify the current DST status. Set this to 0 to completely disable daylight saving time. Set it to 1 to always add one hour to the computed prayer times. .TP 2 .B DST\-Start Specify the start date when daylight saving time adjustment is in effect for your location. This value should be a valid date in yyyymmdd form. .TP 2 .B DST\-End Specify the date when daylight saving time adjustment period ends. This value should be a valid date in yyyymmdd form. .SS "Display Settings" .TP 2 .B HourFormat Specify a time format for displaying the prayer times. The value should be 12 (regular time) or 24 (military time). .SH "ENVIRONMENT" .TP 10 .B IPT_DATA One means to pass\-in the various required settings is via this variable. The format of the variable needs to be "LocationName Latitude Longitude UTCdiff AngleMethodNumber". For instance, .EX setenv IPT_DATA "Dubai 25.25 55.3 4 2" .SH FILES .I ~/.iprayrc User configuration file. .SH "EXAMPLES" .TP 4 A sample (\fB~/.iprayrc\fR) showing how options are set: .nf City: Brussels, Belguim Latitude: 50.8333 Longitude: 4.3333 UTC: 1 AngleMethod: 2 Mathhab: 1 OffsetList: 0 0 1 2.21 3 \-1 .fi .TP 4 Examples of using the command\-line options: .nf ipraytime \-y 2007 ipraytime \-f /home/user/.iprayrc\-Oman ipraytime \-lat 29.5000 \-lon 47.7500 \-u 3 \-\-anglemethod 2 \-d 20071229 \-h12 .fi .SH "REPORTING BUGS" Report bugs on the web using http://bugs.arabeyes.org .SH "AUTHORS" Written by Nadim Shaikli and Thamer Mahmoud. Part of the Arabeyes.org project. .SH "COPYRIGHT" \fBipraytime\fR is subject to the GNU General Public License (GPL). .br Copyright \(co 2005, Arabeyes, Nadim Shaikli. .br Copyright \(co 2005\-2010 Thamer Mahmoud .SH "SEE ALSO" \fBireminder\fR(1) \- Prayer time reminder script that uses \fBipraytime\fR. \" .BR libitl (1). .PP The ITL library (libitl) from the Islamic Tools and Libraries project. It is the underlying requirement for \fBipraytime\fR to function. The ITL library was created and is hosted at \fBwww.arabeyes.org\fR. itools-1.1/doc/ireminder.1000066400000000000000000000054621443627167400155160ustar00rootroot00000000000000.\" -*- nroff -*- .\" $Id: ireminder.1 11579 2010-05-06 13:59:19Z thamer $ .\" .\" NOTE: Please adjust .TH date whenever modifying the manpage. .\" .TH IREMINDER "1" "May 01, 2010" "ireminder" "User Commands" .\" .SH NAME ireminder \- Prayer time reminder .\" .SH SYNOPSIS .B ireminder .RB [ \-ipraytime .RI path] .RB [ \-skip .RI event_name] .RB [ \-reminder .RI minutes] .RB [ \-inplace] .RB [ \-execr .RI cmd] .RB [ \-execs .RI cmd] .RB [ \-help] .SH DESCRIPTION The \fBireminder\fR script is written in perl and is meant to be a simplistic wrapper to call and process the 'ipraytime' application. \fBireminder\fR is used to remind the user via audio indicators of an impending Islamic prayer event. .SH OPTIONS Some of the options within \fBireminder\fR allow for list inputs, those are meant to be a quoted series of text/numbers. .TP .B \-ipraytime \fIpath\fR Specify the path to the ipraytime executable. Unless this options is specified, the script will default to look for the binary in /usr/bin, /usr/local/bin and the current directory. .TP .B \-skip \fIevent_name\fR Specify name of prayer/event to skip, valid options include "imsaak fajr shorooq zuhr asr maghrib isha" (list ok). .TP .B \-reminder \fIminutes\fR Specify prior to how many minutes to remind (list ok). .TP .B \-inplace Specify to print output in-place (without scrolling). .TP .B \-execr \fIcmd\fR Specify an external application trigger for reminders. The %m directive is recognized and is substituted with the normal output message or string. The %s directive is recognized and is substituted by the salat's name. .TP .B \-execs \fIcmd\fR Specify an external application trigger for when the salat reaches its appointed time (ie. "salat now"). The %m directive is recognized and is substituted with the normal output message or string. The %s directive is recognized and is substituted by the salat's name. .TP .B \-help Produce a help screen. .SH "EXAMPLES" .TP 4 Here is an example of using \fBireminder\fR to display a message prayer time, ignoring imsaak and shorooq: .nf ireminder \-skip "imsaak shorooq" \-execs "notify\-send \-t 1000000 \\"Ireminder\\" \\"It is time for %s.\\"" & .TP 4 Another Example: .nf ireminder -execr "xmessage %m" -execs "xmessage %m" .fi .SH REPORTING BUGS Report bugs on the web using http://bugs.arabeyes.org .SH AUTHOR Written by Nadim Shaikli as part of the Arabeyes.org project. .SH COPYRIGHT \fBiremidner\fR is subject to the GNU General Public License (GPL). .br Copyright \(co 2006, Arabeyes, Nadim Shaikli. .SH "SEE ALSO" \fBipraytime(1) \- The underlying prayer times calculator used \fBiremidner\fR. .PP The ITL library (libitl) from the Islamic Tools and Libraries project. It is the underlying requirement for \fBireminder\fR to function. The ITL library was created and is hosted at \fBwww.arabeyes.org\fR. itools-1.1/ical.c000066400000000000000000000311731443627167400137630ustar00rootroot00000000000000/************************************************************************ * $Id: ical.c 10994 2009-03-09 04:17:36Z thamer $ * * ------------ * Description: * ------------ * Copyright (c) 2004, Arabeyes, Nadim Shaikli * * This is an application to primarily display Islamic/Hijri with * association to Gregorian/Meladi dates in 'cal' format (a month * at a time). * * ----------------- * Revision Details: (Updated by Revision Control System) * ----------------- * $Date: 2009-03-09 05:17:36 +0100 (Mon, 09 Mar 2009) $ * $Author: thamer $ * $Revision: 10994 $ * $Source$ * * (www.arabeyes.org - under GPL license) ************************************************************************/ /* TODO: */ #include #include #include /* for strlen/strcat/etc */ /* For time_t */ #ifdef TM_IN_SYS_TIME #include #else #include #endif #include #define PROG_NAME "ical"; /* This holds the current date info. */ typedef struct { int year; int month; int day; } Date; /** Print out the command-line usage of this application **/ void usage(int leave) { char *pspaces; char *pname = PROG_NAME; pspaces = (char *) malloc(strlen(pname)); strncpy(pspaces, " ", strlen(pname)); fprintf(stderr, "%s [--gregorian yyyymmdd] [--hijri yyyymmdd]\n", pname); fprintf(stderr, "%s [--umm_alqura]\n", pspaces); fprintf(stderr, "%s [--fixed_view]\n", pspaces); fprintf(stderr, "%s [--dual]\n", pspaces); fprintf(stderr, "%s [--help]\n", pspaces); free(pspaces); if (leave) exit(20); } /** Error printing (& possibly exit) apparatus. **/ void error(int leave, char* err_msg) { char *prog_name = PROG_NAME; fprintf(stderr, "[%s]: %s", prog_name, err_msg); if (leave) exit(leave); } /** Initizlize various variables/structures **/ void do_init(Date *mydate, sDate *pdate) { mydate->year = (int) NULL; mydate->month = (int) NULL; mydate->day = (int) NULL; pdate->day = (int) NULL; pdate->month = (int) NULL; pdate->year = (int) NULL; pdate->weekday = (int) NULL; pdate->frm_numdays = (int) NULL; pdate->to_numdays = (int) NULL; pdate->to_numdays2 = (int) NULL; pdate->frm_dname = (char *) NULL; pdate->frm_mname = (char *) NULL; pdate->frm_dname_sh = (char *) NULL; pdate->frm_mname_sh = (char *) NULL; pdate->to_dname = (char *) NULL; pdate->to_mname = (char *) NULL; pdate->to_dname_sh = (char *) NULL; pdate->to_mname_sh = (char *) NULL; pdate->event = (char **) NULL; } /** Printout the Resulting date struct along with itsoriginating month view **/ void display_dual(int using_umm_alqura, int doing_hijri, int fixed_view, Date *udate, sDate *rdate) { int i; int column; int calc_day; int end_calc_day; int wk_remap[7] = {1, 2, 3, 4, 5, 6, 0}; int wk_day; if (using_umm_alqura) printf("[Using Umm-AlQura Algorithm]\n"); /* Give us a month, year header */ printf("From/To (%s %d / %s", rdate->frm_mname, udate->year, rdate->to_mname); /* Figure out if we are dealing with 2 months on the result or just one */ if ((rdate->frm_numdays > rdate->to_numdays) || ((rdate->day + rdate->to_numdays - 1) > rdate->frm_numdays)) { printf(" - %s %d", rdate->to_mname2, rdate->year); if (rdate->month == 12) printf("-%d):\n", (rdate->year + 1)); else printf("):\n"); } else { printf(" %d):\n", rdate->year); } printf("\n"); /* Set columns headers */ if (doing_hijri) { if (fixed_view) { printf(" Sun/ Mon/ Tue/ Wed/ Thu/ Fri/ Sat/\n"); printf(" Ahd Ith Tha Arb Kha Jum Sab\n"); } else { printf(" Sat/ Sun/ Mon/ Tue/ Wed/ Thu/ Fri/\n"); printf(" Sab Ahd Ith Tha Arb Kha Jum\n"); } } else { printf(" Ahd/ Ith/ Tha/ Arb/ Kha/ Jum/ Sab/\n"); printf(" Sun Mon Tue Wed Thu Fri Sat\n"); } printf("-------------------------------------------------\n"); /* Do some remapping based on Fri being last day of week in Hijri - This is done as a nicety as most hijri calendars end on Friday */ if (doing_hijri & !fixed_view) wk_day = wk_remap[rdate->weekday]; else wk_day = rdate->weekday; /* Pad with empty space if starting within the week */ for(i = 0; i < wk_day; i++) { printf(" "); } column = wk_day + 1; calc_day = rdate->day; end_calc_day = 0; /* Fill in the month view with both FROM and TO values */ for(i = 1; i <= rdate->frm_numdays; i++) { if (i == udate->day) printf("[%02d/%02d]", i, calc_day++); else printf(" %02d/%02d ", i, calc_day++); /* Know when to start a new line */ if (!(column++ % 7)) printf("\n"); /* Know when to flip the secondary month's day roll-over */ if (!end_calc_day && (calc_day > rdate->to_numdays)) { calc_day = 1; end_calc_day = 1; } /* In the VERY unlikely case where the secondary has less days than primary such that 3 of the secondary's months are needed, know when to start over (yup, sheer paranoia). */ if (end_calc_day && (calc_day > rdate->to_numdays2)) { calc_day = 1; } } /* Print a new line if necessary */ if ((column % 7) != 1) printf("\n"); } /** Printout the Resulting date struct in minmal single format (akin to 'cal') **/ void display_single(int using_umm_alqura, int doing_hijri, int fixed_view, Date *udate, sDate *rdate) { int i; int shift; int column; int str_length; int dig_length; int start_point; int calc_day; int end_calc_day; int wk_remap[7] = {1, 2, 3, 4, 5, 6, 0}; int wk_day; if (using_umm_alqura) printf("[Using Umm-AlQura Algorithm]\n"); /* Since we get a particular day's info (not day #1), make adjustments */ shift = ((rdate->day % 7) - 1); /* Do some remapping based on Fri being last day of week in Hijri - This is done as a nicety as most hijri calendars end on Friday */ if (doing_hijri & !fixed_view) wk_day = wk_remap[rdate->weekday]; else wk_day = rdate->weekday; /* Based on day and weekday value of returned result, shift things about */ if (shift > wk_day) column = (wk_day - shift + 7 + 1); else column = (wk_day - shift + 1); /* Catch spill-over condition when dealing with lastday of week */ column = ( (column == 8) ? 1 : column); /* Give us a month, year header (nicely centered) */ if (rdate->year/10) dig_length = 1; if (rdate->year/100) dig_length += 1; if (rdate->year/1000) dig_length += 1; /* Try to center the title as much as possible over the output */ str_length = ( strlen(rdate->to_mname) + dig_length + 6); start_point = ( 14 - (str_length / 2)); for(i = 1; i < start_point; i++) printf(" "); printf("%s %d (%s)\n", rdate->to_mname, rdate->year, rdate->units); /* Set columns headers based on what we're converting to */ if (doing_hijri) if (fixed_view) { printf(" Ah I T Ar K J S\n"); } else { printf(" S Ah I T Ar K J\n"); } else printf(" S M Tu W Th F S\n"); /* Pad with empty space if starting within the week */ for(i = 0; i < column-1; i++) { printf(" "); } calc_day = rdate->day; end_calc_day = 0; /* Fill in the month view with both FROM and TO values */ for(i = 1; i <= rdate->to_numdays; i++) { if (i == rdate->day) printf("[%2d]", i); else printf(" %2d ", i); /* Know when to start a new line */ if (!(column++ % 7)) printf("\n"); /* Know when to flip the secondary month's day roll-over */ if (!end_calc_day && (calc_day > rdate->to_numdays)) { calc_day = 1; end_calc_day = 1; } /* In the very unlikely case were the secondary has less days than primary such that 3 of the secondary's months are needed, know when to start over */ if (end_calc_day && (calc_day > rdate->to_numdays2)) { calc_day = 1; } } /* Print a new line if necessary */ if ((column % 7) != 1) printf("\n"); } /** Main procedure **/ int main(int argc, char *argv[]) { int i; int g_to_h = 0; int h_to_g = 0; int use_umm_alqura = 0; int show_dual = 0; int fixed_week_view = 0; int error_lib = 0; int start_day; Date indate; sDate outdate; /* Current time/date specifics */ time_t mytime; struct tm *t_ptr; do_init(&indate, &outdate); /* Process the command-line */ for (i = 1; i < argc; i++) { if (strcasecmp(argv[i], "-h") == 0 || strcasecmp(argv[i], "-help") == 0 || strcasecmp(argv[i], "--help") == 0) { /* We really need a full-fledged help here */ usage(1); } if (strcasecmp(argv[i], "-g") == 0 || strcasecmp(argv[i], "-gregorian") == 0 || strcasecmp(argv[i], "--gregorian") == 0) { g_to_h = 1; if (argv[i+1] != NULL) { sscanf(&(argv[i + 1][0]), "%4d", &indate.year); sscanf(&(argv[i + 1][4]), "%2d", &indate.month); sscanf(&(argv[i + 1][6]), "%2d", &indate.day); } else { error(1, "Exiting, invalid argument to --gregorian\n"); } } if (strcasecmp(argv[i], "-hi") == 0 || strcasecmp(argv[i], "-hijri") == 0 || strcasecmp(argv[i], "--hijri") == 0) { h_to_g = 1; if (argv[i+1] != NULL) { sscanf(&(argv[i + 1][0]), "%4d", &indate.year); sscanf(&(argv[i + 1][4]), "%2d", &indate.month); sscanf(&(argv[i + 1][6]), "%2d", &indate.day); } else { error(1, "Exiting, invalid argument to --hijri\n"); } } if (strcasecmp(argv[i], "-u") == 0 || strcasecmp(argv[i], "-umm_alqura") == 0 || strcasecmp(argv[i], "--umm_alqura") == 0) { use_umm_alqura = 1; } if (strcasecmp(argv[i], "-f") == 0 || strcasecmp(argv[i], "--fixed_view") == 0) { fixed_week_view = 1; } if (strcasecmp(argv[i], "-d") == 0 || strcasecmp(argv[i], "--dual") == 0) { show_dual = 1; } } /* Make sure user knows what they are doing */ if (g_to_h && h_to_g) error(2, "Exiting, can't defined both Gregorian and Hijri\n"); /* Go with default current date if not user specifications */ if (!g_to_h && !h_to_g) { g_to_h = 1; /* Get current time structure */ time(&mytime); t_ptr = localtime(&mytime); /* Set current time values */ indate.day = t_ptr->tm_mday; indate.month = t_ptr->tm_mon + 1; indate.year = t_ptr->tm_year + 1900; } /* Inspect user's input or default settings - within range ? */ if ((indate.month > 12) || (indate.month < 1)) error(3, "Exiting, input 'month' not within allowable range\n"); if ((indate.day > 31) || (indate.day < 1)) error(3, "Exiting, input 'day' not within allowable range\n"); /* Specify our appropriate start day based on user mode */ start_day = ( show_dual ? 1 : indate.day ); /* TEMPORARY note due to no functionality */ if (use_umm_alqura) printf("NOTE: Umm Al-Qura has NOT been included YET (using other)\n"); /* Do the actual conversions */ if (g_to_h) { /* Dealing with Gregorian to Hijri conversion */ /* if (use_umm_alqura) G2H(&outdate, indate.day, indate.month, indate.year); else */ error_lib = h_date(&outdate, start_day, indate.month, indate.year); } else { /* Dealing with Hijri to Gregorian conversion */ /* if (use_umm_alqura) H2G(&outdate, indate.day, indate.month, indate.year); else */ error_lib = g_date(&outdate, start_day, indate.month, indate.year); } /* Let user know if the library freaked-out and returned with an error */ if (error_lib) { char msg[80]; sprintf(msg, "Exiting, error code %d generated by library call\n", error_lib); error(error_lib, msg); } /* Spill-out and display the output results */ if (show_dual) // display_dual(use_umm_alqura, g_to_h, &indate, &outdate); display_dual(0, g_to_h, fixed_week_view, &indate, &outdate); else // display_single(use_umm_alqura, g_to_h, &indate, &outdate); display_single(0, g_to_h, fixed_week_view, &indate, &outdate); return(0); } itools-1.1/idate.c000066400000000000000000000214451443627167400141420ustar00rootroot00000000000000/************************************************************************ * $Id: idate.c 10994 2009-03-09 04:17:36Z thamer $ * * ------------ * Description: * ------------ * Copyright (c) 2004, Arabeyes, Nadim Shaikli * * This is an application to primarily convert the Gregorian/Meladi * date to Islamic/Hijri (from Hijri to Meladi is also offered). * There are two distinct Hijri calculation conversion algorithms * available (the '--umm_alqura' selecting the calculation method * presented and advocated by the Saudi Umm Al-Qura University). * It is envisioned that both the non-umm_alqura and the umm_alqura * options will not always yield the same results. * * NOTE: Although the non-umm_alqura algorithm used is dated, it is * at this point the best implementation found. Work will be * on-going to improve its accuracy and implementation. * * ----------------- * Revision Details: (Updated by Revision Control System) * ----------------- * $Date: 2009-03-09 05:17:36 +0100 (Mon, 09 Mar 2009) $ * $Author: thamer $ * $Revision: 10994 $ * $Source$ * * (www.arabeyes.org - under GPL license) ************************************************************************/ /* TODO: - Define error exit codes (standardize 'em) and associate a string with each to print out to let user know what went wrong So far: 0 - Normal exit (no errors) 1 - User entered invalid argument to input 2 - User entered mututally-exclusive inputs 3 - User entered dates beyond acceptable ranges 10 - Can't malloc/attain memory 20 - User invoked help - Add a proper 'man' page and documentation */ #include #include #include /* for strlen/strcat/etc */ /* For time_t */ #ifdef TM_IN_SYS_TIME #include #else #include #endif #include #define PROG_NAME "idate"; /* This holds the current date info. */ typedef struct { int year; int month; int day; } Date; /** Print out the command-line usage of this application **/ void usage(int leave) { char *pspaces; char *pname = PROG_NAME; pspaces = (char *) malloc(strlen(pname)); strncpy(pspaces, " ", strlen(pname)); fprintf(stderr, "%s [--gregorian yyyymmdd] [--hijri yyyymmdd]\n", pname); fprintf(stderr, "%s [--simple]\n", pspaces); fprintf(stderr, "%s [--umm_alqura]\n", pspaces); fprintf(stderr, "%s [--help]\n", pspaces); free(pspaces); if (leave) exit(20); } /** Error printing (& possibly exit) apparatus. **/ void error(int leave, char* err_msg) { char *prog_name = PROG_NAME; fprintf(stderr, "[%s]: %s", prog_name, err_msg); if (leave) exit(leave); } /** Initizlize various variables/structures **/ void do_init(Date *mydate, sDate *pdate) { mydate->year = (int) NULL; mydate->month = (int) NULL; mydate->day = (int) NULL; pdate->day = (int) NULL; pdate->month = (int) NULL; pdate->year = (int) NULL; pdate->weekday = (int) NULL; pdate->frm_numdays = (int) NULL; pdate->to_numdays = (int) NULL; pdate->to_numdays2 = (int) NULL; // pdate->units = (char *) NULL; pdate->units = "A.H"; pdate->frm_dname = (char *) NULL; pdate->frm_mname = (char *) NULL; pdate->frm_dname_sh = (char *) NULL; pdate->frm_mname_sh = (char *) NULL; pdate->to_dname = (char *) NULL; pdate->to_mname = (char *) NULL; pdate->to_dname_sh = (char *) NULL; pdate->to_mname_sh = (char *) NULL; pdate->event = (char **) NULL; } /** Printout the results **/ void display_output(int simple_mode, int using_umm_alqura, Date *indate, sDate *rdate) { int i; /* See if we're only to print out a simple output */ if (simple_mode) { printf("%2d/%2d/%4d %s", rdate->day, rdate->month, rdate->year, rdate->units); printf(" - %s(%s) - %s(%s)\n", rdate->to_dname, rdate->to_dname_sh, rdate->to_mname, rdate->to_mname_sh); } else { printf("Date Format (dd/mm/yyyy)"); if (using_umm_alqura) printf(" [using Umm-AlQura Algorithm]:\n"); else printf(":\n"); printf("+ Input : %2d/%2d/%4d ", indate->day, indate->month, indate->year); printf(" - %10s(%s) - %12s(%s)\n", rdate->frm_dname, rdate->frm_dname_sh, rdate->frm_mname, rdate->frm_mname_sh); printf("-----------------------------\n"); printf("+ Output : %2d/%2d/%4d %s", rdate->day, rdate->month, rdate->year, rdate->units); printf(" - %10s(%s) - %12s(%s)\n", rdate->to_dname, rdate->to_dname_sh, rdate->to_mname, rdate->to_mname_sh); } /* Print out any event(s) on the specified date */ if (rdate->event[0]) printf("\n"); for (i = 0; rdate->event[i] != NULL; i++) { printf("(*) Event on this Day : %s\n", rdate->event[i]); } /* Do some house cleaning - just in case */ free(rdate->event); } /** Main procedure **/ int main(int argc, char *argv[]) { int i; int g_to_h = 0; int h_to_g = 0; int simple_mode = 0; int use_umm_alqura = 0; int error_lib = 0; Date indate; sDate outdate; /* Current time/date specifics */ time_t mytime; struct tm *t_ptr; do_init(&indate, &outdate); /* Process the command-line */ for (i = 1; i < argc; i++) { if (strcasecmp(argv[i], "-h") == 0 || strcasecmp(argv[i], "-help") == 0 || strcasecmp(argv[i], "--help") == 0) { /* We really need a full-fledged help here */ usage(1); } if (strcasecmp(argv[i], "-g") == 0 || strcasecmp(argv[i], "-gregorian") == 0 || strcasecmp(argv[i], "--gregorian") == 0) { g_to_h = 1; if (argv[i+1] != NULL) { sscanf(&(argv[i + 1][0]), "%4d", &indate.year); sscanf(&(argv[i + 1][4]), "%2d", &indate.month); sscanf(&(argv[i + 1][6]), "%2d", &indate.day); } else { error(1, "Exiting, invalid argument to --gregorian\n"); } } if (strcasecmp(argv[i], "-hi") == 0 || strcasecmp(argv[i], "-hijri") == 0 || strcasecmp(argv[i], "--hijri") == 0) { h_to_g = 1; if (argv[i+1] != NULL) { sscanf(&(argv[i + 1][0]), "%4d", &indate.year); sscanf(&(argv[i + 1][4]), "%2d", &indate.month); sscanf(&(argv[i + 1][6]), "%2d", &indate.day); } else { error(1, "Exiting, invalid argument to --hijri\n"); } } if (strcasecmp(argv[i], "-s") == 0 || strcasecmp(argv[i], "-simple") == 0 || strcasecmp(argv[i], "--simple") == 0) { simple_mode = 1; } if (strcasecmp(argv[i], "-u") == 0 || strcasecmp(argv[i], "-umm_alqura") == 0 || strcasecmp(argv[i], "--umm_alqura") == 0) { use_umm_alqura = 1; } } /* Make sure user knows what they are doing */ if (g_to_h && h_to_g) error(2, "Exiting, can't define both Gregorian and Hijri\n"); /* Go with default current date if not user specifications */ if (!g_to_h && !h_to_g) { g_to_h = 1; /* Get current time structure */ time(&mytime); t_ptr = localtime(&mytime); /* Set current time values */ indate.day = t_ptr->tm_mday; indate.month = t_ptr->tm_mon + 1; indate.year = t_ptr->tm_year + 1900; } /* Inspect user's input or default settings - within range ? */ if ((indate.month > 12) || (indate.month < 1)) error(3, "Exiting, input 'month' not within allowable range\n"); if ((indate.day > 31) || (indate.day < 1)) error(3, "Exiting, input 'day' not within allowable range\n"); /* Do the actual conversions */ if (g_to_h) { /* Dealing with Gregorian to Hijri conversion */ if (use_umm_alqura) G2H(&outdate, indate.day, indate.month, indate.year); else error_lib = h_date(&outdate, indate.day, indate.month, indate.year); } else { /* Dealing with Hijri to Gregorian conversion */ if (use_umm_alqura) H2G(&outdate, indate.day, indate.month, indate.year); else error_lib = g_date(&outdate, indate.day, indate.month, indate.year); } /* Let user know if the library freaked-out and returned with an error */ if (error_lib) { char msg[80]; sprintf(msg, "Exiting, error code %d generated by library call\n", error_lib); error(error_lib, msg); } /* Spill-out the results */ display_output(simple_mode, use_umm_alqura, &indate, &outdate); return(0); } itools-1.1/ipraytime.c000066400000000000000000001033771443627167400150640ustar00rootroot00000000000000/************************************************************************ * $Id: ipraytime.c 11580 2010-05-06 14:04:07Z thamer $ * * ------------ * Description: * ------------ * Copyright (c) 2004-2005 Arabeyes, Nadim Shaikli * Copyright (c) 2005-2010 Thamer Mahmoud * * An Islamic Prayer time calculator that uses libitl. * * ----------------- * Revision Details: (Updated by Revision Control System) * ----------------- * $Date: 2010-05-06 16:04:07 +0200 (Thu, 06 May 2010) $ * $Author: thamer $ * $Revision: 11580 $ * $Source$ * * (www.arabeyes.org - under GPL license) ************************************************************************/ /* Figure out what time of tm structure we're dealing with */ #include "config.h" #include #include #include /* for outputting degree symbol */ #include /* for outputting degree symbol */ #include /* for strlen/strcat/etc */ #include /* for getuid */ #include /* for getpwuid */ /* For time_t */ #ifdef TM_IN_SYS_TIME #include #else #include #endif #include #include #define PROG_NAME "ipraytime" #define PROG_RCFILE "iprayrc" typedef struct { char *city; /* City name */ double lat; /* Latitude in decimal degree */ double lon; /* Longitude in decimal degree */ double utc; /* UTC difference */ double sealevel; /* Height above Sea level (in meters) */ double pressure; /* Atmospheric pressure in millibars */ double temperature; /* Temperature in Celsius degree */ int dst; /* Daylight savings time switch */ int angle_method; /* Angle settings/method of calculation */ double fajrangle; /* Fajr angle */ double ishaaangle; /* Ishaa angle */ double imsaakangle; /* Imsaak and Fajr angle difference */ double nearestLat; /* Nearest latitude */ int fajrinv; /* Fajr Interval 90 or 120 (0:not used) */ int ishaainv; /* Ishaa Interval 90 or 120 (0:not used) */ int imsaakinv; /* If set, Imsaak Interval from Fajr is 10min */ int mathhab; /* 1:Shaf'i, 2:Hanafi */ int round; /* rounding method */ int extreme; /* Extreme latitude calcs engaged */ int hformat; /* 24, 12 */ char dst_start[8]; /* Start date of DST period in yyyymmdd */ char dst_end[8]; /* Ending date of DST period yyyymmdd */ double offset_list[6]; /* add or subtract minutes */ } sPref; /** Print out the command-line usage of this application **/ void usage(int leave) { char *pspaces; char *pname = PROG_NAME; pspaces = malloc(strlen(pname)); strncpy(pspaces, " ", strlen(pname)); fprintf(stderr, "%s [--date yyyymmdd] [--latitude real_num]\n", pname); fprintf(stderr, "%s [--longitude real_num]\n", pspaces); fprintf(stderr, "%s [--utcdiff real_num]\n", pspaces); fprintf(stderr, "%s [--method [int_num]]\n", pspaces); fprintf(stderr, "%s [--month [int_num]]\n", pspaces); fprintf(stderr, "%s [--year [int_num]]\n", pspaces); fprintf(stderr, "%s [--file pref_file]\n", pspaces); fprintf(stderr, "%s [--regular-hour]\n", pspaces); fprintf(stderr, "%s [--fajrangle]\n", pspaces); fprintf(stderr, "%s [--ishaangle]\n", pspaces); fprintf(stderr, "%s [--dst [int_num]]\n", pspaces); fprintf(stderr, "%s [--dst-start yyyymmdd]\n", pspaces); fprintf(stderr, "%s [--dst-end yyyymmdd]\n", pspaces); fprintf(stderr, "%s [--round [int_num]]\n", pspaces); fprintf(stderr, "%s [--extreme [int_num]]\n", pspaces); fprintf(stderr, "%s [--sea-level real_num]\n", pspaces); fprintf(stderr, "%s [--end]\n", pspaces); fprintf(stderr, "%s [--brief]\n", pspaces); fprintf(stderr, "%s [--help]\n", pspaces); free(pspaces); if (leave) exit(10); } /** Error printing (& possibly exit) apparatus. **/ void error(int leave, char* err_msg) { char *prog_name = PROG_NAME; fprintf(stderr, "[%s]: %s", prog_name, err_msg); if (leave) exit(5); } /** Read-in passed-in file to populate passed-in structure. **/ int process_file(sPref *pref_data, char *filename) { FILE *fp; char ins[50], inp1[50], inp2[50]; double num; fp = fopen(filename, "r"); if (fp == NULL) return(1); while (fgets(ins, sizeof(ins), fp)) { sscanf(ins, "%s %[^\n]", inp1, inp2); if (strcasecmp(inp1, "City:") == 0) { pref_data->city = malloc(strlen(inp2)+1); strcpy(pref_data->city, inp2); } if (strcasecmp(inp1, "Latitude:") == 0) { num = atof(inp2); pref_data->lat = num; } if (strcasecmp(inp1, "Longitude:") == 0) { num = atof(inp2); pref_data->lon = num; } if (strcasecmp(inp1, "UTC:") == 0) { num = atof(inp2); pref_data->utc = num; } if (strcasecmp(inp1, "AngleMethod:") == 0) { num = atoi(inp2); pref_data->angle_method = num; } if (strcasecmp(inp1, "Pressure:") == 0) { num = atof(inp2); pref_data->pressure = num; } if (strcasecmp(inp1, "Temperature:") == 0) { num = atof(inp2); pref_data->temperature = num; } if (strcasecmp(inp1, "SeaLevel:") == 0) { num = atof(inp2); pref_data->sealevel = num; } if (strcasecmp(inp1, "DST:") == 0) { num = atoi(inp2); pref_data->dst = num; } if (strcasecmp(inp1, "FajrAngle:") == 0) { num = atof(inp2); pref_data->fajrangle = num; } if ((strcasecmp(inp1, "IshaaAngle:") == 0) || (strcasecmp(inp1, "IshaAngle:") == 0)) { num = atof(inp2); pref_data->ishaaangle = num; } if (strcasecmp(inp1, "ImsaakAngle:") == 0) { num = atof(inp2); pref_data->imsaakangle = num; } if (strcasecmp(inp1, "FajrInterval:") == 0) { num = atoi(inp2); pref_data->fajrinv = num; } if ((strcasecmp(inp1, "IshaaInterval:") == 0) || (strcasecmp(inp1, "IshaInterval:") == 0)) { num = atoi(inp2); pref_data->ishaainv = num; } if (strcasecmp(inp1, "ImsaakInterval:") == 0) { num = atoi(inp2); pref_data->imsaakinv = num; } if (strcasecmp(inp1, "Mathhab:") == 0) { num = atoi(inp2); pref_data->mathhab = num; } if (strcasecmp(inp1, "ExtremeMethod:") == 0) { num = atoi(inp2); pref_data->extreme = num; } if (strcasecmp(inp1, "RoundMethod:") == 0) { num = atoi(inp2); pref_data->round = num; } if (strcasecmp(inp1, "HourFormat:") == 0) { num = atoi(inp2); pref_data->hformat = num; } if (strcasecmp(inp1, "DST-Start:") == 0) strcpy(pref_data->dst_start, inp2); if (strcasecmp(inp1, "DST-End:") == 0) strcpy(pref_data->dst_end, inp2); if (strcasecmp(inp1, "NearestLatitude:") == 0) { num = atof(inp2); pref_data->nearestLat = num; } if (strcasecmp(inp1, "OffsetList:") == 0) { int num = sscanf(inp2, "%lf %lf %lf %lf %lf %lf", &pref_data->offset_list[0], &pref_data->offset_list[1], &pref_data->offset_list[2], &pref_data->offset_list[3], &pref_data->offset_list[4], &pref_data->offset_list[5]); if (num != 6) error(1, "Wrong number of offsets. Exiting\n"); } } fclose(fp); return(0); } char *get_filename(const char *directory, const char *name) { char *path; size_t dirlen; dirlen = strlen(directory); path = malloc((dirlen + strlen(name) + 2) * sizeof(char)); strcpy(path, directory); if (dirlen == 0 || path[dirlen - 1] != '/') { path[dirlen++] = '/'; } strcpy(path + dirlen, name); return path; } char *get_homedir(void) { char *home = NULL; home = getenv("HOME"); if (!home || !*home) { /* Easy didn't cut it, break-out the big guns */ uid_t uid; struct passwd *p; /* Get user's real user ID */ uid = getuid (); /* Get password entry */ p = getpwuid (uid); if (!p || !p->pw_name || !*p->pw_name) { error(1, "%s: Couldn't get user info of uid \n"); } else if (!p->pw_dir || !*p->pw_dir) { error(1, "Exiting, Couldn't get home directory of user\n"); } else { home = p->pw_dir; } } home = strdup(home); return(home); } char *expand_tilde(const char *filename) { char *new_filename; size_t homedirlen; if (filename[0] == '~') { new_filename = get_homedir(); homedirlen = strlen(new_filename); new_filename = realloc(new_filename, (homedirlen + strlen(filename)) * sizeof(char)); strcpy(new_filename + homedirlen, filename + 1); return new_filename; } else { return strdup(filename); } } /** Get user's home-dir and RC-file with complete path **/ char * get_rcfilename() { char *rcname = NULL; char *home = NULL; char *filepath = NULL; /* Let's see if getting user's homedir will be easy */ rcname = malloc((strlen(PROG_RCFILE)+2)*sizeof(char)); rcname[0] = '.'; strcat(rcname+1, PROG_RCFILE); home = get_homedir(); /* Allocate memory to be safe not to trample on anything */ filepath = (char *) malloc(strlen(home) + strlen(rcname) + 2); /* Make a safe copy */ strcpy(filepath, home); /* Add-on the slash on the end if need be */ if (!*home || home[strlen(home)-1] != '/') strcat(filepath, "/"); strcat(filepath, rcname); struct stat buf; char *xdg_home; char *newpath; //does not exist, thus check XDG_CONFIG_HOME/PACKAGE_NAME/config if (stat(filepath, &buf) != 0) { xdg_home = getenv("XDG_CONFIG_HOME"); if (xdg_home) { xdg_home = strdup(xdg_home); } else { xdg_home = expand_tilde("~/.config"); } newpath = get_filename(xdg_home, PACKAGE_NAME); free(xdg_home); xdg_home = get_filename(newpath, PROG_RCFILE); free(newpath); newpath = xdg_home; //If this does not exist fallback if (stat(newpath, &buf) == 0) { free(filepath); filepath = newpath; } else { free(newpath); } } return(filepath); } /** Initialize various variables, read-in the RC file **/ void do_init_file(sPref *pref_data, Location *loc, Date *date) { char *filename = NULL; filename = get_rcfilename(); process_file(pref_data, filename); free(filename); } void do_getenv(sPref *user_pref) { char *ipt_data = NULL; char ipt_city[50]; char *city_name; double ipt_lat; double ipt_lon; double ipt_utc; int ipt_angle_method; ipt_data = getenv("IPT_DATA"); if (!ipt_data || !*ipt_data) { return; } /* Get variable in the format of "CityName Latitude Longitude UTCdiff AngleMethod" an example of which can be "Abu Dhabi 24.4833 54.35 4 2" */ sscanf(ipt_data, "%49[^0123456789.-] %lf %lf %lf %d", ipt_city, &ipt_lat, &ipt_lon, &ipt_utc, &ipt_angle_method); city_name = malloc(strlen(ipt_city)+1); strcpy(city_name, ipt_city); /* Free city string specified in rc file */ if (user_pref->city) free(user_pref->city); user_pref->city = city_name; user_pref->lat = ipt_lat; user_pref->lon = ipt_lon; user_pref->utc = ipt_utc; user_pref->angle_method = ipt_angle_method; } /** Read-in the a user supplied input file **/ void do_input_file(sPref *pref_data, char *filename) { if (filename != NULL) { /* If a user supplied a filename */ if (process_file(pref_data, filename)) error(1, "Exiting, Unable to process file specified with --file \n"); } else error(1, "Exiting, invalid argument to --file \n"); } void print_input_data(char *city_name, Location *loc, const char *method_name) { int deg, min; double sec; double qibla; const wchar_t *symb = L"\x00B0"; if (!setlocale(LC_CTYPE, "")) fprintf(stderr, "Can't change Locale! Degree symbol won't work"); printf("\n"); printf("Prayer schedule for,\n"); /* Print Cityname if there is something to print */ if (city_name != (char*) NULL) printf(" City : %s\n", city_name); decimal2Dms(loc->degreeLat, °, &min, &sec); printf(" Latitude : %03d%ls %02d\' %02d\" %c\n", abs(deg), symb, abs(min), abs(sec), (loc->degreeLat >=0 ? 'N' : 'S')); decimal2Dms(loc->degreeLong, °, &min, &sec); printf(" Longitude : %03d%ls %02d\' %02d\" %c\n", abs(deg), symb, abs(min), abs(sec), (loc->degreeLong >=0 ? 'E' : 'W')); printf(" Angle Method : %s\n", method_name); printf(" TimeZone : UTC%s%.1f\n", (loc->gmtDiff >= 0 ? "+" : ""), loc->gmtDiff); /* Deal with Qibla Information */ qibla = getNorthQibla(loc); decimal2Dms (qibla, °, &min, &sec); printf(" Qibla : %03d%ls %02d\' %02d\" %c of true North\n", abs (deg), symb, abs (min), abs (sec), (qibla >=0 ? 'W' : 'E')); printf("\n"); } void print_banner() { /* Print a nice header so its all lined-up */ printf(" Date Fajr Shorooq"); printf(" Zuhr Asr Maghrib Isha \n"); printf("----------------------------------"); printf("----------------------------------\n"); } void print_prayer_times(Location *loc, Method *conf, Date *date, Prayer* ptList, int print_brief, int hformat) { int i; /* Call the main function to fill the ptList array of Prayer struct */ getPrayerTimes(loc, conf, date, ptList); /* Show the results */ printf(" [%02d-%02d-%04d]", date->day, date->month, date->year); #ifdef DEBUG for(i=0; i<6; i++) printf(" %2d:%02d:%02d%c", ptList[i].hour, ptList[i].minute, ptList[i].second, (ptList[i].isExtreme) ? '*' : ' '); #else for(i=0; i<6; i++) printf(" %3d:%02d", (hformat == 12 && ptList[i].hour > 12) ? ptList[i].hour - 12 : ptList[i].hour, ptList[i].minute); #endif if (!print_brief) printf("\n"); } int date_in_range(Date* s, Date* e, Date* cur) { if (cur->month > s->month && cur->month < e->month) return 1; else if (cur->month == s->month && s->month != e->month) { if (cur->day >= s->day) return 1; } else if (cur->month == e->month && s->month != e->month) { if (cur->day <= e->day) return 1; } else if (cur->month == e->month && cur->month == s->month) { /* Range in the same month! */ if (cur->day <= e->day && cur->day >= s->day) return 1; } return 0; } int timezone_dst(Date* date) { time_t dsttime; struct tm tms = {0}; tms.tm_mday = date->day; tms.tm_mon = date->month - 1; tms.tm_year = date->year - 1900; tms.tm_isdst = -1; dsttime = mktime(&tms); tms = *localtime(&dsttime); return tms.tm_isdst ? tms.tm_isdst : 0; } void set_default_values(sPref *pref, Location *loc, Date *date) { pref->city = (char *) NULL; pref->lat = -1000; pref->lon = -1000; pref->utc = -99; pref->pressure = -9999999; pref->temperature = -9999999; pref->sealevel = -1000; pref->dst = -99; pref->angle_method = -99; pref->fajrangle = -99; pref->ishaaangle = -99; pref->imsaakangle = -99; pref->fajrinv = -99; pref->ishaainv = -99; pref->imsaakinv = -99; pref->mathhab = -99; pref->extreme = -99; pref->round = -99; pref->hformat = -99; pref->nearestLat = -99; pref->offset_list[0] = 0; pref->offset_list[1] = 0; pref->offset_list[2] = 0; pref->offset_list[3] = 0; pref->offset_list[4] = 0; pref->offset_list[5] = 0; loc->degreeLat = -1000; loc->degreeLong = -1000; loc->gmtDiff = -99; loc->dst = -99; date->year = (int) NULL; date->month = (int) NULL; date->day = (int) NULL; } /** Main procedure **/ int main(int argc, char *argv[]) { const int cal_dname[13] = { 0, 31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31 }; const char *cal_mname[13] = { "skip", "January", "February", "March", "April", "May", "June", "July", "August", "September", "October", "November", "December" }; const char *method_name[12] = { "NONE", "Egyptian General Authority of Survey", "University of Islamic Sciences, Karachi (Shaf'i)", "University of Islamic Sciences, Karachi (Hanafi)", "Islamic Society of North America", "Muslim World League (MWL)", "Umm Al-Qurra University", "Fixed Isha Angle Interval (always 90)", "Egyptian General Authority of Survey (Egypt)", "Umm Al-Qurra Ramadan, Saudi Arabia", "Moonsighting Committee Worldwide", "Morocco Awqaf, Morocco"}; int i; int cal_num; int is_user_lat = 0; int is_user_lon = 0; int is_user_cmdline = 0; int is_user_defined = 0; int is_dst_range = 0; int do_month = 0; int do_rest_month = 0; int do_year = 0; int do_brief = 0; int utc_timezone = 0; char city_name[50] = ""; time_t mytime; struct tm *t_ptr; /* Custom structures instantiation */ Prayer ptList[6]; Prayer nextImsaak; Prayer nextFajr; Prayer Imsaak; Location loc; Method conf; Date date ; Date dst_start; Date dst_end; sPref user_input; /* Initialize some struct members */ set_default_values(&user_input, &loc, &date); /* Read-in the init RC file */ do_init_file(&user_input, &loc, &date); do_getenv(&user_input); /* Process command-line looking for -file argument */ for (i = 1; i < argc; i++) { if (strcasecmp(argv[i], "-f") == 0 || strcasecmp(argv[i], "-file") == 0 || strcasecmp(argv[i], "--file") == 0) { /* Ignore values provided by rc file and env if a --file is specified. */ if (user_input.city != (char *) NULL) free(user_input.city); set_default_values(&user_input, &loc, &date); do_input_file(&user_input, argv[i+1]); } } /* Process the rest of the command-line */ for (i = 1; i < argc; i++) { if (strcasecmp(argv[i], "-h") == 0 || strcasecmp(argv[i], "-help") == 0 || strcasecmp(argv[i], "--help") == 0) { /* We really need a full-fledged help here */ usage(1); } if (strcasecmp(argv[i], "-d") == 0 || strcasecmp(argv[i], "--date") == 0) { if (argv[i+1] != NULL) { sscanf(&(argv[i + 1][0]), "%4d", &date.year); sscanf(&(argv[i + 1][4]), "%2d", &date.month); sscanf(&(argv[i + 1][6]), "%2d", &date.day); } else { error(1, "Exiting, invalid argument to --date \n"); } } if (strcasecmp(argv[i], "-lat") == 0 || strcasecmp(argv[i], "--latitude") == 0) { is_user_lat = 1; if (argv[i+1] != NULL) { sscanf(&(argv[i + 1][0]), "%lf", &user_input.lat); } else { error(1, "Exiting, invalid argument to --latitude \n"); } } if (strcasecmp(argv[i], "-lon") == 0 || strcasecmp(argv[i], "--longitude") == 0) { is_user_lon = 1; if (argv[i+1] != NULL) { sscanf(&(argv[i + 1][0]), "%lf", &user_input.lon); } else { error(1, "[%s]: Invalid argument to --longitude \n"); } } if (strcasecmp(argv[i], "-u") == 0 || strcasecmp(argv[i], "--utcdiff") == 0) { if (argv[i+1] != NULL) { sscanf(&(argv[i + 1][0]), "%lf", &user_input.utc); } else { error(1, "Exiting, invalid argument to --utcdiff \n"); } } if (strcasecmp(argv[i], "-a") == 0 || strcasecmp(argv[i], "--anglemethod") == 0) { if (argv[i+1] != NULL) { sscanf(&(argv[i + 1][0]), "%d", &user_input.angle_method); } else { error(1, "Exiting, invalid argument to --method \n"); } } if (strcasecmp(argv[i], "-fa") == 0 || strcasecmp(argv[i], "--fajrangle") == 0) { if (argv[i+1] != NULL) { sscanf(&(argv[i + 1][0]), "%lf", &user_input.fajrangle); } else { error(1, "Exiting, invalid argument to --fajrangle \n"); } } if (strcasecmp(argv[i], "-ia") == 0 || strcasecmp(argv[i], "--ishaangle") == 0) { if (argv[i+1] != NULL) { sscanf(&(argv[i + 1][0]), "%lf", &user_input.ishaaangle); } else { error(1, "Exiting, invalid argument to --ishaangle \n"); } } if (strcasecmp(argv[i], "-x") == 0 || strcasecmp(argv[i], "--extreme") == 0) { if (argv[i+1] != NULL) { sscanf(&(argv[i + 1][0]), "%d", &user_input.extreme); } else { error(1, "Exiting, invalid argument to --extreme \n"); } } if (strcasecmp(argv[i], "-r") == 0 || strcasecmp(argv[i], "--round") == 0) { if (argv[i+1] != NULL) { sscanf(&(argv[i + 1][0]), "%d", &user_input.round); } else { error(1, "Exiting, invalid argument to --round \n"); } } if (strcasecmp(argv[i], "-sea") == 0 || strcasecmp(argv[i], "--sea-level") == 0) { if (argv[i+1] != NULL) { sscanf(&(argv[i + 1][0]), "%lf", &user_input.sealevel); } else { error(1, "Exiting, invalid argument to --sea \n"); } } if (strcasecmp(argv[i], "-s") == 0 || strcasecmp(argv[i], "--dst") == 0) { if (argv[i+1] != NULL) { sscanf(&(argv[i + 1][0]), "%d", &user_input.dst); } else { error(1, "Exiting, invalid argument to --dst \n"); } } if (strcasecmp(argv[i], "-ss") == 0 || strcasecmp(argv[i], "--dst-start") == 0) { if (argv[i+1] != NULL) { is_dst_range = 1; sscanf(&(argv[i + 1][0]), "%4d", &dst_start.year); sscanf(&(argv[i + 1][4]), "%2d", &dst_start.month); sscanf(&(argv[i + 1][6]), "%2d", &dst_start.day); } else { error(1, "Exiting, invalid argument to --dst-start \n"); } } if (strcasecmp(argv[i], "-se") == 0 || strcasecmp(argv[i], "--dst-end") == 0) { if (argv[i+1] != NULL) { is_dst_range = 1; sscanf(&(argv[i + 1][0]), "%4d", &dst_end.year); sscanf(&(argv[i + 1][4]), "%2d", &dst_end.month); sscanf(&(argv[i + 1][6]), "%2d", &dst_end.day); } else { error(1, "Exiting, invalid argument to --dst-end \n"); } } if (strcasecmp(argv[i], "-h12") == 0 || strcasecmp(argv[i], "--regular-hour") == 0) { user_input.hformat = 12; } /* Do entire month, current or specified */ if (strcasecmp(argv[i], "-m") == 0 || strcasecmp(argv[i], "--month") == 0) { do_month = 1; if (argv[i+1] != NULL) { sscanf(&(argv[i + 1][0]), "%d", &date.month); } } /* Do entire year, current or specified */ if (strcasecmp(argv[i], "-y") == 0 || strcasecmp(argv[i], "--year") == 0) { do_year = 1; if (argv[i+1] != NULL) { sscanf(&(argv[i + 1][0]), "%d", &date.year); } } /* Do till end of current month */ if (strcasecmp(argv[i], "-e") == 0 || strcasecmp(argv[i], "--end") == 0) { do_rest_month = 1; } /* Do a brief print-out for single mode */ if (strcasecmp(argv[i], "-b") == 0 || strcasecmp(argv[i], "--brief") == 0) { do_brief = 1; } } /* Note if we had user defined location */ is_user_cmdline = (is_user_lat || is_user_lon); is_user_defined = (is_user_cmdline || (user_input.lat != -1000) || (user_input.lon != -1000) ); /* - USER SPECIFIED SETTINGS - */ /* Fill the city name */ if (user_input.city && !is_user_cmdline) { sprintf(city_name, "%s", user_input.city); free(user_input.city); } else { if (is_user_defined) sprintf(city_name, "Custom"); else sprintf(city_name, "Makkah"); } /* Fill the Date structure - just in case */ time(&mytime); t_ptr = localtime(&mytime); #ifdef HAVE_TM_GMTOFF utc_timezone = (t_ptr->tm_gmtoff / 3600); #else /* Solaris doesn't seem to have this member, improvise */ utc_timezone = (timezone / -3600); #endif /* see if the date structure has been set to a value, else use today's */ if (date.day == (int) NULL) date.day = t_ptr->tm_mday; if (date.month == (int) NULL) date.month = t_ptr->tm_mon + 1; if (date.year == (int) NULL) date.year = t_ptr->tm_year + 1900; /* Fill the location info. structure */ /* If there are no command-line options, grab whatever user specified, else go default. */ if (user_input.lat != -1000) loc.degreeLat = user_input.lat; else loc.degreeLat = 21.4206; if (user_input.lon != -1000) loc.degreeLong = user_input.lon; else loc.degreeLong = 39.8304; /* If there are no command-line timezone option, grab whatever user specified, else see if latitude/longitude were set and grab machine's timezone, else go default. */ if (user_input.utc != -99) loc.gmtDiff = user_input.utc; else loc.gmtDiff = (is_user_defined ? utc_timezone : 3); if (user_input.hformat == -99) user_input.hformat = 24; if (user_input.dst != -99) loc.dst = user_input.dst; else user_input.dst = 2; if (!is_dst_range) { if (sscanf(user_input.dst_start, "%4d%2d%2d", &dst_start.year, &dst_start.month, &dst_start.day) == 3) { is_dst_range = 1; } if (sscanf(user_input.dst_end, "%4d%2d%2d", &dst_end.year, &dst_end.month, &dst_end.day) == 3) { is_dst_range = 1; } } if (user_input.sealevel != -1000) loc.seaLevel = user_input.sealevel; else loc.seaLevel = 0; if (user_input.pressure != -9999999) loc.pressure = user_input.pressure; else loc.pressure = 1010; if (user_input.temperature != -9999999) loc.temperature = user_input.temperature; else loc.temperature = 10; /* Enact some pre-defined calculation methods/settings */ if (user_input.angle_method != -99 && (user_input.angle_method >= 0 && user_input.angle_method <= sizeof(method_name)/sizeof(char*)-1)) { getMethod(user_input.angle_method, &conf); } else { /* Set default, used later */ user_input.angle_method = 6; getMethod(6, &conf); } /* Fill the Calculation method structure (user defined values) */ if (user_input.fajrangle != -99) conf.fajrAng = user_input.fajrangle; if (user_input.ishaaangle != -99) conf.ishaaAng = user_input.ishaaangle; if (user_input.imsaakangle != -99) conf.imsaakAng = user_input.imsaakangle; if (user_input.fajrinv != -99) conf.fajrInv = user_input.fajrinv; if (user_input.ishaainv != -99) conf.ishaaInv = user_input.ishaainv; if (user_input.imsaakinv != -99) conf.imsaakInv = user_input.imsaakinv; if (user_input.mathhab != -99) conf.mathhab = user_input.mathhab; if (user_input.extreme != -99) conf.extreme = user_input.extreme; if (user_input.round != -99) conf.round = user_input.round; if (user_input.nearestLat != -99) conf.nearestLat = user_input.nearestLat; if (user_input.offset_list[0] != 0) conf.offList[0]= user_input.offset_list[0]; if (user_input.offset_list[1] != 0) conf.offList[1]= user_input.offset_list[1]; if (user_input.offset_list[2] != 0) conf.offList[2]= user_input.offset_list[2]; if (user_input.offset_list[3] != 0) conf.offList[3]= user_input.offset_list[3]; if (user_input.offset_list[4] != 0) conf.offList[4]= user_input.offset_list[4]; if (user_input.offset_list[5] != 0) conf.offList[5]= user_input.offset_list[5]; conf.offset=1; /* Determine today's DST status and set the DST library flag * (loc.dst) */ if (user_input.dst == 2) { if (is_dst_range) loc.dst = date_in_range(&dst_start, &dst_end, &date); else loc.dst = timezone_dst(&date); } /* Echo back data used */ if (!do_brief) print_input_data(city_name, &loc, method_name[user_input.angle_method]); /* Determine number of days in month */ if (do_rest_month || do_month || do_year) { int start_day; /* See which day/month to start on */ start_day = (do_year || do_month ? 1 : date.day); date.month = (do_year && !do_month ? 1 : date.month); do { if (do_year && !do_month) { char *dashes; int len; /* Set length of box per month name + year + spaces.*/ len = strlen(cal_mname[date.month])+8; /* Make room for appending? Changed to fix glibc crashes */ dashes = malloc(len+2); strncpy(dashes, "+---------------------------", len); /* strncpy doesn't add the null-terminator, add it by hand */ dashes[len] = '\0'; strcat(dashes, "+"); /* print-out the box */ printf(" %s\n", dashes); printf(" | %s %04d |\n", cal_mname[date.month], date.year); printf(" %s\n\n", dashes); free(dashes); } /* Print head banner */ print_banner(); /* Get number of days in current month */ cal_num = cal_dname[date.month]; /* Leap year determination. - Rule 1: If the year is divisible by 400, it IS a leap year. - Rule 2: If the year is divisible by 100, it IS NOT a leap year. - Rule 3: If the year is divisible by 4, it IS a leap year. */ if (date.month == 2) { /* Good ole February - ain't you special :-) */ cal_num += ( ((date.year % 4 == 0) && (date.year % 100)) || (date.year % 400 == 0) ); } /* Do da-month Loop :-) */ for (date.day = start_day; (date.day <= cal_num); date.day++) { /* Get dst status of today */ if (user_input.dst == 2) { if (is_dst_range) loc.dst = date_in_range(&dst_start, &dst_end, &date); else loc.dst = timezone_dst(&date); } print_prayer_times(&loc, &conf, &date, ptList, 0, user_input.hformat); } if (do_year) printf("\n"); } while (do_year && !do_month && date.month++ <= 11); } else { /* Print head banner */ print_banner(); /* Doing a single day */ print_prayer_times(&loc, &conf, &date, ptList, do_brief, user_input.hformat); if (!do_brief) { getNextDayImsaak(&loc, &conf, &date, &nextImsaak); getNextDayFajr(&loc, &conf, &date, &nextFajr); getImsaak(&loc, &conf, &date, &Imsaak); printf("\n"); printf("Today's Imsaak : %3d:%02d\n", Imsaak.hour, Imsaak.minute); printf("Tomorrow's Imsaak : %3d:%02d\n", nextImsaak.hour, nextImsaak.minute); printf("Tomorrow's Fajr : %3d:%02d\n", nextFajr.hour, nextFajr.minute); } } printf("\n"); return(0); } itools-1.1/ireminder000077500000000000000000000332141443627167400146110ustar00rootroot00000000000000#!/usr/bin/perl # -*-Perl-*- #--- # $Id: ireminder 10752 2006-10-11 20:52:09Z nadim $ # # ------------ # Description: # ------------ # Copyright (c) 2006, Arabeyes, Nadim Shaikli # # This is a prayer (and other Islamic events) reminder program. # Its a wrapper that uses Arabeyes.org's ITL package (ipraytime # to be specific) to attain all its values. The script is meant # to be light, simple and flexible. # # Based on a concept/idea from # - Ahmed El-Mahmoudy (aelmahmoudy -at- users sf net) # # ----------------- # Revision Details: (Updated by Revision Control System) # ----------------- # $Date: 2006-10-11 22:52:09 +0200 (Wed, 11 Oct 2006) $ # $Author: nadim $ # $Revision: 10752 $ # $Source$ # # (www.arabeyes.org - under GPL license) #--- # TODO: # - have it fork in the background if a similar process doesn't already # exists else kill the other process post a confirm (optionally) # - have it print to the console not stdout (optionally) # SAMPLES: # - to engage a GUI: # ireminder -execr "xmessage %m -nearmouse -timeout 30" # ireminder -execr "xmessage %m" -execs "xmessage %m" # ireminder -execr "xmessage Next salat is %s" use Getopt::Long; use POSIX; use FileHandle; STDOUT->autoflush(1); ## # Specify global variable values and init some Variables $in_script = $0; $in_script =~ s|^.*/([^/]*)|$1|; ## # Find how many spaces the scripts name takes up (nicety) $in_spaces = $in_script; $in_spaces =~ s/\S/ /g; $version = " (v - %I%)"; $ID = "[$in_script]"; # Process the command line &get_args(); # Make it simple, does user need help ? if ($opt{help}) { &help(); } # Account for the various ways a user might enter a list %opt = %{&listify_input(\%opt, "skip")}; %opt = %{&listify_input(\%opt, "reminder")}; # Account for various places the ipraytime binary could reside-in @bin_paths = ("/usr/bin/", "/usr/local/bin/", ""); foreach my $entry (@bin_paths) { $bin_path = "${entry}ipraytime"; if (-x $bin_path) { # OK, found something I can use last; } } $ipraytime = $opt{ipraytime} || $bin_path; # Set some default reminder settings @reminders = @{$opt{reminder}} ? @{$opt{reminder}} : (1, 5, 10, 20); # Enumerate the events we'll track and report on $DAY_TOT_SEC = (24 * 60 * 60); @EVENTS = (qw/imsaak fajr shorooq zuhr asr maghrib isha/); # Set some defaults $doing_2moro = 0; $time_to_use = time(); if (!-x $ipraytime) { &usage(1, "can't find '$ipraytime'"); } # Continuously cycle through for (;;) { # Get current start time $ref_time_used = &get_time($time_to_use); %time_used = %{$ref_time_used}; # Specify date to get info on $date_to_use = sprintf( "%d%02d%02d", $time_used{year}, $time_used{month}, $time_used{day} ); # Run the actual program executable and process its output $ref_today_events = &get_ipraytime($date_to_use); %today_events = %{$ref_today_events}; # Cycle through all the prayers (and events) for ($i = 0; $i <= $#EVENTS; $i++) { # Skip any events a user might have noted on the command-line if ( defined $opt{skip} ) { foreach my $option (@{$opt{skip}}) { # Make sure to make the compare case insensitive if ( uc($option) eq uc($EVENTS[$i]) ) { $skip_event = 1; last; } } # If a skip-hit occured, cycle out of the for loop if ($skip_event) { $skip_event = 0; next; } } # Determine current time's placement within event times $before_last = ( ($time_used{hour} < $today_events{$EVENTS[$#EVENTS]}{hour}) || (($time_used{hour} == $today_events{$EVENTS[$#EVENTS]}{hour}) && ($time_used{min} < $today_events{$EVENTS[$#EVENTS]}{min})) ); $after_current = ( ($time_used{hour} > $today_events{$EVENTS[$i]}{hour}) || (($time_used{hour} == $today_events{$EVENTS[$i]}{hour}) && ($time_used{min} >= $today_events{$EVENTS[$i]}{min})) ); # If we are dealing with next day (upon start), cycle through if (!$before_last && !$doing_2moro) { last; } # Skip the past while making sure we didn't go over if ($before_last && $after_current) { next; } else { # If I'm here, then its immaterial which day I'm dealing with $doing_2moro = 0; # See how many seconds we have left till next prayer if ($before_last) { # Get time difference between prayer and wallclock time $sec_diff = ( $today_events{$EVENTS[$i]}{tot_sec} - $time_used{tot_sec} ); } else { # Dealing with next day prayer # - Get portion of day left in today + tomorrow's $sec_diff = ( ($DAY_TOT_SEC - $time_used{tot_sec}) + $today_events{$EVENTS[$i]}{tot_sec} ); } # Account for the reminder time and the time delta seconds $sec_sleep = ( $sec_diff - $time_used{sec} ); # Tell user what to expect next $str = "$ID NOTE - Next event '$EVENTS[$i]' is at "; $str .= "$today_events{$EVENTS[$i]}"; &display(0, $EVENTS[$i], $str); # Sort numerically descending foreach $reminder (sort {$b <=> $a} @reminders) { $sec_reminder = ( $reminder * 60 ); if ($sec_sleep < $sec_reminder) { next; } $sec_sleep -= $sec_reminder; # Take a nap and wait :-) &do_reminder($EVENTS[$i], $sec_sleep, \%today_events, $reminder); $sec_sleep = $sec_reminder; } # Take a nap and wait (without reminders :-) &do_reminder($EVENTS[$i], $sec_sleep, 0, 0); &do_alarm($EVENTS[$i], \%today_events); # Take a nap and wait before next event/reminder sleep(300); # Establish new time for next prayer # - This is opted for instead of accounting for passed sec's $ref_time_used = &get_time(time()); %time_used = %{$ref_time_used}; } } # Cycle through & advance calc 1 day forward (ie. look at next day) $time_to_use = ( time() + $DAY_TOT_SEC ); $doing_2moro = 1; } ### ### ######## Procedures ######## ### ### ## # Print on screen passed-in string sub display { my ($salat_now, $salat_name, $string) = @_; # See if user is opting to use his/her own external trigger if (defined $opt{execr} || ($salat_now && defined $opt{execs})) { # Escape various characters just in case external application cares $string =~ s/\'/\\\'/g; $string =~ s/\(/\\\(/g; $string =~ s/\)/\\\)/g; # Kill a previous application in case its still running # - session/group PIDs (note '-') if ( $cpid ) { kill "KILL", -$cpid; } $ext_trigger = ( $salat_now ? $opt{execs} : $opt{execr} ); # Do various user substitutions # - %m for normal printable message string # - %s for salat name string $ext_trigger =~ s/\%m/$string/g; $ext_trigger =~ s/\%s/$salat_name/g; $cpid = &fork_exec("$ext_trigger"); } else { # Do some clean-up and backtrack per use command-line directives if ($opt{inplace}) { print "\r"; print " " x 78; print "\r"; } print $string; if (!$opt{inplace}) { print "\n"; } } } ## # Adjust user input to end-up with a proper array sub listify_input { my ($ref_in_opt, $in_str) = @_; my ( %in_opt, @in_arr, @mod_arr, ); %in_opt = %{$ref_in_opt}; @in_arr = @{$in_opt{$in_str}}; # Make sure to accept for instance, # 1. -skip one -skip two # 2. -skip "one two" # 3. -skip "one, two" foreach my $string (@in_arr) { if ($string =~ /\s+/) { my @sub_string = split(/[,]*\s+/, $string); push (@mod_arr, @sub_string); next; } push (@mod_arr, $string); } $in_opt{$in_str} = \@mod_arr; return(\%in_opt); } ## # Populate time hash/struct using the passed-in time value sub get_time { my ($in_time) = @_; my ( %tm, ); # seconds, minutes, hours, day, month, year, day.week, day.year, DST ($tm{sec}, $tm{min}, $tm{hour}, $tm{day}, $tm{month}, $tm{year}, $tm{dayofweek}, $tm{dayofyear}, $tm{dst}) = localtime($in_time); # Some reability corrections $tm{month} = ($tm{month} + 1); $tm{year} = (1900 + $tm{year}); # Set some needed values $tm{tot_min} = ($tm{min} + (60 * $tm{hour})); $tm{tot_sec} = (60 * $tm{tot_min}); return(\%tm); } ## # Populate event hash/struct based on ipraytime's output using date passed-in sub get_ipraytime { my ($in_date) = @_; my ( $aux, @out_ipray, $ipray, @times, ); if (defined $in_date) { $aux = "--date $in_date "; } @out_ipray = `$ipraytime $aux`; # Date Fajr Shorooq Zuhr Asr Maghrib Isha #-------------------------------------------------------------------- # [22-07-2004] 5:22 6:50 13:27 16:43 20:04 21:34 # #Today's Imsaak : 5:17 foreach my $line (@out_ipray) { # Remove the carriage returns chomp($line); # Find the proper line to process if ($line =~ /\[\d+-\d+-\d+\]/) { @entries = split (/\s\s+/, $line); $ipray{fajr} = $entries[1]; $ipray{shorooq} = $entries[2]; $ipray{zuhr} = $entries[3]; $ipray{asr} = $entries[4]; $ipray{maghrib} = $entries[5]; $ipray{isha} = $entries[6]; } # Grab today's imsaak time if ($line =~ /^Today.*Imsaak\s*:\s*(\d+:\d+)\s*/) { $ipray{imsaak} = $1; } } # Get the total number of seconds for each prayer and event for (my $i = 0; $i <= $#EVENTS; $i++) { @times = split(/\:/, $ipray{$EVENTS[$i]}); $ipray{$EVENTS[$i]}{hour} = $times[0]; $ipray{$EVENTS[$i]}{min} = $times[1]; $ipray{$EVENTS[$i]}{tot_min} = ($ipray{$EVENTS[$i]}{min} + (60 * $ipray{$EVENTS[$i]}{hour})); $ipray{$EVENTS[$i]}{tot_sec} = (60 * $ipray{$EVENTS[$i]}{tot_min}); } # Return the newly populated hash/structure return (\%ipray); } ## # Trigger a reminder sub do_reminder { my ($in_name, $in_time, $ref_event_struct, $in_rem) = @_; my ( $name, $str, ); %event_struct = %{$ref_event_struct}; $name = ucfirst($in_name); # Take a nap and wait sleep($in_time); # See if a reminder note is warranted if ($in_rem > 0) { NAME_CASE: { if ($in_name eq "imsaak") { $str = "Fasting is to commence ($event_struct{$in_name})"; last NAME_CASE; } if ($in_name eq "shorooq") { $str = "Salat Al-Fajr expires ($event_struct{$in_name})"; last NAME_CASE; } #default $str = "Salat Al-$name ($event_struct{$in_name})"; } &play_sound(); &display(0, $in_name, "$ID REMINDER - $str in $in_rem minutes !!"); } } ## # Trigger the alarm sub do_alarm { my ($in_name, $ref_event_struct) = @_; my ( $name, $event_struct, $num_rings, $str, ); $name = ucfirst($in_name); %event_struct = %{$ref_event_struct}; $num_rings = 4; NAME_CASE: { if ($in_name eq "imsaak") { $str = "to start your Fast"; last NAME_CASE; } if ($in_name eq "shorooq") { $str = "notes passing of Salat Al-Fajr"; last NAME_CASE; } #default $str = "for Salat Al-$name"; } &display(1, $in_name, "$ID $event_struct{$in_name} - Time NOW $str !!"); for(my $i = 0; $i < $num_rings; $i++) { &play_sound(); sleep(1); } } ## # Play a sound file (if possible) else gimme a beep :-) sub play_sound { print "\a"; } ## # Use this function instead of "system" (to catch Interrupts/^C and/or kills) sub fork_exec { my ($command) = @_; FORK_IT: { if ( $child_pid = fork ) # parent here { return($child_pid); } elsif ( defined $child_pid ) # child here (PID --> 0) { &POSIX::setsid(); # set current PID (child) to be session/group leader exec "$command" or &err(1, "Can't exec '$command': $!"); } elsif ( $! =~ /no more/i ) # No more Processes (sleep & retry ?) { # sleep 5; redo FORK_IT; &err(1, "No more processes !!!"); } else # weird fork error { &err(1, "Can't fork: $!"); } } } ## # Dump out an error message and possibly quit sub err { my ($die_after, $msg) = @_; print "$ID ERROR: $msg\n"; if ( $die_after ) { exit(1); } } ## # Print short usage info sub usage { my ($die_after, $err_msg) = @_; # if (defined $err_msg) { print $err_msg; } if (defined $err_msg) { &err(0, $err_msg); } print qq |Usage: $in_script [-ipraytime path] $in_spaces [-skip event_name] $in_spaces [-reminder minutes] $in_spaces [-inplace] $in_spaces [-execr cmd] $in_spaces [-execs cmd] $in_spaces [-help] |; if ( $die_after ) { exit(5); } } ## # Print one-liner help sub help { &usage(0); print qq| -> remind user visually and via audio of Islamic prayer times & misc events Options: [-ipraytime path] : Specify the executable path to program [-skip event_name] : Specify name of prayer/event to skip (list ok) [-reminder minutes] : Specify prior to how many minutes to remind (list ok) [-inplace] : Specify to print output in-place (without scrolling) [-execr cmd] : Specify an external application trigger for reminders [-execs cmd] : Specify an external application trigger for salat NOW [-help] : Produce this help screen |; exit(10); } ## # Get the command line arguments sub get_args { &GetOptions( \%opt, # Hash to store all input options in "ipraytime=s", # specify the binary ipraytime executable "skip=s@", # array'ed list of skip events "reminder=s@", # array'ed list of reminder times (minutes) "inplace", # specify to print in-place outputs (no scroll) "execr=s", # specify an external trigger (for reminders) "execs=s", # specify an external trigger (for salat_now) "help", # print a brief help screen ) || ( $? = 257, &usage(1, "Invalid argument !!") ); }