Module const

Main constants configurators, this is the only function that you should call from the outside, everytime you want. it will reset all the variables excluding those backed up previously.

@param rootdir current root directory, if any, or "" @type rootdir str @return None

Initialization of all the Entropy base settings.

@param rootdir current root directory, if any, or "" @type rootdir str @return None

Change current process scheduler "nice" level.

@param nice_level new valid nice level @type nice_level int @return current_nice new nice level

Extract repository information from the provided repository string,
usually contained in the repository settings file, repositories.conf.

@param repostring basestring
@type repostring valid repository string
@return tuple composed by
    reponame => repository identifier (string),
    mydata => extracted repository information (dict)

Read Entropy release file content and fill etpConst['entropyversion']

@return None

Setup Entropy pid file, if possible and if UID = 0 (root). If the application is run with --no-pid-handling argument, this function will have no effect. If just_read is specified, this function will only try to read the current pid string in the Entropy pid file (etpConst['pidfile']). If any other entropy istance is currently owning the contained pid, etpConst['applicationlock'] becomes True.

@param just_read only read the current pid file, if any and if possible @type just_read bool

@return None

Setup entropy file needing strict permissions, no world readable.

@param config_file valid config file path @type config_file basestring @return None

Setup entropy pid file permissions, if possible.

@return None

Setup Entropy directory structure, as much automagically as possible.

@return None

Setup Entropy lock file paths.

@return None

Analyze a server repository string (usually contained in server.conf), extracting all the parameters.

@param repostring repository string @type repostring basestring @return None

Setup permissions and group id (GID) to a directory, recursively.

@param mydir valid file path @type mydir basestring @param gid valid group id (GID) @type gid int @return None

Setup file permissions and group id (GID).

@param myfile valid file path @type myfile basestring @param gid valid group id (GID) @type gid int @param chmod permissions @type chmod integer representing an octal @return None

This function get the current permissions of the specified file. If you want to use the returning value with const_set_chmod you need to convert it back to int.

@param myfile valid file path @type myfile basestring @return octal representing permissions

This function sets specified permissions to a file. If they differ from the current ones.

@param myfile valid file path @type myfile basestring @param chmod permissions @type chmod integer representing an octal @return None

This function tries to retrieve the "entropy" user group GID.

@return None or KeyError exception

This function looks for an "entropy" user group. If not available, it tries to create one.

@return None

Live environments (Operating System running off a CD/DVD) must feature the "cdroot" parameter in kernel /proc/cmdline

@return bool stating if we are running Live or not

Entropy threads killer. Even if Python threads cannot be stopped or killed, TimeScheduled ones can, exporting the kill() method.

@return None

Our default Python exception handler. It kills all the threads generated by Entropy before raising exceptions. Overloads sys.excepthook

@param etype exception type @param value exception value @param t_back traceback object? @return sys.__excepthook__

etpSys

Value:

{'api': '3', 'arch': 'amd64', 'archs': ['x86', 'amd64'], 'dirstoclean': set([]), 'killpids': set([]), 'maxthreads': 100, 'rootdir': '', 'serverside': False}

etpUi

Value:

{'ask': False, 'clean': False, 'debug': False, 'mute': False, 'nolog': False, 'pretend': False, 'quiet': False, 'verbose': False}

etpCache

Value:

{'advisories': 'security/advisories_cache_', 'atomMatch': 'atom_match/atom_match_', 'check_package_update': 'check_update/package_update_', 'configfiles': 'conf/scanfs', 'dbMatch': 'match/db', 'dbSearch': 'search/db', 'dep_tree': 'deptree/dep_tree_', 'depends_tree': 'depends/depends_tree_', ...

etpConst

Value:

{'applicationlock': False, 'backed_up': {}, 'branch': '4', 'branches': [], 'cachedumpext': '.dmp', 'client_treeupdatescalled': set([]), 'clientconf': '/etc/entropy/client.conf', 'clientdbid': 'client', ...