aegis -File_ATtributes(1) General Commands Manual aegis -File_ATtributes(1) NNAAMMEE aegis file attributes - modify the attributes of a file SSYYNNOOPPSSIISS aaeeggiiss --FFiillee__AATTttrriibbuutteess --FFiillee _a_t_t_r_-_f_i_l_e [ _o_p_t_i_o_n... ] _f_i_l_e_n_a_m_e aaeeggiiss --FFiillee__AATTttrriibbuutteess --EEddiitt [ _o_p_t_i_o_n... ] _f_i_l_e_n_a_m_e aaeeggiiss --FFiillee__AATTttrriibbuutteess [ _o_p_t_i_o_n... ] _n_a_m_e==_v_a_l_u_e _f_i_l_e_n_a_m_e aaeeggiiss --FFiillee__AATTttrriibbuutteess --UUUUIIDD _n_u_m_b_e_r --FFiillee _f_i_l_e_n_a_m_e aaeeggiiss --FFiillee__AATTttrriibbuutteess --HHeellpp DDEESSCCRRIIPPTTIIOONN The _a_e_g_i_s _-_F_i_l_e___A_T_t_r_i_b_u_t_e_s command is used to set, edit or list the attributes of a file. The output of the --LLiisstt variant is suitable for use as input at a later time. See _a_e_f_a_t_t_r(5) for a description of the file format. Attribute names are not case sensitive. File attributes with a name starting with an upper case letter will appear in _a_e_l(1) and _a_e_g_e_t(1) listings, while those starting with a lower case letter will not. SShhoorrtthhaanndd If you are only setting the values of unique attributes, it is possi- ble to do this from the command line, using the _n_a_m_e==_v_a_l_u_e form. Note that this usage will replace the first attribute with the given name. If there is more than one attribute of that name, the second and subsequent attributes are unchanged. If there is no attribute of the given name, it will be appended. You may set more than one attribute at a time, provided that their names are unique. Attribute names are not case sensitive. KKnnoowwnn AAttttrriibbuuttee NNaammeess While many of the anticipated uses of file attributes are to allow projects to attach their own specialized data to individual files, Aegis also uses some attributes for its own purposes (and arguably, should always have done so to maximize forwards compatibility across Aegis upgrades). aede-policy-crlf-allowed boolean. If true, the _c_r_l_f policy of the _a_e_d_e_-_p_o_l_i_c_y(1) com- mand does not apply. aede-policy-escape-hyphen boolean. If false, the _e_s_c_a_p_e_-_h_y_p_h_e_n policy of the _a_e_d_e_-_p_o_l_- _i_c_y(1) command does not apply. aede-policy-line-length integer. The maximum allowed line length in the _l_i_n_e_-_l_e_n_g_t_h policy of the _a_e_d_e_-_p_o_l_i_c_y(1) command; infinity if 0. aede-policy-tabs-allowed boolean. If true, the _n_o_-_t_a_b_s policy of the _a_e_d_e_-_p_o_l_i_c_y(1) command does not apply. aeipass-options:assign-file-uuid boolean. If false, _a_e_i_p_a_s_s will not assign a fresh UUID to this file. This flag is set by _a_e_d_i_s_t -rec if the action associated with the file is a create and the file is missing the UUID. This behaviour is needed to prevent the effect of having different UUIDs assigned to the same file in different repositories. aemakegen:noinst boolean. If true, _a_e_m_a_k_e_g_e_n(1) will not cause the program to be installed. Usually attached to the source file containing the _m_a_i_n function, or to script files. Defaults to false if not defined (_i_._e_. do install program). content-type This is taken directly from the MIME definition of Content- Type. It remembers what sort of file this is. It is antici- pated that a _d_i_f_f tool, for example, could make use of this attribute to provide format-specific file difference listings. Some change set interchange formats are capable of carrying this information. entire-source-hide boolean. If true, this file is not included by the _a_e_d_i_s_t _-_e_n_t_i_r_e_-_s_o_u_r_c_e flag. The _a_e_t_a_r and _a_e_r_e_v_m_l commands work sim- ilarly. Think of it as a "local only" flag. foreign-copyright boolean. If true, this file will not be checked by the _a_e_d_e_- _p_o_l_i_c_y(1) copyright validation. local-source-hide boolean. If true, this file is not included by _a_e_d_i_s_t change sets. The _a_e_t_a_r and _a_e_r_e_v_m_l commands work similarly. Change sets which contain _o_n_l_y thee files will be omitted from the _a_e_d_i_s_t _-_i_n_v_e_n_t_o_r_y output. Think of it as a "local only" flag. test/_a_r_c_h/elapsed This is used to estimate test duration. See _a_e_t(1) for more information. OOPPTTIIOONNSS The following options are understood: --BBAAssee__RREEllaattiivvee This option may be used to cause relative filenames to be con- sidered relative to the base of the source tree. See _a_e_u_- _c_o_n_f(5) for the corresponding user preference. --CCUUrrrreenntt__RREEllaattiivvee This option may be used to cause relative filenames to be con- sidered relative to the current directory. This is usually the default. See _a_e_u_c_o_n_f(5) for the corresponding user pref- erence. --CChhaannggee _n_u_m_b_e_r This option may be used to specify a particular change within a project. See _a_e_g_i_s(1) for a complete description of this option. --HHeellpp This option may be used to obtain more information about how to use the _a_e_g_i_s program. --LLiisstt This option may be used to obtain a list of suitable subjects for this command. The list may be more general than expected. --PPrroojjeecctt _n_a_m_e This option may be used to select the project of interest. When no --PPrroojjeecctt option is specified, the _A_E_G_I_S___P_R_O_J_E_C_T envi- ronment variable is consulted. If that does not exist, the user's _$_H_O_M_E_/_._a_e_g_i_s_r_c file is examined for a default project field (see _a_e_u_c_o_n_f(5) for more information). If that does not exist, when the user is only working on changes within a sin- gle project, the project name defaults to that project. Oth- erwise, it is an error. --TTEERRssee This option may be used to cause listings to produce the bare minimum of information. It is usually useful for shell scripts. --UUnniivveerrssaall__UUnniiqquuee__IIDDeennttiiffiieerr _n_u_m_b_e_r This option may be used to set the UUID of a file. --VVeerrbboossee This option may be used to cause aegis to produce more output. By default aegis only produces output on errors. When used with the --LLiisstt option this option causes column headings to be added. --WWaaiitt This option may be used to require Aegis commands to wait for access locks, if they cannot be obtained immediately. Defaults to the user's _l_o_c_k___w_a_i_t___p_r_e_f_e_r_e_n_c_e if not specified, see _a_e_u_c_o_n_f(5) for more information. --NNoo__WWaaiitt This option may be used to require Aegis commands to emit a fatal error if access locks cannot be obtained immediately. Defaults to the user's _l_o_c_k___w_a_i_t___p_r_e_f_e_r_e_n_c_e if not specified, see _a_e_u_c_o_n_f(5) for more information. See also _a_e_g_i_s(1) for options common to all aegis commands. All options may be abbreviated; the abbreviation is documented as the upper case letters, all lower case letters and underscores (_) are optional. You must use consecutive sequences of optional letters. All options are case insensitive, you may type them in upper case or lower case or a combination of both, case is not important. For example: the arguments "-project", "-PROJ" and "-p" are all inter- preted to mean the --PPrroojjeecctt option. The argument "-prj" will not be understood, because consecutive optional characters were not supplied. Options and other command line arguments may be mixed arbitrarily on the command line, after the function selectors. The GNU long option names are understood. Since all option names for _a_e_g_i_s are long, this means ignoring the extra leading '-'. The "----_o_p_t_i_o_n==_v_a_l_u_e" convention is also understood. RREECCOOMMMMEENNDDEEDD AALLIIAASS The recommended alias for this command is csh% alias aefa 'aegis -fat \!* -v' sh$ aefa(){aegis -fat "$@" -v} EERRRROORRSS It is an error if the current user is not an administrator of the specified project. It is an error if the current user is not the developer of the speci- fied change. It is an error if the file is not included in the specified change. EEXXIITT SSTTAATTUUSS The _a_e_g_i_s command will exit with a status of 1 on any error. The _a_e_g_i_s command will only exit with a status of 0 if there are no errors. EENNVVIIRROONNMMEENNTT VVAARRIIAABBLLEESS See _a_e_g_i_s(1) for a list of environment variables which may affect this command. See _a_e_p_c_o_n_f(5) for the project configuration file's _p_r_o_j_e_c_t___s_p_e_c_i_f_i_c field for how to set environment variables for all commands executed by Aegis. SSEEEE AALLSSOO _a_e_c_a(5) modify the attributes of a change _a_e_f_a_t_t_r(5) file attributes file format CCOOPPYYRRIIGGHHTT aegis 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 aegis program comes with ABSOLUTELY NO WARRANTY; for details use the '_a_e_g_i_s _-_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_i_s _-_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 aegis -File_ATtributes(1)