]> git.proxmox.com Git - mirror_edk2.git/blame - NetworkPkg/SnpDxe/Shutdown.c
NetworkPkg: Apply uncrustify changes
[mirror_edk2.git] / NetworkPkg / SnpDxe / Shutdown.c
CommitLineData
a0818cc1 1/** @file\r
bb3594e8 2 Implementation of shutting down a network adapter.\r
d1102dba
LG
3\r
4Copyright (c) 2004 - 2018, Intel Corporation. All rights reserved.<BR>\r
9d510e61 5SPDX-License-Identifier: BSD-2-Clause-Patent\r
a0818cc1 6\r
a0818cc1 7**/\r
8\r
9#include "Snp.h"\r
10\r
a0818cc1 11/**\r
f3816027 12 Call UNDI to shut down the interface.\r
a0818cc1 13\r
f3816027 14 @param Snp Pointer to snp driver structure.\r
a0818cc1 15\r
f3816027 16 @retval EFI_SUCCESS UNDI is shut down successfully.\r
17 @retval EFI_DEVICE_ERROR UNDI could not be shut down.\r
a0818cc1 18\r
19**/\r
20EFI_STATUS\r
4cda7726 21PxeShutdown (\r
d1050b9d 22 IN SNP_DRIVER *Snp\r
a0818cc1 23 )\r
24{\r
d1050b9d
MK
25 Snp->Cdb.OpCode = PXE_OPCODE_SHUTDOWN;\r
26 Snp->Cdb.OpFlags = PXE_OPFLAGS_NOT_USED;\r
27 Snp->Cdb.CPBsize = PXE_CPBSIZE_NOT_USED;\r
28 Snp->Cdb.DBsize = PXE_DBSIZE_NOT_USED;\r
29 Snp->Cdb.CPBaddr = PXE_CPBADDR_NOT_USED;\r
30 Snp->Cdb.DBaddr = PXE_DBADDR_NOT_USED;\r
31 Snp->Cdb.StatCode = PXE_STATCODE_INITIALIZE;\r
32 Snp->Cdb.StatFlags = PXE_STATFLAGS_INITIALIZE;\r
33 Snp->Cdb.IFnum = Snp->IfNum;\r
34 Snp->Cdb.Control = PXE_CONTROL_LAST_CDB_IN_LIST;\r
a0818cc1 35\r
36 //\r
37 // Issue UNDI command and check result.\r
38 //\r
c49ca4a2 39 DEBUG ((DEBUG_NET, "\nsnp->undi.shutdown() "));\r
a0818cc1 40\r
d1050b9d 41 (*Snp->IssueUndi32Command)((UINT64)(UINTN)&Snp->Cdb);\r
a0818cc1 42\r
4cda7726 43 if (Snp->Cdb.StatCode != PXE_STATCODE_SUCCESS) {\r
a0818cc1 44 //\r
45 // UNDI could not be shutdown. Return UNDI error.\r
46 //\r
c49ca4a2 47 DEBUG ((DEBUG_WARN, "\nsnp->undi.shutdown() %xh:%xh\n", Snp->Cdb.StatFlags, Snp->Cdb.StatCode));\r
a0818cc1 48\r
49 return EFI_DEVICE_ERROR;\r
50 }\r
d1050b9d 51\r
a0818cc1 52 //\r
53 // Free allocated memory.\r
54 //\r
4cda7726 55 if (Snp->TxRxBuffer != NULL) {\r
56 Snp->PciIo->FreeBuffer (\r
57 Snp->PciIo,\r
58 SNP_MEM_PAGES (Snp->TxRxBufferSize),\r
d1050b9d 59 (VOID *)Snp->TxRxBuffer\r
a0818cc1 60 );\r
61 }\r
62\r
d1050b9d
MK
63 Snp->TxRxBuffer = NULL;\r
64 Snp->TxRxBufferSize = 0;\r
a0818cc1 65\r
66 return EFI_SUCCESS;\r
67}\r
68\r
a0818cc1 69/**\r
d1102dba
LG
70 Resets a network adapter and leaves it in a state that is safe for another\r
71 driver to initialize.\r
72\r
4cda7726 73 This function releases the memory buffers assigned in the Initialize() call.\r
74 Pending transmits and receives are lost, and interrupts are cleared and disabled.\r
d1102dba 75 After this call, only the Initialize() and Stop() calls may be used. If the\r
4cda7726 76 network interface was successfully shutdown, then EFI_SUCCESS will be returned.\r
77 If the driver has not been initialized, EFI_DEVICE_ERROR will be returned.\r
78\r
79 @param This A pointer to the EFI_SIMPLE_NETWORK_PROTOCOL instance.\r
80\r
81 @retval EFI_SUCCESS The network interface was shutdown.\r
82 @retval EFI_NOT_STARTED The network interface has not been started.\r
d1102dba 83 @retval EFI_INVALID_PARAMETER This parameter was NULL or did not point to a valid\r
4cda7726 84 EFI_SIMPLE_NETWORK_PROTOCOL structure.\r
85 @retval EFI_DEVICE_ERROR The command could not be sent to the network interface.\r
a0818cc1 86\r
87**/\r
88EFI_STATUS\r
89EFIAPI\r
4cda7726 90SnpUndi32Shutdown (\r
d1050b9d 91 IN EFI_SIMPLE_NETWORK_PROTOCOL *This\r
a0818cc1 92 )\r
93{\r
4cda7726 94 SNP_DRIVER *Snp;\r
a0818cc1 95 EFI_STATUS Status;\r
96 EFI_TPL OldTpl;\r
97\r
98 //\r
4cda7726 99 // Get pointer to SNP driver instance for *This.\r
a0818cc1 100 //\r
4cda7726 101 if (This == NULL) {\r
a0818cc1 102 return EFI_INVALID_PARAMETER;\r
103 }\r
104\r
4cda7726 105 Snp = EFI_SIMPLE_NETWORK_DEV_FROM_THIS (This);\r
a0818cc1 106\r
107 OldTpl = gBS->RaiseTPL (TPL_CALLBACK);\r
108\r
109 //\r
4cda7726 110 // Return error if the SNP is not initialized.\r
a0818cc1 111 //\r
4cda7726 112 switch (Snp->Mode.State) {\r
d1050b9d
MK
113 case EfiSimpleNetworkInitialized:\r
114 break;\r
a0818cc1 115\r
d1050b9d
MK
116 case EfiSimpleNetworkStopped:\r
117 Status = EFI_NOT_STARTED;\r
118 goto ON_EXIT;\r
a0818cc1 119\r
d1050b9d
MK
120 default:\r
121 Status = EFI_DEVICE_ERROR;\r
122 goto ON_EXIT;\r
a0818cc1 123 }\r
d1102dba 124\r
d1050b9d 125 Status = PxeShutdown (Snp);\r
a0818cc1 126\r
d1050b9d
MK
127 Snp->Mode.State = EfiSimpleNetworkStarted;\r
128 Snp->Mode.ReceiveFilterSetting = 0;\r
a0818cc1 129\r
d1050b9d
MK
130 Snp->Mode.MCastFilterCount = 0;\r
131 Snp->Mode.ReceiveFilterSetting = 0;\r
4cda7726 132 ZeroMem (Snp->Mode.MCastFilter, sizeof Snp->Mode.MCastFilter);\r
a0818cc1 133 CopyMem (\r
4cda7726 134 &Snp->Mode.CurrentAddress,\r
135 &Snp->Mode.PermanentAddress,\r
a0818cc1 136 sizeof (EFI_MAC_ADDRESS)\r
137 );\r
138\r
4cda7726 139 gBS->CloseEvent (Snp->Snp.WaitForPacket);\r
a0818cc1 140\r
141ON_EXIT:\r
142 gBS->RestoreTPL (OldTpl);\r
143\r
144 return Status;\r
145}\r