grthtrhthjhtyjytjytkergtrhtrjytjerhrfh4:24 29/09/2026a dtd%@sVdZddlZddlZddlmZmZmZmZGdddeZ ddZ e d krRe dS) a Implements the base CFSNode class and a few inherited variants. This file is part of RTSLib. Copyright (c) 2011-2013 by Datera, Inc Copyright (c) 2011-2014 by Red Hat, Inc. Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. N)freadfwrite RTSLibErrorRTSLibNotInCFSc@seZdZdZddZddZddZdd Zd d Zd d Z ddZ d&ddZ d'ddZ d(ddZ ddZddZddZddZdd Zeed!d"Zee d#d"Zd$d%ZdS))CFSNodez/sys/kernel/config/targetcCs |j|_dSN) configfs_dir_pathselfr //usr/lib/python3.9/site-packages/rtslib/node.py__init__!szCFSNode.__init__cCs |j|jkSrr r otherr r r__eq__$szCFSNode.__eq__cCs |j|jkSrrrr r r__ne__'szCFSNode.__ne__cCs|jSrrr r r r _get_path*szCFSNode._get_pathcCs|dvrtd||jrt|dkrttjtj|j|jdrbtt|jdsbt |jqtd|j j n$|js|dkrt d|j j |jf|jszt |jWntd |j j Yn0d S) a' Creates the configFS node if it does not already exist, depending on the mode. any -> makes sure it exists, also works if the node already does exist lookup -> make sure it does NOT exist create -> create the node which must not exist beforehand )anylookupcreatezInvalid mode: %srz/corerz"This %s already exists in configFSrzNo such %s in configfs: %szCould not create %s in configFSN)rexistsospathsamefiledirnamer nextwalkrmdir __class____name__rmkdir)r moder r r_create_in_cfs_ine-s*  zCFSNode._create_in_cfs_inecCstj|jSr)rrisdirr r r r_existsLszCFSNode._existscCs|jstd|jjdS)Nz"This %s does not exist in configFS)rrr!r"r r r r _check_selfOszCFSNode._check_selfNcCstj|sgS|dur,|dur,t|}nxg}t|D]h}td||f}|durt||tjtj@tjkkrtq:|dur||tjtj@tjkkrq:||q:| |S)a List files under a path depending on their owner's write permissions. @param path: The path under which the files are expected to be. If the path itself is not a directory, an empty list will be returned. @type path: str @param writable: If None (default), return all files despite their writability. If True, return only writable files. If False, return only non-writable files. @type writable: bool or None @param readable: If None (default), return all files despite their readability. If True, return only readable files. If False, return only non-readable files. @type readable: bool or None @return: List of file names filtered according to their read/write perms. Nz%s/%s) rrr&listdirstatST_MODES_IWUSRS_IRUSRappendsort)r rwritablereadablenamesnameZsresr r r _list_filesTs(   zCFSNode._list_filescCs |d|j}||||S)a @param writable: If None (default), return all parameters despite their writability. If True, return only writable parameters. If False, return only non-writable parameters. @type writable: bool or None @param readable: If None (default), return all parameters despite their readability. If True, return only readable parameters. If False, return only non-readable parameters. @type readable: bool or None @return: The list of existing RFC-3720 parameter names. z%s/paramr(rr4r r0r1rr r rlist_parameters}s  zCFSNode.list_parameterscCs |d|j}||||S)a @param writable: If None (default), return all files despite their writability. If True, return only writable files. If False, return only non-writable files. @type writable: bool or None @param readable: If None (default), return all files despite their readability. If True, return only readable files. If False, return only non-readable files. @type readable: bool or None @return: A list of existing attribute names as strings. z %s/attribr5r6r r rlist_attributess  zCFSNode.list_attributesc Cs|d|jt|f}tj|s8tdt|nLzt|dt|Wn4ty}ztd||fWYd}~n d}~00dS)a Sets the value of a named attribute. The attribute must exist in configFS. @param attribute: The attribute's name. It is case-sensitive. @type attribute: string @param value: The attribute's value. @type value: string %s/attrib/%sCannot find attribute: %sz%szCannot set attribute %s: %sNr(rstrrisfilerr Exception)r attributevaluerer r r set_attributes  zCFSNode.set_attributecCs@|d|jt|f}tj|s4td|nt|SdS)z @param attribute: The attribute's name. It is case-sensitive. @return: The named attribute's value, as a string. r9r:Nr(rr<rr=rr)r r?rr r r get_attributes  zCFSNode.get_attributec Cs|d|jt|f}tj|s4td|nLzt|dt|Wn4ty~}ztd||fWYd}~n d}~00dS)a% Sets the value of a named RFC-3720 parameter. The parameter must exist in configFS. @param parameter: The RFC-3720 parameter's name. It is case-sensitive. @type parameter: string @param value: The parameter's value. @type value: string %s/param/%szCannot find parameter: %sz%s zCannot set parameter %s: %sNr;)r parameterr@rrAr r r set_parameters  zCFSNode.set_parametercCs@|d|jt|f}tj|s4td|nt|SdS)z @param parameter: The RFC-3720 parameter's name. It is case-sensitive. @type parameter: string @return: The named parameter value as a string. rEz"Cannot find RFC-3720 parameter: %sNrC)r rFrr r r get_parameters  zCFSNode.get_parametercCs|jrt|jdS)z If the underlying configFS object does not exist, this method does nothing. If the underlying configFS object exists, this method attempts to delete it. N)rrr rr r r rdeleteszCFSNode.deletezGet the configFS object path.)doczIs True as long as the underlying configFS object exists. If the underlying configFS objects gets deleted either by calling the delete() method, or by any other means, it will be False.c Csi}i}i}|jdddD]<}zt||||<WqtyT||||<Yq0q|rd||d<|jdddD]}||||<qr|r||d<|S)NT)r0r1Z attributes parameters)r8intrD ValueErrorr7rH)r dattrsparamsitemr r rdumps z CFSNode.dump)NN)NN)NN)r" __module__ __qualname__r rrrrr%r'r(r4r7r8rBrDrGrHrIpropertyrrrRr r r rrs. )     rcCsddl}|dS)Nr)doctestZtestmod)rVr r r_testsrW__main__) __doc__rr*ZutilsrrrrobjectrrWr"r r r rsf