aeget(1) aeget(1) NNAAMMEE aeget - Aegis CGI file access SSYYNNOOPPSSIISS aaeeggeett DDEESSCCRRIIPPTTIIOONN The _a_e_g_e_t command is used with Apache (or CGI conforming any other web server) to access the files of an Aegis project. The files are searched for along the appropriate search path, including all ancestor baslines, not just the baseline of the branch. This is useful when developing web sites using Aegis. IInnssttaallll In order to use _a_e_g_e_t(1), you need to copy it into your _c_g_i_-_b_i_n direc- tory. You may prefer to use a symbolic link, as this will be more stable across Aegis upgrades. However, this requires a corresponding _f_o_l_l_o_w_- _s_y_m_l_i_n_k_s setting in your web server's configuration file. UUssaaggee Once _a_e_g_e_t(1) is installed, files may be accessed via http://localhost/cgi-bin/aeget/_p_r_o_j_e_c_t_-_n_a_m_e/ If no project name is given, a list of projects will be generated. This will lead you through a series of menus, giving access to manu useful pages of information about your projects. CCaassccaaddiinngg SSttyyllee SShheeeettss The web interface uses Cascading Style Sheets. You can give the web interface a personalised look and feel, by creating stylesheets in the web server's Document Root directory. The interface will use it's default styles, then styles from a global style sheet called aede- fault.css, and then styles from a project stylesheet called _p_r_o_j_e_c_t_- _n_a_m_e.css (replace _p_r_o_j_e_c_t_n_a_m_e with the name of the project). There is an example style sheet in /usr/local/share/aegis/aede- fault.css which demonstrates the style elements used. This particular stylesheet is not designed to be aesthetically pleasing, but to exer- cise all of the elements. Using this stylesheet unmodified will give psychedelic results. Use it as a template. PPRROOJJEECCTT AATTTTRRIIBBUUTTEESS You can set your own project specific page headers and footers by using the "html:meta", "html:body-begin" and "html:body-end" project specific attributes. project_specific = [ { name = "html:body-begin"; value = "This text goes immediately after the <BODY> and before any text generated by aeget(1)."; }, { name = "html:body-end"; value = "This text goes immediately before the </BODY> and after all text generated by aeget(1)."; }, ]; These fields may be used to customize your web pages for your project- specific or company-specific needs. Each project is configured inde- pendently. CCHHAANNGGEE AATTTTRRIIBBUUTTEESS If you wish to prevent a change set appearing in the change set inven- tory used by _a_e_d_i_s_t _-_r_e_p_l_a_y to determine what needs to be downloaded, set the following change set attribute: attribute = [ { name = "aeget:inventory:hide"; value = "true"; }, ]; You must use the _a_e_c_a(1) command for this, the _t_k_a_e_c_a(1) command can not edit change set attributes. DDEEBBUUGGGGIINNGG aanndd TTEESSTTIINNGG You can run the _a_e_g_e_t(1) program from the command line if you set the appropriate environment variables. This is how you debug or test _a_e_g_e_t(1) command. REQUEST_METHOD This is how the script is being invoked. For _a_e_g_e_t(1) com- mand, this is always "GET". SCRIPT_NAME This is the path of the script name, from the HTTP client's point of view. Typically this is "/cgi-bin/aeget". PATH_INFO This is the portion of the URL between the script name and the question mark. For _a_e_g_e_t(1) this is usually the project name or the project name and the change number. No project name will get you the project list page. QUERY_STRING This the portion of the URL after the question mark. The above will not means much if you are not familiar with CGI scripts. For the URL http://localhost/cgi- bin/aeget/aegis.4.1.C10?menu would have Apache set the following envi- ronment variables REQUEST_METHOD=GET \ SCRIPT_NAME=/cgi-bin/aeget \ PATH_INFO=/aegis.4.1.C10 \ QUERY_STRING='menu' \ aeget Output is written to stdout. Tests scripts can easily capture this and compare it with expected results. Make sure you avoid false nega- tives because of the date tacked onto the end of most pages. AAppaacchhee If you see "serious server error" pages when accessing _a_e_g_e_t(1) via a web server, the stderr text is usually available in the server's error log. CCOOPPYYRRIIGGHHTT aeget version 4.25.D611 Copyright (C) 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014 Peter Miller The aeget program comes with ABSOLUTELY NO WARRANTY; for details use the '_a_e_g_e_t _-_V_E_R_S_i_o_n _L_i_c_e_n_s_e' command. This is free software and you are welcome to redistribute it under certain conditions; for details use the '_a_e_g_e_t _-_V_E_R_S_i_o_n _L_i_c_e_n_s_e' command. AAUUTTHHOORR Peter Miller E-Mail: pmiller@opensource.org.au /\/\* WWW: http://miller.emu.id.au/pmiller/ Reference Manual Aegis aeget(1)