Google
Edit File: plugin_bootloader.cpython-39.pyc
a �]�isc � @ s� d dl mZ d dlT ddlZd dl mZ ddlmZ ddlm Z ddl Z ddl Z ddl Z ddl mZ ej�� ZG dd � d ej�ZdS ) � )�base)�*� N)� exceptions)�commands)�sleepc s� e Zd ZdZ� fdd�Zdd� Zdd� Zedd � �Zd d � Z d d � Z dd� Z g g fdd�Z dd� Z dd� Zdd� Zdd� Zdd� Zd d � Zd d � Zejfd d!�Zd"d#� Zd$d%� Zd&d'� Zd(d)� Zd*d+� Zd,d-� Z d.d/� Z d0d1� Z d2d3� Z d4d5� Z d6d7� Z!d8d9� Z"d:d;� Z#d<d=� Z$e%d>�d?d@� �Z&e%dA�dBdC� �Z'e%dD�dEdF� �Z(e%dGdHdIdJ�dKdL� �Z)e%dMdHdIdJ�dNdO� �Z*e%dPdHdIdJ�dQdR� �Z+e%dSdHdIdJ�dTdU� �Z,dVdW� Z-� Z.S )X�BootloaderPlugina. Adds options to the kernel command line. This plug-in supports the GRUB 2 boot loader and the Boot Loader Specification (BLS). NOTE: *TuneD* will not remove or replace kernel command line parameters added via other methods like *grubby*. *TuneD* will manage the kernel command line parameters added via *TuneD*. Please refer to your platform bootloader documentation about how to identify and manage kernel command line parameters set outside of *TuneD*. Customized non-standard location of the GRUB 2 configuration file can be specified by the [option]`grub2_cfg_file` option. The kernel options are added to the current GRUB configuration and its templates. Reboot the system for the kernel option to take effect. Switching to another profile or manually stopping the `tuned` service removes the additional options. If you shut down or reboot the system, the kernel options persist in the [filename]`grub.cfg` file and grub environment files. The kernel options can be specified by the following syntax: [subs="quotes"] ---- cmdline__suffix__=__arg1__ __arg2__ ... __argN__ ---- Or with an alternative, but equivalent syntax: [subs="quotes"] ---- cmdline__suffix__=+__arg1__ __arg2__ ... __argN__ ---- Where __suffix__ can be arbitrary (even empty) alphanumeric string which should be unique across all loaded profiles. It is recommended to use the profile name as the __suffix__ (for example, [option]`cmdline_my_profile`). If there are multiple [option]`cmdline` options with the same suffix, during the profile load/merge the value which was assigned previously will be used. This is the same behavior as any other plug-in options. The final kernel command line is constructed by concatenating all the resulting [option]`cmdline` options. It is also possible to remove kernel options by the following syntax: [subs="quotes"] ---- cmdline__suffix__=-__arg1__ __arg2__ ... __argN__ ---- Such kernel options will not be concatenated and thus removed during the final kernel command line construction. .Modifying the kernel command line ==== For example, to add the [option]`quiet` kernel option to a *TuneD* profile, include the following lines in the [filename]`tuned.conf` file: ---- [bootloader] cmdline_my_profile=+quiet ---- An example of a custom profile `my_profile` that adds the [option]`isolcpus=2` option to the kernel command line: ---- [bootloader] cmdline_my_profile=isolcpus=2 ---- An example of a custom profile `my_profile` that removes the [option]`rhgb quiet` options from the kernel command line (if previously added by *TuneD*): ---- [bootloader] cmdline_my_profile=-rhgb quiet ---- ==== .Modifying the kernel command line, example with inheritance ==== For example, to add the [option]`rhgb quiet` kernel options to a *TuneD* profile `profile_1`: ---- [bootloader] cmdline_profile_1=+rhgb quiet ---- In the child profile `profile_2` drop the [option]`quiet` option from the kernel command line: ---- [main] include=profile_1 [bootloader] cmdline_profile_2=-quiet ---- The final kernel command line will be [option]`rhgb`. In case the same [option]`cmdline` suffix as in the `profile_1` is used: ---- [main] include=profile_1 [bootloader] cmdline_profile_1=-quiet ---- It will result in the empty kernel command line because the merge executes and the [option]`cmdline_profile_1` gets redefined to just [option]`-quiet`. Thus there is nothing to remove in the final kernel command line processing. ==== The [option]`initrd_add_img=IMAGE` adds an initrd overlay file `IMAGE`. If the `IMAGE` file name begins with '/', the absolute path is used. Otherwise, the current profile directory is used as the base directory for the `IMAGE`. The [option]`initrd_add_dir=DIR` creates an initrd image from the directory `DIR` and adds the resulting image as an overlay. If the `DIR` directory name begins with '/', the absolute path is used. Otherwise, the current profile directory is used as the base directory for the `DIR`. The [option]`initrd_dst_img=PATHNAME` sets the name and location of the resulting initrd image. Typically, it is not necessary to use this option. By default, the location of initrd images is `/boot` and the name of the image is taken as the basename of `IMAGE` or `DIR`. This can be overridden by setting [option]`initrd_dst_img`. The [option]`initrd_remove_dir=VALUE` removes the source directory from which the initrd image was built if `VALUE` is true. Only 'y', 'yes', 't', 'true' and '1' (case insensitive) are accepted as true values for this option. Other values are interpreted as false. .Adding an overlay initrd image ==== ---- [bootloader] initrd_remove_dir=True initrd_add_dir=/tmp/tuned-initrd.img ---- This creates an initrd image from the `/tmp/tuned-initrd.img` directory and and then removes the `tuned-initrd.img` directory from `/tmp`. ==== The [option]`skip_grub_config=VALUE` does not change grub configuration if `VALUE` is true. However, [option]`cmdline` options are still processed, and the result is used to verify the current cmdline. Only 'y', 'yes', 't', 'true' and '1' (case insensitive) are accepted as true values for this option. Other values are interpreted as false. .Do not change grub configuration ==== ---- [bootloader] skip_grub_config=True cmdline=+systemd.cpu_affinity=1 ---- ==== c s: t j�tj�st�d��tt| �j |i |�� t � | _ d S )Nz4Required GRUB2 template not found, disabling plugin.) �os�path�isfile�constsZGRUB2_TUNED_TEMPLATE_PATHr ZNotSupportedPluginException�superr �__init__r �_cmd)�self�args�kwargs�� __class__� �C/usr/lib/python3.9/site-packages/tuned/plugins/plugin_bootloader.pyr � s zBootloaderPlugin.__init__c C sV d|_ d|_d| _d| _d| _d | _d| _d| _| �� | _ | � � | _ | � � d u| _ d S )NFT� )Z_has_dynamic_tuningZ_has_static_tuning�update_grub2_cfg�_skip_grub_config_val�_initrd_remove_dir�_initrd_dst_img_val� _cmdline_val� _initrd_val�_get_grub2_cfg_files�_grub2_cfg_file_names� _bls_enabled�_bls�_rpm_ostree_status� _rpm_ostree�r �instancer r r �_instance_init� s z BootloaderPlugin._instance_initc C s d S �Nr r$ r r r �_instance_cleanup� s z"BootloaderPlugin._instance_cleanupc C s d d d d d d d d�S )N)�grub2_cfg_file�initrd_dst_img�initrd_add_img�initrd_add_dir�initrd_remove_dir�cmdline�skip_grub_configr )�clsr r r �_get_config_options� s �z$BootloaderPlugin._get_config_optionsc C sr | j jddgdd�\}}}t�d||f � |dkr8dS |�� }t|�dk sX|d d krjt�d | � dS |d S ) zW Returns status of rpm-ostree transactions or None if not run on rpm-ostree system � rpm-ostree�statusT�Z return_errz.rpm-ostree status output stdout: %s stderr: %sr N� zState:z2Exceptional format of rpm-ostree status result: %sr )r �execute�log�debug�split�len�warning)r �rc�out�errZsplitedr r r r" � s z#BootloaderPlugin._rpm_ostree_statusc C s< d}d}t |�D ] }| �� dkr& dS t|� q| �� dkS )z:Check that rpm-ostree is idle, allowing some waiting time.� g �?ZidleT)�ranger" r )r Z sleep_cyclesZ sleep_secs�_r r r �_wait_till_rpm_ostree_idle� s z+BootloaderPlugin._wait_till_rpm_ostree_idlec C s` | � � st�d� dS | jjddgdd�\}}}|rBt�d| � |dkr\t�d | � dS |S ) zPRetrieve the output of rpm-ostree kargs, i.e., current default kernel arguments.z2Error getting rpm-ostree kargs: rpm-ostree is busyNr2 �kargsTr4 zrpm-ostree kargs: %sr z"Error getting rpm-ostree kargs: %s)rB r7 �errorr r6 r8 )r r< r= r> r r r �_get_rpm_ostree_kargs� s z&BootloaderPlugin._get_rpm_ostree_kargsc C sj | � � st�d� dS | jjddgdd� |D � dd� |D � dd �\}}}|d krft�d | � dS dS ) z� Modify (delete and append) kernel arguments in a rpm-ostree system. Return a boolean indicating whether the operation was successful. z4Error modifying rpm-ostree kargs: rpm-ostree is busyFr2 rC c S s g | ] }d | �qS )z --delete=%sr ��.0�kargr r r � <listcomp> � z=BootloaderPlugin._modify_rpm_ostree_kargs.<locals>.<listcomp>c S s g | ] }d | �qS )z --append=%sr rF r r r rI rJ Tr4 r z$Error modifying rpm-ostree kargs: %s)rB r7 rD r r6 )r � delete_kargs� append_kargsr< rA r> r r r �_modify_rpm_ostree_kargs� s � �� z)BootloaderPlugin._modify_rpm_ostree_kargsc C sH | � � �� }g }|D ]J}t|��d�r2|�|� q||v rH|| ||< qt�d|| jjf � qd}|D ]�}|| }|du sh|dkr�qh|d }|dd� }|dd� � � } |dks�|d kr�|d v r�| dkr�|d | 7 }qh|d k�r | dk�r(| � � D ]$} t � | �} t � d | d d|�}q�qh|d | 7 }qh|� � }|dk�rD||d< |S )zSMerge provided options with plugin default options and merge all cmdline.* options.r. z$Unknown option '%s' for plugin '%s'.r Nr r r5 �+�\)rO rN �-� rP z(\A|\s)z (?=\Z|\s))r1 �copy�str� startswith�appendr7 r; r �__name__�stripr9 �re�escape�sub) r �optionsZ effectiveZ cmdline_keys�keyr. �val�opZop1Zvals�pZregexr r r �_get_effective_options s: z'BootloaderPlugin._get_effective_optionsc C s* g }t jD ]}tj�|�r |�|� q |S r' )r ZGRUB2_CFG_FILESr r �existsrU )r Z cfg_files�fr r r r , s z%BootloaderPlugin._get_grub2_cfg_filesc C sH | j jtjdd�}t|�dkr2t�dtj � dS tjd|tj d�d uS )NT�Zno_errorr �cannot read '%s'Fz=^\s*GRUB_ENABLE_BLSCFG\s*=\s*\"?\s*[tT][rR][uU][eE]\s*\"?\s*$��flags) r � read_filer �GRUB2_DEFAULT_ENV_FILEr: r7 �inforX �search� MULTILINE)r �grub2_default_envr r r r 3 s ��z BootloaderPlugin._bls_enabledc C s | j �tj|�S r' )r �add_modify_option_in_filer �BOOT_CMDLINE_FILE)r �dr r r �_patch_bootcmdline< s z#BootloaderPlugin._patch_bootcmdlinec C s� | � tjdtjdi� | js*t�d� d S | jD ]*}| jj|dtj ddtj didd� q0| j d ur�t�d| j � | j� | j � d S )Nr � cannot find grub.cfg to patchzset\s+F)�addzremoving initrd image '%s') rp r �BOOT_CMDLINE_TUNED_VAR�BOOT_CMDLINE_INITRD_ADD_VARr r7 ri r rm �GRUB2_TUNED_VAR�GRUB2_TUNED_INITRD_VARr �unlink)r rb r r r �_remove_grub2_tuning? s ( z%BootloaderPlugin._remove_grub2_tuningc C s: | j �tj�}tjtjd |tjd�}|r6|d �� S g S )z`Return the list of kernel arguments that were appended by this profile (in a rpm-ostree system).z =\"(.*)\"re r ) r rg r rn rX rj rs rk r9 )r rb Zappendedr r r � _get_appended_rpm_ostree_kargsJ s z/BootloaderPlugin._get_appended_rpm_ostree_kargsc C s$ | j | �� d� | �tjdi� dS )z6Remove kernel parameter tuning in a rpm-ostree system.)rK r N)rM ry rp r rs �r r r r �_remove_rpm_ostree_tuningP s z*BootloaderPlugin._remove_rpm_ostree_tuningc C sP |t jkrL| jsL| jr*t�d� | �� n"t�d� | �� | �ddd�� d S )Nz4removing rpm-ostree tuning previously added by Tunedz/removing grub2 tuning previously added by Tunedr �Z tuned_paramsZ tuned_initrd) r Z ROLLBACK_FULLr r# r7 ri r{ rx �_update_grubenv)r r% Zrollbackr r r �_instance_unapply_staticU s z)BootloaderPlugin._instance_unapply_staticc C s� t �d� tjdtj d d|tjd�}tjdtj d|tjd�}tjdtj d d|tjd�}tjdtj d|tjd�}tjtjd d|tjd�}tjtj d d|tjd�S ) Nzunpatching grub.cfgz ^\s*set\s+z\s*=.* r re z *\$�\nz\n+) r7 r8 rX rZ r ru rk rv �GRUB2_TEMPLATE_HEADER_BEGIN�GRUB2_TEMPLATE_HEADER_END)r � grub2_cfg�cfgr r r �_grub2_cfg_unpatch_ s z#BootloaderPlugin._grub2_cfg_unpatchc C s� t �d� dtj d }|D ]0}|d| j�|� d | j�|| � d 7 }q |tjd 7 }tjd||tj d �}tj tj d �}|D ]l}tjd | d d || |tj d �}tjd | d || d d|tj d �}tjd | d d|tj d �}q�|S )Nz initial patching of grub.cfgz\1\n\n� zset z="�" r z+^(\s*###\s+END\s+[^#]+/00_header\s+### *)\nre )ZlinuxZinitrdz^(\s*z(16|efi)?\s+.*)$z\1 $z (?:16|efi)?\s+\S+rescue.*)\$z *(.*)$z\1\2z (?:16|efi)?\s+\S+rescue.*) +$�\1) r7 r8 r r� r rY r� rX rZ rk ru rv )r r� ro �s�optZd2�ir r r �_grub2_cfg_patch_initialh s .$( z)BootloaderPlugin._grub2_cfg_patch_initialc C s� | j �tj�}t|�dkr.t�dtj � dS tjtjd�}d}|D ]n}t j d| d || d |t j d�d u rDd }|d d kr�|d 7 }||d | d | d || d 7 }qD|r�t� dtj � | j � tj|� d S )Nr rd F)ZGRUB_CMDLINE_LINUX_DEFAULTZGRUB_INITRD_OVERLAYz^[^#]*\bz \s*=.*\\\$z\b.*$re T���r� z="${z:+$z }\$r� z patching '%s')r rg r rh r: r7 ri ru rv rX rj rk r8 � write_to_file)r rl ro �writer� r r r �_grub2_default_env_patchz s * *z)BootloaderPlugin._grub2_default_env_patchc C s� | j �tj�}t|�dkr.t�dtj � dS d}tjdtj d |tj d�r�d}tj dtj d d |tj d�}|d d kr�|d 7 }|r�t� d tj � | j � tj|� dS ) Nr rd Fzb^GRUB_CMDLINE_LINUX_DEFAULT=\"\$\{GRUB_CMDLINE_LINUX_DEFAULT:\+\$GRUB_CMDLINE_LINUX_DEFAULT \}\\\$z"$re Tz"$ r r� r� zunpatching '%s')r rg r rh r: r7 ri rX rj ru rk rZ r8 r� )r rl r� r� r r r �_grub2_default_env_unpatch� s4 ������ z+BootloaderPlugin._grub2_default_env_unpatchc C sP t �d� | js t �d� dS | jD �] }| j�|�}t|�dkrRt �d| � q$t �d| � |}d}|D ]^}tjd| d d | j� || � d |tj d �\}}|d k s�tj d | |tj d �d u rld}qlttj d t j |tj d ��ttj d t j |tj d ��k�r d}|�r"| �| �|�|�}| j�||� q$| j�rD| �� n| �� dS )Nzpatching grub.cfgrq Fr zcannot patch %sz+adding boot command line parameters to '%s'z \b(set\s+z\s*=).*$z\1"�"re r z\$T)r7 r8 r ri r rg r: rX �subnrY rk rj �findallr ru rv r� r� r� r! r� r� )r ro rb r� Z grub2_cfg_newZ patch_initialr� Znsubsr r r �_grub2_cfg_patch� s6 4"� z!BootloaderPlugin._grub2_cfg_patchc s� | � � }| j�� }| �� }|du r0t�d� dS |�� � |D ]}� �|� q<� fdd�|D �}||krtt�d� dS | j||d�r�| � t j d� |�i� dS )z5Apply kernel parameter tuning in a rpm-ostree system.Nz?Not updating kernel arguments, could not read the current ones.c s g | ]}|� vr|�qS r r rF �Znon_tuned_kargsr r rI � rJ z7BootloaderPlugin._rpm_ostree_update.<locals>.<listcomp>z+Kernel arguments already set, not updating.)rK rL rQ ) ry r r9 rE r7 rD �removeri rM rp r rs �join)r Zappended_kargsZ profile_kargsZ active_kargsrH Zkargs_to_appendr r� r �_rpm_ostree_update� s z#BootloaderPlugin._rpm_ostree_updatec C s8 | � tj| jtj| ji� | �tj| jtj| ji� d S r' ) r� r ru r rv r rp rs rt rz r r r � _grub2_update� s z BootloaderPlugin._grub2_updatec C s t j�tj�S r' )r r ra r ZBLS_ENTRIES_PATHrz r r r �_has_bls� s zBootloaderPlugin._has_blsc C sZ t �dt|� � dd� |�� D �}| j�g d�| �\}}|dkrVt �d| � dS dS ) Nz updating grubenv, setting %sc S s$ g | ] \}}d t |�t |�f �qS )z%s=%s)rS )rG �option�valuer r r rI � rJ z4BootloaderPlugin._update_grubenv.<locals>.<listcomp>)z grub2-editenvrP �setr zcannot update grubenv: '%s'FT)r7 r8 rS �itemsr r6 r; )r ro �lr< r= r r r r} � s z BootloaderPlugin._update_grubenvc C sb | j �� }|dkrdS t�dtj � | j jtjdgd|id�\}}|dkr^t�d| � dS d S ) Nr Fz4running kernel update hook '%s' to patch BLS entriesrr ZKERNEL_INSTALL_MACHINE_ID)�envr z cannot patch BLS entries: '%s'T)r Zget_machine_idr7 r8 r ZKERNEL_UPDATE_HOOK_FILEr6 r; )r Z machine_idr< r= r r r �_bls_entries_patch_initial� s z+BootloaderPlugin._bls_entries_patch_initialc C s6 t �d� | �� r2| �| j| jd��r2| �� r2dS dS )Nz updating BLSr| TF)r7 r8 r� r} r r r� rz r r r � _bls_update� s ��z BootloaderPlugin._bls_updatec C s( | j d u r$tj�tjtj�|��| _ d S r' )r r r r� r �BOOT_DIR�basename)r �namer r r �_init_initrd_dst_img� s z%BootloaderPlugin._init_initrd_dst_imgc C s t j�tj�S r' )r r �isdirr ZPETITBOOT_DETECT_DIRrz r r r �_check_petitboot s z!BootloaderPlugin._check_petitbootc C s� | j rt�d� dS | �� r&t�d� t�d| j � tj�| j�}| j � || j�sXdS d| _ | j � d�� � }d}t|�}|r�t�dd |�}t|�|k r�|}tj�||�| _dS ) Nz:Detected rpm-ostree which doesn't support initrd overlays.FzkDetected Petitboot which doesn't support initrd overlays. The initrd overlay will be ignored by bootloader.z installing initrd image as '%s'T� /proc/cmdline�/z)^\s*BOOT_IMAGE=\s*(?:\([^)]*\))?(\S*/).*$r� )r# r7 r; r� ri r r r r� r rR r rg �rstripr: rX rZ r� r )r ZimgZimg_nameZ curr_cmdlineZinitrd_grubpathZlcr r r r �_install_initrd s& z BootloaderPlugin._install_initrdr) c C s$ |rd S |r |d ur t |�g| _d S r' )rS r �r �enablingr� �verify�ignore_missingr% r r r �_grub2_cfg_file s z BootloaderPlugin._grub2_cfg_filer* c C sZ |rd S |rV|d urVt |�| _| jdkr,dS | jd dkr>dS tj�tj| j�| _dS d S )Nr Fr r� T)rS r r r r� r r� r� r r r �_initrd_dst_img! s z BootloaderPlugin._initrd_dst_imgr- c C s. |rd S |r*|d ur*| j �|�dk| _dS d S )N�1T)r �get_boolr r� r r r r 0 s z#BootloaderPlugin._initrd_remove_dirr+ Fr? )Z per_device�priorityc C sH |rd S |rD|d urDt |�}| �|� |dkr2dS | �|�s@dS dS d S )Nr FT)rS r� r� )r r� r� r� r� r% Zsrc_imgr r r �_initrd_add_img: s z BootloaderPlugin._initrd_add_imgr, c C s |rd S |�r|d u�rt |�}| �|� |dkr6dS tj�|�sTt�d| � dS t�d| � tj ddd�\}}t� d| � t� |� | j j d | |d d �\} } t� d | � | d kr�t�d� | j j|d d� dS | �|� | j �|� | j�rt�d| � | j �|� d S d S )Nr FzFerror: cannot create initrd image, source directory '%s' doesn't existz+generating initrd image from directory '%s'ztuned-bootloader-z.tmp)�prefix�suffixz+writing initrd image to temporary file '%s'zfind . | cpio -co > %sT)�cwd�shellz cpio log: %sr z error generating initrd imagerc zremoving directory '%s')rS r� r r r� r7 rD ri �tempfileZmkstempr8 �closer r6 rw r� r �rmtree) r r� r� r� r� r% Zsrc_dir�fdZtmpfiler< r= r r r �_initrd_add_dirI s6 z BootloaderPlugin._initrd_add_dirr. c C sD | j �| j�|��}|�r| jr*| �� }n | j�d�}|d u sJt|�dkrNd S t|� � �}t|� � �} | | } t| �dkr�t � t j dt| �f � dS dd� |D �} | D ]J} | � dd�d } | | vr�t �t j| | f � q�t �t j| | | f � q�| |@ }t � d d �|�f � d S |�r@|d u�r@t � d � d| _|| _dS d S ) Nr� r r. Tc S s i | ]}|� d d�d |�qS )�=r r )r9 )rG �vr r r � <dictcomp>z rJ z-BootloaderPlugin._cmdline.<locals>.<dictcomp>r� r z2expected arguments that are present in cmdline: %srQ Fz;installing additional boot command line parameters to grub2)Z _variables�expandr �unquoter# rE rg r: r� r9 r7 ri r ZSTR_VERIFY_PROFILE_VALUE_OKrS rD Z'STR_VERIFY_PROFILE_CMDLINE_FAIL_MISSINGZ STR_VERIFY_PROFILE_CMDLINE_FAILr� r r )r r� r� r� r� r% r� r. Z cmdline_setZ value_setZ missing_setZ cmdline_dict�m�argZ present_setr r r �_cmdlinei s8 zBootloaderPlugin._cmdliner/ c C s< |rd S |r8|d ur8| j �|�dkr8t�d� d| _dS d S )Nr� z(skipping any modification of grub configT)r r� r7 ri r r� r r r �_skip_grub_config� s z"BootloaderPlugin._skip_grub_configc C s� |rV| j rVt| j�dkr"t�d� t| j�dkr:t�d� | �tj| jtj | ji� n0|r�| j r�| j rp| � � n| � � | �� d| _ d S )Nr z0requested changes to initrd will not be applied!z1requested changes to cmdline will not be applied!F)r r: r r7 r; r rp r rs rt r r# r� r� r� )r r% r� r r r �_instance_post_static� s z&BootloaderPlugin._instance_post_static)/rV � __module__� __qualname__�__doc__r r& r( � classmethodr1 r" rB rE rM r` r r rp rx ry r{ r Z ROLLBACK_SOFTr~ r� r� r� r� r� r� r� r� r} r� r� r� r� r� Zcommand_customr� r� r r� r� r� r� r� � __classcell__r r r r r s` ! " ! r )r r Z decoratorsZ tuned.logsZtunedr Ztuned.utils.commandsr Z tuned.constsr r rX r� �timer Zlogs�getr7 ZPluginr r r r r �<module> s