[mirror_edk2.git] / ShellPkg / Library / UefiShellLevel3CommandsLib / Touch.c

/** @file\r
  Main file for Touch shell level 3 function.\r
\r
  Copyright (c) 2009 - 2011, Intel Corporation. All rights reserved. <BR>\r
  This program and the accompanying materials\r
  are licensed and made available under the terms and conditions of the BSD License\r
  which accompanies this distribution.  The full text of the license may be found at\r
  http://opensource.org/licenses/bsd-license.php\r
\r
  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
\r
**/\r
\r
#include "UefiShellLevel3CommandsLib.h"\r
\r
#include <Library/ShellLib.h>\r
\r
/**\r
  Do the touch operation on a single handle.\r
\r
  @param[in] Handle   The handle to update the date/time on.\r
\r
  @retval EFI_ACCESS_DENIED The file referenced by Handle is read only.\r
  @retval EFI_SUCCESS       The operation was successful.\r
**/\r
EFI_STATUS\r
EFIAPI\r
TouchFileByHandle (\r
  IN EFI_HANDLE Handle\r
  )\r
{\r
  EFI_STATUS    Status;\r
  EFI_FILE_INFO *FileInfo;\r
\r
  FileInfo = gEfiShellProtocol->GetFileInfo(Handle);\r
  if ((FileInfo->Attribute & EFI_FILE_READ_ONLY) != 0){\r
    return (EFI_ACCESS_DENIED);\r
  }\r
  Status = gRT->GetTime(&FileInfo->ModificationTime, NULL);\r
  ASSERT_EFI_ERROR(Status);\r
  CopyMem(&FileInfo->LastAccessTime, &FileInfo->ModificationTime, sizeof(EFI_TIME));\r
\r
  Status = gEfiShellProtocol->SetFileInfo(Handle, FileInfo);\r
\r
  FreePool(FileInfo);\r
\r
  return (Status);\r
}\r
\r
/**\r
  Touch a given file and potantially recurse down if it was a directory.\r
\r
  @param[in] Name   The name of this file.\r
  @param[in] FS     The name of the file system this file is on.\r
  @param[in] Handle The handle of this file already opened.\r
  @param[in] Rec    TRUE to recurse if possible.\r
\r
  @retval EFI_INVALID_PARAMETER A parameter was invalid.\r
  @retval EFI_SUCCESS           The operation was successful.\r
**/\r
EFI_STATUS\r
EFIAPI\r
DoTouchByHandle (\r
  IN CONST CHAR16       *Name,\r
  IN       CHAR16       *FS,\r
  IN SHELL_FILE_HANDLE  Handle,\r
  IN BOOLEAN            Rec\r
  )\r
{\r
  EFI_STATUS          Status;\r
  EFI_SHELL_FILE_INFO *FileList;\r
  EFI_SHELL_FILE_INFO *Walker;\r
  CHAR16              *TempSpot;\r
\r
  Status      = EFI_SUCCESS;\r
  FileList    = NULL;\r
  Walker      = NULL;\r
\r
  if (FS == NULL) {\r
    FS = StrnCatGrow(&FS, NULL, Name, 0);\r
    TempSpot = StrStr(FS, L"\\");\r
    if (TempSpot != NULL) {\r
      *TempSpot = CHAR_NULL;\r
    }\r
  }\r
\r
  //\r
  // do it\r
  //\r
  Status = TouchFileByHandle(Handle);\r
  if (EFI_ERROR(Status)) {\r
    ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_GEN_FILE_NO_OPEN), gShellLevel3HiiHandle, Name, Status);\r
    return (Status);\r
  }\r
\r
  //\r
  // if it's a directory recurse...\r
  //\r
  if (FileHandleIsDirectory(Handle) == EFI_SUCCESS && Rec) {\r
    //\r
    // get each file under this directory\r
    //\r
    if (EFI_ERROR(gEfiShellProtocol->FindFilesInDir(Handle, &FileList))) {\r
      Status = EFI_INVALID_PARAMETER;\r
    }\r
\r
    //\r
    // recurse on each\r
    //\r
    for (Walker = (EFI_SHELL_FILE_INFO *)GetFirstNode(&FileList->Link)\r
      ;  FileList != NULL && !IsNull(&FileList->Link, &Walker->Link) && !EFI_ERROR(Status)\r
      ;  Walker = (EFI_SHELL_FILE_INFO *)GetNextNode(&FileList->Link, &Walker->Link)\r
     ){\r
      if ( (StrCmp(Walker->FileName, L".") != 0)\r
        && (StrCmp(Walker->FileName, L"..") != 0)\r
       ){\r
        //\r
        // Open the file since we need that handle.\r
        //\r
        Status = gEfiShellProtocol->OpenFileByName (Walker->FullName, &Walker->Handle, EFI_FILE_MODE_READ|EFI_FILE_MODE_WRITE);\r
        if (EFI_ERROR(Status)) {\r
          ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_GEN_FILE_NO_OPEN), gShellLevel3HiiHandle, Walker->FullName, Status);\r
          Status = EFI_ACCESS_DENIED;\r
        } else {\r
          Status = DoTouchByHandle(Walker->FullName, FS, Walker->Handle, TRUE);\r
          gEfiShellProtocol->CloseFile(Walker->Handle);\r
          Walker->Handle = NULL;\r
        }\r
      }\r
    }\r
\r
    //\r
    // free stuff\r
    //\r
    if (FileList != NULL && EFI_ERROR(gEfiShellProtocol->FreeFileList(&FileList))) {\r
      Status = EFI_INVALID_PARAMETER;\r
    }\r
  }\r
\r
  return (Status);\r
}\r
\r
STATIC CONST SHELL_PARAM_ITEM ParamList[] = {\r
  {L"-r", TypeFlag},\r
  {NULL, TypeMax}\r
  };\r
\r
/**\r
  Function for 'touch' command.\r
\r
  @param[in] ImageHandle  Handle to the Image (NULL if Internal).\r
  @param[in] SystemTable  Pointer to the System Table (NULL if Internal).\r
**/\r
SHELL_STATUS\r
EFIAPI\r
ShellCommandRunTouch (\r
  IN EFI_HANDLE        ImageHandle,\r
  IN EFI_SYSTEM_TABLE  *SystemTable\r
  )\r
{\r
  EFI_STATUS          Status;\r
  LIST_ENTRY          *Package;\r
  CHAR16              *ProblemParam;\r
  CONST CHAR16        *Param;\r
  SHELL_STATUS        ShellStatus;\r
  UINTN               ParamCount;\r
  EFI_SHELL_FILE_INFO *FileList;\r
  EFI_SHELL_FILE_INFO *Node;\r
\r
  ProblemParam        = NULL;\r
  ShellStatus         = SHELL_SUCCESS;\r
  ParamCount          = 0;\r
  FileList            = NULL;\r
\r
  //\r
  // initialize the shell lib (we must be in non-auto-init...)\r
  //\r
  Status = ShellInitialize();\r
  ASSERT_EFI_ERROR(Status);\r
\r
  Status = CommandInit();\r
  ASSERT_EFI_ERROR(Status);\r
\r
  //\r
  // parse the command line\r
  //\r
  Status = ShellCommandLineParse (ParamList, &Package, &ProblemParam, TRUE);\r
  if (EFI_ERROR(Status)) {\r
    if (Status == EFI_VOLUME_CORRUPTED && ProblemParam != NULL) {\r
      ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_GEN_PROBLEM), gShellLevel3HiiHandle, ProblemParam);\r
      FreePool(ProblemParam);\r
      ShellStatus = SHELL_INVALID_PARAMETER;\r
    } else {\r
      ASSERT(FALSE);\r
    }\r
  } else {\r
    //\r
    // check for "-?"\r
    //\r
    if (ShellCommandLineGetFlag(Package, L"-?")) {\r
      ASSERT(FALSE);\r
    }\r
    if (ShellCommandLineGetRawValue(Package, 1) == NULL) {\r
      //\r
      // we insufficient parameters\r
      //\r
      ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_GEN_TOO_FEW), gShellLevel3HiiHandle);\r
      ShellStatus = SHELL_INVALID_PARAMETER;\r
    } else {\r
      //\r
      // get a list with each file specified by parameters\r
      // if parameter is a directory then add all the files below it to the list\r
      //\r
      for ( ParamCount = 1, Param = ShellCommandLineGetRawValue(Package, ParamCount)\r
          ; Param != NULL\r
          ; ParamCount++, Param = ShellCommandLineGetRawValue(Package, ParamCount)\r
         ){\r
        Status = ShellOpenFileMetaArg((CHAR16*)Param, EFI_FILE_MODE_READ|EFI_FILE_MODE_WRITE, &FileList);\r
        if (EFI_ERROR(Status)) {\r
          ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_GEN_PROBLEM), gShellLevel3HiiHandle, (CHAR16*)Param);\r
          ShellStatus = SHELL_NOT_FOUND;\r
          break;\r
        }\r
        //\r
        // make sure we completed the param parsing sucessfully...\r
        // Also make sure that any previous action was sucessful\r
        //\r
        if (ShellStatus == SHELL_SUCCESS) {\r
          //\r
          // check that we have at least 1 file\r
          //\r
          if (FileList == NULL || IsListEmpty(&FileList->Link)) {\r
            ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_GEN_FILE_NF), gShellLevel3HiiHandle, Param);\r
            continue;\r
          } else {\r
            //\r
            // loop through the list and make sure we are not aborting...\r
            //\r
            for ( Node = (EFI_SHELL_FILE_INFO*)GetFirstNode(&FileList->Link)\r
                ; !IsNull(&FileList->Link, &Node->Link) && !ShellGetExecutionBreakFlag()\r
                ; Node = (EFI_SHELL_FILE_INFO*)GetNextNode(&FileList->Link, &Node->Link)\r
               ){\r
              //\r
              // make sure the file opened ok\r
              //\r
              if (EFI_ERROR(Node->Status)){\r
                ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_GEN_FILE_NO_OPEN), gShellLevel3HiiHandle, Node->FileName, Node->Status);\r
                ShellStatus = SHELL_NOT_FOUND;\r
                continue;\r
              }\r
\r
              Status = DoTouchByHandle(Node->FullName, NULL, Node->Handle, ShellCommandLineGetFlag(Package, L"-r"));\r
              if (EFI_ERROR(Status) && Status != EFI_ACCESS_DENIED) {\r
                ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_GEN_FILE_NO_OPEN), gShellLevel3HiiHandle, Node->FileName, Status);\r
                ShellStatus = SHELL_NOT_FOUND;\r
              }\r
            }\r
          }\r
        }\r
        //\r
        // Free the fileList\r
        //\r
        if (FileList != NULL && !IsListEmpty(&FileList->Link)) {\r
          Status = ShellCloseFileMetaArg(&FileList);\r
          ASSERT_EFI_ERROR(Status);\r
        }\r
        FileList = NULL;\r
      }\r
    }\r
\r
    //\r
    // free the command line package\r
    //\r
    ShellCommandLineFreeVarList (Package);\r
  }\r
\r
  if (ShellGetExecutionBreakFlag()) {\r
    return (SHELL_ABORTED);\r
  }\r
\r
  return (ShellStatus);\r
}\r
\r
Commit	Line	Data
a405b86d	1	/** @file\r
	2	Main file for Touch shell level 3 function.\r
	3	\r
345cd235	4	Copyright (c) 2009 - 2011, Intel Corporation. All rights reserved. <BR>\r
a405b86d	5	This program and the accompanying materials\r
	6	are licensed and made available under the terms and conditions of the BSD License\r
	7	which accompanies this distribution. The full text of the license may be found at\r
	8	http://opensource.org/licenses/bsd-license.php\r
	9	\r
	10	THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
	11	WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
	12	\r
	13	**/\r
	14	\r
	15	#include "UefiShellLevel3CommandsLib.h"\r
	16	\r
	17	#include <Library/ShellLib.h>\r
	18	\r
345cd235	19	/**\r
	20	Do the touch operation on a single handle.\r
	21	\r
	22	@param[in] Handle The handle to update the date/time on.\r
	23	\r
	24	@retval EFI_ACCESS_DENIED The file referenced by Handle is read only.\r
	25	@retval EFI_SUCCESS The operation was successful.\r
	26	**/\r
a405b86d	27	EFI_STATUS\r
	28	EFIAPI\r
	29	TouchFileByHandle (\r
	30	IN EFI_HANDLE Handle\r
	31	)\r
	32	{\r
	33	EFI_STATUS Status;\r
	34	EFI_FILE_INFO *FileInfo;\r
	35	\r
	36	FileInfo = gEfiShellProtocol->GetFileInfo(Handle);\r
	37	if ((FileInfo->Attribute & EFI_FILE_READ_ONLY) != 0){\r
	38	return (EFI_ACCESS_DENIED);\r
	39	}\r
	40	Status = gRT->GetTime(&FileInfo->ModificationTime, NULL);\r
	41	ASSERT_EFI_ERROR(Status);\r
	42	CopyMem(&FileInfo->LastAccessTime, &FileInfo->ModificationTime, sizeof(EFI_TIME));\r
	43	\r
	44	Status = gEfiShellProtocol->SetFileInfo(Handle, FileInfo);\r
	45	\r
	46	FreePool(FileInfo);\r
	47	\r
	48	return (Status);\r
	49	}\r
	50	\r
345cd235	51	/**\r
	52	Touch a given file and potantially recurse down if it was a directory.\r
	53	\r
	54	@param[in] Name The name of this file.\r
	55	@param[in] FS The name of the file system this file is on.\r
	56	@param[in] Handle The handle of this file already opened.\r
	57	@param[in] Rec TRUE to recurse if possible.\r
	58	\r
	59	@retval EFI_INVALID_PARAMETER A parameter was invalid.\r
	60	@retval EFI_SUCCESS The operation was successful.\r
	61	**/\r
a405b86d	62	EFI_STATUS\r
	63	EFIAPI\r
	64	DoTouchByHandle (\r
	65	IN CONST CHAR16 *Name,\r
	66	IN CHAR16 *FS,\r
	67	IN SHELL_FILE_HANDLE Handle,\r
	68	IN BOOLEAN Rec\r
	69	)\r
	70	{\r
	71	EFI_STATUS Status;\r
	72	EFI_SHELL_FILE_INFO *FileList;\r
	73	EFI_SHELL_FILE_INFO *Walker;\r
	74	CHAR16 *TempSpot;\r
	75	\r
	76	Status = EFI_SUCCESS;\r
	77	FileList = NULL;\r
	78	Walker = NULL;\r
	79	\r
	80	if (FS == NULL) {\r
	81	FS = StrnCatGrow(&FS, NULL, Name, 0);\r
	82	TempSpot = StrStr(FS, L"\\");\r
	83	if (TempSpot != NULL) {\r
	84	*TempSpot = CHAR_NULL;\r
	85	}\r
	86	}\r
	87	\r
	88	//\r
	89	// do it\r
	90	//\r
	91	Status = TouchFileByHandle(Handle);\r
	92	if (EFI_ERROR(Status)) {\r
	93	ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_GEN_FILE_NO_OPEN), gShellLevel3HiiHandle, Name, Status);\r
	94	return (Status);\r
	95	}\r
	96	\r
	97	//\r
	98	// if it's a directory recurse...\r
	99	//\r
	100	if (FileHandleIsDirectory(Handle) == EFI_SUCCESS && Rec) {\r
	101	//\r
	102	// get each file under this directory\r
	103	//\r
	104	if (EFI_ERROR(gEfiShellProtocol->FindFilesInDir(Handle, &FileList))) {\r
	105	Status = EFI_INVALID_PARAMETER;\r
	106	}\r
	107	\r
	108	//\r
	109	// recurse on each\r
	110	//\r
	111	for (Walker = (EFI_SHELL_FILE_INFO *)GetFirstNode(&FileList->Link)\r
	112	; FileList != NULL && !IsNull(&FileList->Link, &Walker->Link) && !EFI_ERROR(Status)\r
	113	; Walker = (EFI_SHELL_FILE_INFO *)GetNextNode(&FileList->Link, &Walker->Link)\r
	114	){\r
	115	if ( (StrCmp(Walker->FileName, L".") != 0)\r
	116	&& (StrCmp(Walker->FileName, L"..") != 0)\r
	117	){\r
	118	//\r
	119	// Open the file since we need that handle.\r
	120	//\r
	121	Status = gEfiShellProtocol->OpenFileByName (Walker->FullName, &Walker->Handle, EFI_FILE_MODE_READ\|EFI_FILE_MODE_WRITE);\r
	122	if (EFI_ERROR(Status)) {\r
	123	ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_GEN_FILE_NO_OPEN), gShellLevel3HiiHandle, Walker->FullName, Status);\r
	124	Status = EFI_ACCESS_DENIED;\r
	125	} else {\r
126	Status = DoTouchByHandle(Walker->FullName, FS, Walker->Handle, TRUE);\r
127	gEfiShellProtocol->CloseFile(Walker->Handle);\r
128	Walker->Handle = NULL;\r
129	}\r
130	}\r
131	}\r
132	\r
133	//\r
134	// free stuff\r
135	//\r
136	if (FileList != NULL && EFI_ERROR(gEfiShellProtocol->FreeFileList(&FileList))) {\r
137	Status = EFI_INVALID_PARAMETER;\r
138	}\r
139	}\r
140	\r
141	return (Status);\r
142	}\r
143	\r
144	STATIC CONST SHELL_PARAM_ITEM ParamList[] = {\r
145	{L"-r", TypeFlag},\r
146	{NULL, TypeMax}\r
147	};\r
148	\r
149	/**\r
150	Function for 'touch' command.\r
151	\r
152	@param[in] ImageHandle Handle to the Image (NULL if Internal).\r
153	@param[in] SystemTable Pointer to the System Table (NULL if Internal).\r
154	**/\r
155	SHELL_STATUS\r
156	EFIAPI\r
157	ShellCommandRunTouch (\r
158	IN EFI_HANDLE ImageHandle,\r
159	IN EFI_SYSTEM_TABLE *SystemTable\r
160	)\r
161	{\r
162	EFI_STATUS Status;\r
163	LIST_ENTRY *Package;\r
164	CHAR16 *ProblemParam;\r
165	CONST CHAR16 *Param;\r
166	SHELL_STATUS ShellStatus;\r
167	UINTN ParamCount;\r
168	EFI_SHELL_FILE_INFO *FileList;\r
169	EFI_SHELL_FILE_INFO *Node;\r
170	\r
171	ProblemParam = NULL;\r
172	ShellStatus = SHELL_SUCCESS;\r
173	ParamCount = 0;\r
174	FileList = NULL;\r
175	\r
176	//\r
177	// initialize the shell lib (we must be in non-auto-init...)\r
178	//\r
179	Status = ShellInitialize();\r
180	ASSERT_EFI_ERROR(Status);\r
181	\r
182	Status = CommandInit();\r
183	ASSERT_EFI_ERROR(Status);\r
184	\r
185	//\r
186	// parse the command line\r
187	//\r
188	Status = ShellCommandLineParse (ParamList, &Package, &ProblemParam, TRUE);\r
189	if (EFI_ERROR(Status)) {\r
190	if (Status == EFI_VOLUME_CORRUPTED && ProblemParam != NULL) {\r
191	ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_GEN_PROBLEM), gShellLevel3HiiHandle, ProblemParam);\r
192	FreePool(ProblemParam);\r
193	ShellStatus = SHELL_INVALID_PARAMETER;\r
194	} else {\r
195	ASSERT(FALSE);\r
196	}\r
197	} else {\r
198	//\r
199	// check for "-?"\r
200	//\r
201	if (ShellCommandLineGetFlag(Package, L"-?")) {\r
202	ASSERT(FALSE);\r
203	}\r
204	if (ShellCommandLineGetRawValue(Package, 1) == NULL) {\r
205	//\r
206	// we insufficient parameters\r
207	//\r
208	ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_GEN_TOO_FEW), gShellLevel3HiiHandle);\r
209	ShellStatus = SHELL_INVALID_PARAMETER;\r
210	} else {\r
211	//\r
212	// get a list with each file specified by parameters\r
213	// if parameter is a directory then add all the files below it to the list\r
214	//\r
215	for ( ParamCount = 1, Param = ShellCommandLineGetRawValue(Package, ParamCount)\r
216	; Param != NULL\r
217	; ParamCount++, Param = ShellCommandLineGetRawValue(Package, ParamCount)\r
218	){\r
219	Status = ShellOpenFileMetaArg((CHAR16*)Param, EFI_FILE_MODE_READ\|EFI_FILE_MODE_WRITE, &FileList);\r
220	if (EFI_ERROR(Status)) {\r
221	ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_GEN_PROBLEM), gShellLevel3HiiHandle, (CHAR16*)Param);\r
222	ShellStatus = SHELL_NOT_FOUND;\r
223	break;\r
224	}\r
225	//\r
226	// make sure we completed the param parsing sucessfully...\r
227	// Also make sure that any previous action was sucessful\r
228	//\r
229	if (ShellStatus == SHELL_SUCCESS) {\r
230	//\r
231	// check that we have at least 1 file\r
232	//\r
233	if (FileList == NULL \|\| IsListEmpty(&FileList->Link)) {\r
234	ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_GEN_FILE_NF), gShellLevel3HiiHandle, Param);\r
235	continue;\r
236	} else {\r
237	//\r
238	// loop through the list and make sure we are not aborting...\r
239	//\r
240	for ( Node = (EFI_SHELL_FILE_INFO*)GetFirstNode(&FileList->Link)\r
241	; !IsNull(&FileList->Link, &Node->Link) && !ShellGetExecutionBreakFlag()\r
242	; Node = (EFI_SHELL_FILE_INFO*)GetNextNode(&FileList->Link, &Node->Link)\r
243	){\r
244	//\r
245	// make sure the file opened ok\r
246	//\r
247	if (EFI_ERROR(Node->Status)){\r
248	ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_GEN_FILE_NO_OPEN), gShellLevel3HiiHandle, Node->FileName, Node->Status);\r
249	ShellStatus = SHELL_NOT_FOUND;\r
250	continue;\r
251	}\r
252	\r
253	Status = DoTouchByHandle(Node->FullName, NULL, Node->Handle, ShellCommandLineGetFlag(Package, L"-r"));\r
254	if (EFI_ERROR(Status) && Status != EFI_ACCESS_DENIED) {\r
255	ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_GEN_FILE_NO_OPEN), gShellLevel3HiiHandle, Node->FileName, Status);\r
256	ShellStatus = SHELL_NOT_FOUND;\r
257	}\r
258	}\r
259	}\r
260	}\r
261	//\r
262	// Free the fileList\r
263	//\r
264	if (FileList != NULL && !IsListEmpty(&FileList->Link)) {\r
265	Status = ShellCloseFileMetaArg(&FileList);\r
266	ASSERT_EFI_ERROR(Status);\r
267	}\r
268	FileList = NULL;\r
269	}\r
270	}\r
271	\r
272	//\r
273	// free the command line package\r
274	//\r
275	ShellCommandLineFreeVarList (Package);\r
276	}\r
277	\r
278	if (ShellGetExecutionBreakFlag()) {\r
279	return (SHELL_ABORTED);\r
280	}\r
281	\r
282	return (ShellStatus);\r
283	}\r
284	\r